Crea un'app per le recensioni su Slack

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

1. Crea o identifica il canale Slack in cui desideri che appaiano le notifiche di recensione.
2. Vai su api.slack.com/apps e fai clic su Crea nuova app.
3. Seleziona Da zero, inserisci il nome dell'app e seleziona il tuo spazio di lavoro.
4. In Aggiungi opzioni e funzionalità, fai clic su Webhook in entrata.
5. Attiva la funzionalità.
6. Fai clic su Richiedi di aggiungere un nuovo webhook e includi un messaggio al tuo amministratore di Slack che spieghi cosa farà il webhook.
7. 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.
8. Fai clic su Aggiungi nuovo webhook allo spazio di lavoro, seleziona il canale per le notifiche di recensione e fai clic su Consenti.
9. Copia l'URL del webhook in fondo alla pagina. Ti servirà per il passaggio 2.

Passaggio 2: carica il plugin Publisher

1. Vai alle Impostazioni dell'account > Funzionalità dell'account e attiva Estate '23: attiva le funzioni serverless nelle app (accesso anticipato) Fai clic su Salva.
2. Vai a questo link per iniziare ad applicare la funzione Slack al tuo account.
3. Fai clic su Applica nell'angolo in alto a destra.
4. Inserisci il tuo ID account e fai clic su Continua.
5. Inserisci l'URL del webhook che hai copiato nel passaggio 1 e il tuo ID dell'account.
6. 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

1. Vai a Sviluppatore > Console per gli sviluppatori.
2. Fai clic su Aggiungi un'app, inserisci un nome come "Publisher di recensioni su Slack" e fai clic su Crea app.
3. 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.
4. Nella scheda Webhook, fai clic su Aggiungi un Webhook.
5. Seleziona Recensioni come tipo di webhook e fai clic su Avanti.
6. Inserisci un nome per il webhook, come "Notifica di recensione su Slack."
7. In URL fai clic su Invoca una funzione. Seleziona slackReviewsPublisher e scegli la funzione handleNotification.
8. 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.