Alerte Slack sur avis négatif avec Zapier

Ce que vous obtenez

Dès qu'un avis de 2 étoiles ou moins arrive sur l'un de vos établissements, un message part dans le canal Slack de votre équipe, avec la note, l'auteur et le texte de l'avis. Personne n'a besoin d'ouvrir l'application pour être prévenu.

Le Zap utilise des applications génériques de Zapier, Webhooks by Zapier, Filter by Zapier et Slack : il n'existe pas d'application Ma Belle Note dans Zapier, et il n'en faut pas. Le même Zap fonctionne avec Microsoft Teams à la place de Slack. Les libellés cités sont ceux de l'interface anglaise de Zapier.

Il vous faut

• Un compte Zapier dont l'offre comprend Webhooks by Zapier, qui n'est pas inclus dans l'offre gratuite de Zapier au moment où ce guide est écrit.
• Un espace Slack où vous pouvez connecter Zapier.
• Un accès propriétaire ou administrateur à Ma Belle Note, pour ajouter le point de réception.
• Une clé API avec le droit reviews:read, par exemple créée avec le modèle Lecture seule.

1. Recevoir les événements dans Zapier

Créez un Zap. Comme déclencheur, choisissez Webhooks by Zapier, événement Catch Hook, puis copiez l'adresse que Zapier affiche, de la forme https://hooks.zapier.com/hooks/catch/123456/abcdef/.

2. Abonner cette adresse aux nouveaux avis

Dans l'application, ouvrez Réglages › Intégration, API & webhooks, onglet Webhooks, puis Ajouter un point de réception :

• Adresse de réception : l'adresse copiée dans Zapier.
• Événements suivis : seulement Nouvel avis (review.created).
• Laissez cochée Ignorer les avis importés lors du rattrapage historique.

Gardez le secret affiché : Zapier ne vérifie pas les signatures Standard Webhooks, mais vous en aurez besoin si vous passez plus tard à votre propre serveur. Vous pouvez aussi créer ce point de réception par l'API, avec POST /v1/webhook-endpoints (voir le guide des webhooks).

3. Donner un exemple d'avis à Zapier

Pour proposer les champs de l'avis aux étapes suivantes, Zapier a besoin d'un exemple reçu. L'événement de test de l'application ne contient pas d'avis : attendez le prochain avis, ou envoyez à Zapier un événement construit à partir de votre dernier avis, depuis un terminal avec curl et jq :

curl -s "https://api.mabellenote.com/v1/reviews?limit=1" \
  -H "Authorization: Bearer $MBN_API_KEY" \
  | jq '.data[0] | {object: "event", id: "ev_exemple_zapier", type: "review.created", apiVersion: "v1", createdAt, establishmentId, origin: "sync", data: {object: .}}' \
  | curl -X POST "https://hooks.zapier.com/hooks/catch/123456/abcdef/" \
      -H "Content-Type: application/json" \
      --data-binary @-

Revenez dans Zapier, testez le déclencheur et choisissez cet exemple.

4. Relire l'avis auprès de l'API

Catch Hook ne vérifie pas la signature des livraisons : quiconque connaît l'adresse du Zap peut lui envoyer une requête. Pour ne jamais alerter sur un faux avis, relisez l'avis auprès de l'API, qui ne répond que pour les avis de votre compte.

Ajoutez l'action Webhooks by Zapier › GET :

Les champs de cette étape, rating, author.name et comment, sont la version à jour et vérifiée de l'avis : utilisez-les pour la suite. Pour un identifiant inconnu, l'API répond 404 et la note est absente : le filtre de l'étape suivante arrête alors le Zap.

5. Ne garder que les avis négatifs

Ajoutez Filter by Zapier, avec deux conditions :

• le champ Type du déclencheur est exactement review.created ;
• le champ Rating de l'étape 4, en nombre ((Number) Less than), est inférieur à 3.

Seuls les avis de 1 ou 2 étoiles passent. L'événement de test de l'application, de type webhook.test, s'arrête ici : c'est normal.

6. Poster le message dans Slack

Ajoutez Slack › Send Channel Message, choisissez le canal, puis composez le texte avec les champs de l'étape 4. Le message obtenu ressemble à ceci :

Avis 2/5 de Jean D.
Service très lent ce soir, dommage car les plats étaient bons.

Pour ajouter le nom de l'établissement, insérez avant Slack une seconde action Webhooks by Zapier › GET sur https://api.mabellenote.com/v1/establishments/ suivi du champ Establishment Id, avec une clé qui porte aussi establishments:read : son champ name est le nom de l'établissement.

7. Publier le Zap

Activez le Zap. Dès lors, chaque nouvel avis négatif arrive dans le canal quelques secondes après sa synchronisation dans Ma Belle Note.

Ce qu'il faut savoir

• Doublons rares : une livraison est garantie au moins une fois. Si la réponse de Zapier se perd, l'événement est relivré, et le message peut partir deux fois.
• Adresse à garder secrète : si l'adresse du Zap fuit, créez un nouveau Catch Hook, ajoutez un nouveau point de réception avec la nouvelle adresse, puis supprimez l'ancien.
• Tâches Zapier : chaque avis reçu consomme au moins une tâche de votre forfait Zapier, celle de la relecture de l'étape 4, même quand le filtre l'arrête ensuite.
• Retours privés : abonnez aussi le point de réception à Nouveau retour privé (feedback.created) et relisez-le avec GET /v1/feedbacks/<id> (droit feedbacks:read) pour être prévenu des retours laissés depuis vos QR codes.