Questo articolo spiega come costruire un'app che invia una notifica su Slack ogni volta che il tuo account riceve una nuova recensione. La configurazione si articola in tre fasi: creazione dell'app Slack, caricamento di un plugin sul proprio account Yext e creazione di un'app Yext che colleghi i due.
Requisiti
- Un'area di lavoro Slack in cui hai il permesso di creare app o l'approvazione del tuo amministratore Slack.
- Un account Yext con accesso alle funzionalità dell'account e alla console per gli sviluppatori.
Passaggio 1: crea un'app Slack
- Crea o identifica il canale Slack in cui desideri che appaiano le notifiche di recensione.
- Vai su api.slack.com/apps e fai clic su Crea nuova app.
- Seleziona Da zero, inserisci il nome dell'app e seleziona il tuo spazio di lavoro.
- In Aggiungi opzioni e funzionalità, fai clic su Webhook in entrata.
- Attiva la funzionalità.
- Fai clic su Richiedi di aggiungere un nuovo webhook e includi un messaggio al tuo amministratore di Slack che spieghi cosa farà il webhook.
- Dopo che il tuo amministratore avrà approvato la richiesta, torna a api.slack.com/apps. Seleziona la tua app e torna a Webhook in entrata.
- Fai clic su Aggiungi nuovo webhook allo spazio di lavoro, seleziona il canale per le notifiche di recensione e fai clic su Consenti.
- Copia l'URL del webhook in fondo alla pagina. Ti servirà per il passaggio 2.
Passaggio 2: carica il plugin Publisher
- Vai alle Impostazioni dell'account > Funzionalità dell'account e attiva Estate '23: attiva le funzioni serverless nelle app (accesso anticipato) Fai clic su Salva.
- Vai a questo link per iniziare ad applicare la funzione Slack al tuo account.
- Fai clic su Applica nell'angolo in alto a destra.
- Inserisci il tuo ID account e fai clic su Continua.
- Inserisci l'URL del webhook che hai copiato nel passaggio 1 e il tuo ID dell'account.
- Fai clic su Salva, poi Continua e infine Conferma.
Per verificare che il caricamento sia andato a buon fine, vai su Sviluppatore > Console amministratore e conferma di vedere i file nel percorso: platform > plugin > slackReviewsPublisher.
Passaggio 3: creazione di un'app Yext
- Vai a Sviluppatore > Console per gli sviluppatori.
- Fai clic su Aggiungi un'app, inserisci un nome come "Publisher di recensioni su Slack" e fai clic su Crea app.
- Nella scheda Credenziali API, fai clic su Aggiungi una nuova autorizzazione API. Seleziona API di gestione > Recensioni con autorizzazioni di sola lettura e fai clic su Salva.
- Nella scheda Webhook, fai clic su Aggiungi un Webhook.
- Seleziona Recensioni come tipo di webhook e fai clic su Avanti.
- Inserisci un nome per il webhook, come "Notifica di recensione su Slack."
- In URL fai clic su Invoca una funzione. Seleziona slackReviewsPublisher e scegli la funzione handleNotification.
- Fai clic su Termina e aggiungi.
Ora il tuo canale Slack riceverà ora una notifica ogni volta che il tuo account riceve una nuova recensione.