Créer une application Slack Reviews

Cet article explique comment créer une application qui envoie une notification Slack chaque fois que votre compte reçoit un nouvel avis. La configuration comporte trois parties : créer l'application Slack, charger un plug-in sur votre compte Yext et créer une application Yext qui relie les deux.

Exigences

• Un espace de travail Slack où vous avez la permission de créer des applications, ou l'approbation de votre administrateur Slack
• Un compte Yext avec accès aux caractéristiques du compte et à la console développeur

Étape 1 : créez une application Slack

1. Créez ou identifiez le canal Slack où vous souhaitez que les notifications d'avis apparaissent.
2. Accédez à api.slack.com/apps et cliquez sur Create New App (Créer une nouvelle application).
3. Sélectionnez From Scratch (À partir de zéro), saisissez le nom de l'application et sélectionnez votre espace de travail.
4. Sous Add Features and Functionality (Ajouter des fonctionnalités), cliquez sur Incoming Webhooks (Webhooks entrants).
5. Activez la fonctionnalité.
6. Cliquez sur Request to Add New Webhook (Demander l'ajout d'un nouveau webhook) et incluez un message adressé à votre administrateur Slack expliquant à quoi servira le webhook.
7. Après que votre administrateur a approuvé la demande, retournez sur api.slack.com/apps, sélectionnez votre application et retournez dans Incoming Webhooks.
8. Cliquez sur Add New Webhook to Workspace (Ajouter un nouveau webhook à l'espace de travail), sélectionnez le canal pour les notifications d'avis, puis cliquez sur Allow (Autoriser).
9. Copiez l'URL du webhook en bas de la page, vous en aurez besoin à l'étape 2.

Étape 2 : téléchargez le plugin de l'annuaire

1. Accédez à Paramètres du compte > Caractéristiques du compte et activez Summer Release 2023 : Déclencher des fonctionnalités sans serveur dans les applications (accès anticipé). Cliquez sur Sauvegarder.
2. Suivez ce lien pour commencer à appliquer la fonction Slack à votre compte.
3. Cliquez sur Apply (Appliquer) dans le coin supérieur droit.
4. Saisissez votre ID de compte et cliquez sur Continuer.
5. Entrez l'URL du webhook que vous avez copiée à l'étape 1 et votre ID de compte.
6. Cliquez sur Sauvegarder, Continuer, puis Confirmer.

Pour vérifier que le chargement a abouti, accédez à Développeur > Console d'administration et vérifiez que vous pouvez voir les fichiers sous le chemin suivant : platform > plugin > slackReviewsPublisher.

Étape 3 : créez une application Yext

1. Accédez à Développeur > Console développeur.
2. Cliquez sur Ajouter une application, saisissez un nom tel que « Annuaire avis Slack », puis cliquez sur Créer une application.
3. Dans l'onglet Identifiants API, cliquez sur Add a new API Permission (Ajouter une nouvelle autorisation API). Sélectionnez API Management > Reviews avec les autorisations Lecture seule et cliquez sur Sauvegarder.
4. Sous l'onglet Webhooks, cliquez sur Ajouter un webhook.
5. Sélectionnez Avis comme type de webhook et cliquez Suivant.
6. Entrez un nom pour le webhook, tel que « Notification d'avis Slack ».
7. Sous URL, cliquez sur Invoke a Function (Invoquer une fonction). Sélectionnez slackReviewsPublisher et choisissez la fonction handleNotification.
8. Cliquez sur Terminer et ajouter.

Votre chaîne Slack recevra désormais une notification chaque fois que votre compte aura un nouvel avis.