Extension de votre assistant avec des webhooks
Un webhook est un mécanisme que vous pouvez utiliser pour appeler un programme externe en fonction des événements de votre programme. Vous pouvez utiliser des webhooks pour faire des appels de votre assistant vers un service ou une application externe pendant d'une conversation.
Vous pouvez utiliser les types de webhooks suivants dans votre assistant. Ils sont appelés avec chaque échange dans une conversation entre le client et l'assistant:
Si vous utilisez une boîte de dialogue, vous pouvez ajouter un webhook de boîte de dialogue. Lorsqu'il est utilisé dans une compétence de dialogue, un webhook est déclenché lorsque l'assistant traite un noeud avec un webhook activé. Pour plus d'informations, voir la rubrique Appel par programmation à partir d'un dialogue.
| Type | Fréquence | Conditions |
|---|---|---|
| Premessage et Postmessage | Les webhooks de traitement des messages sont appelés avec chaque échange dans une conversation entre le client et l'assistant. | Pour les webhooks de traitement des messages, les conditions à vérifier doivent être définies dans le code d'application externe. Par exemple, même si votre webhook effectue une traduction en langue simple, vous souhaiterez utiliser une condition pour vérifier la langue du message entrant avant d'envoyer le texte au service de traduction. |
| Journal | Le journal du webhook est appelé avec chaque message et sa réponse correspondante. | Il n'est pas nécessaire de définir une condition pour le webhook du journal, sauf si vous souhaitez filtrer les messages d'une manière ou d'une autre. Dans la plupart des cas, l'objectif est d'écrire chaque message qui est soumis, afin que les messages puissent être stockés aussi longtemps que vous le souhaitez et analysés par une application ou un service externe. |
| Dialog | Le webhook de la boîte de dialogue est appelé à la rare occasion de traiter le nœud de la boîte de dialogue à partir duquel il est déclenché. | Pour un webhook de boîte de dialogue, les conditions à remplir sont définies dans la boîte de dialogue. Si la condition de noeud n'est pas remplie, le webhook de la boîte de dialogue n'est jamais appelé. |