En plus d'envoyer des messages et de taguer (ou détager) vos clients, vous pouvez désormais orchestrer des actions et workflows dans d'autres applications et systèmes avec des webhooks dans Series.
Avec les webhooks dans Series, vous pouvez utiliser n'importe quel événement ou ensemble de filtres dans Intercom, pour faire des choses comme :
Maintenir les données clients synchronisées entre plusieurs systèmes.
Envoyer des notifications internes à votre équipe lorsque des users atteignent une étape importante dans une Series.
Effectuer des mises à jour dans votre propre application personnalisée ou base de données.
Qu'est-ce qu'un webhook ?
Un webhook est un message envoyé depuis Intercom lorsqu'un user correspond aux critères que vous spécifiez (comme la réalisation d'un événement). Il contient un message — ou « payload » — et est envoyé à une URL unique de votre choix.
Par exemple, voici une série simple qui envoie un webhook après qu'un user effectue une certaine action :
Le webhook contient le nom de l'user, le nom de l'entreprise et l'ID. Le payload du webhook ressemble à ceci :
POST https://examply.io/webhooks
Content-Type: application/json
{
name: “Lonnie Lynn”
company: “CSense Ltd”
company_id: “c0m5en5e”
}
L'application qui reçoit le webhook peut ensuite faire quelque chose (ou plusieurs choses) avec les données du payload. 👌
Note : L'envoi de webhooks avec Series est disponible uniquement sur certains plans Intercom. Voir nos plans et tarifs ici.
Comment ajouter un webhook à une series
Faites glisser un webhook depuis le menu à droite, et connectez-le à votre series après n'importe quel bloc de règle que vous souhaitez déclencher :
Ouvrez le bloc webhook et donnez-lui un titre :
Vous pouvez maintenant configurer exactement quelles données envoyer et où les envoyer.
Astuce de pro : Si vous envoyez un webhook vers une autre application (comme Zapier par exemple), vous pouvez généralement trouver le type de requête, l'URL du webhook et les en-têtes nécessaires dans leur documentation. Si vous envoyez un webhook vers votre propre application, vos ingénieurs devraient pouvoir fournir ces informations. 👌 |
Commençons par la méthode HTTP et l'URL du webhook :
Pour la méthode, vous pouvez choisir entre PUT ou POST, et l'URL est celle de l'application qui doit recevoir le webhook.
Astuce : Vous pouvez utiliser RequestBin ou un service similaire lors des tests.
Ensuite, ajoutez les en-têtes webhook sous forme de paires clé-valeur :
Seul l'en-tête Content-Type est requis pour envoyer un webhook (JSON ou URLencoded), cependant, des en-têtes supplémentaires peuvent être nécessaires pour recevoir le webhook.
Par exemple, vous pourriez avoir besoin de vous authentifier auprès de l'application réceptrice.
Pour ajouter de nouveaux en-têtes, cliquez simplement sur « + Ajouter une paire clé-valeur » :
Optionnellement, sélectionnez les données à inclure dans le corps du webhook sous forme de paires clé-valeur. Dans cet exemple, nous envoyons le nom, le nom de l'entreprise et l'ID de l'entreprise.
Pour les données dynamiques, ajoutez des attributs Intercom avec le menu « {...} » :
Tester votre webhook
Avant de mettre votre series en ligne, nous recommandons de tester votre webhook pour vous assurer qu'il est envoyé et reçu comme prévu. Cliquez sur « Tester » :
Tapez le nom ou l'adresse e-mail d'un user test afin de voir ses données apparaître dans le payload du webhook :
Puis sélectionnez-le et cliquez sur « Lancer le test » :
Vous verrez la réponse renvoyée par l'application destinataire :
Note : Vous devriez voir un code de succès « 200 », tout autre code peut nécessiter un dépannage avec l'application destinataire.
Que se passe-t-il si un webhook échoue ?
Si un webhook réussit, nous enregistrons une statistique « Envoyé ». En cas d'échec, nous essaierons de l'envoyer 2 fois de plus. Après la troisième tentative, le point de contrôle sera marqué comme « Échoué ». Vous pouvez consulter ces résultats en cliquant sur le webhook une fois votre series en ligne. 👍