Connecter intoCHAT à Zapier et Make
Utilisez intoCHAT dans Zapier et Make : déclencheurs instantanés pour les nouveaux leads, formulaires reçus, réservations, demandes de retour, transferts et demandes de chat en direct, actions pour discuter avec un agent et ajouter des connaissances, et connexion avec une clé API.
intoCHAT dispose d'applications pour Zapier et Make. Elles lancent un Zap ou un scénario dès que quelque chose se produit sur votre agent, comme un nouveau lead, et elles permettent à un Zap ou à un scénario d'envoyer un message à votre agent ou d'enrichir ses connaissances. Elles reposent sur l'API REST et les webhooks : elles utilisent donc les mêmes données et les mêmes limites.
Offres qui incluent les applications
Les applications utilisent l'API REST, incluse dans les offres Starter, Pro et Enterprise. Avec l'offre Free, vous ne pouvez pas créer la clé API dont elles ont besoin. Si votre compte repasse à l'offre Free, les applications cessent de fonctionner jusqu'à ce qu'il soit de nouveau sur Starter ou une offre supérieure. Consultez Offres qui incluent l'API.
Chaque réponse que l'agent rédige pour Send a message to an agent compte comme un message de votre offre, comme dans le widget de chat. Les déclencheurs et les autres actions ne consomment aucun message.
Ce qui est disponible
Déclencheurs
| Déclencheur | Se lance quand | Événement |
|---|---|---|
| New lead | Un visiteur laisse ses coordonnées, dans le formulaire de leads ou dans le chat. | lead.created |
| New form submission | Un visiteur envoie l'un de vos formulaires de chat. | form.submitted |
| New booking | Un visiteur réserve un rendez-vous depuis le chat. Consultez Réservation avec Cal.com ou Calendly. | booking.created |
| New return request | Un visiteur demande à retourner ou à échanger des articles d'une commande vérifiée. Consultez Statut des commandes et retours. | return.requested |
| Hand-off requested | L'agent envoie une conversation à votre équipe par e-mail. Consultez Transfert par e-mail. | handoff.requested |
| Live chat requested | L'agent demande à votre équipe de rejoindre un chat. Consultez Chat en direct. | live_chat.requested |
| New conversation | Une nouvelle conversation commence avec l'agent. | conversation.created |
Les six premiers sont instantanés : intoCHAT envoie l'événement en quelques secondes, de la même façon qu'un webhook. New conversation n'a pas de webhook : l'outil vérifie donc les nouvelles conversations selon son propre rythme, par exemple toutes les quelques minutes dans Zapier, selon votre offre Zapier ou Make.
Chaque déclencheur demande l'Agent qu'il surveille ; la liste affiche tous les agents de votre compte. La sortie du déclencheur est le data de l'événement, avec les champs décrits sous Ce qui est envoyé, par exemple email, name et conversationId pour un nouveau lead.
Actions
| Action | Ce qu'elle fait |
|---|---|
| Send a message to an agent | Envoie un message et renvoie la réponse de l'agent et l'identifiant de la conversation. Indiquez un Session ID, comme l'adresse e-mail du client, pour poursuivre la même conversation à chaque fois. Consultez Envoyer un message. |
| Add a Q&A pair | Ajoute une question et sa réponse aux connaissances de l'agent et lance l'entraînement. Une question que l'agent a déjà reçoit la nouvelle réponse. |
| Add a text snippet | Ajoute un texte avec un titre aux connaissances de l'agent et lance l'entraînement. |
| Find conversation (une recherche dans Zapier, Get a conversation dans Make) | Trouve une conversation par son identifiant, avec sa transcription. Utilisez-la après un déclencheur pour lire tout le chat. |
Les nouvelles connaissances comptent dans les caractères d'entraînement de l'agent, et l'agent les utilise une fois l'entraînement terminé. Consultez Texte et questions-réponses.
Se connecter avec une clé API
- Dans intoCHAT, dans la barre latérale sous Settings, cliquez sur API keys.
- Sous Create a key, donnez à la clé un Name que vous reconnaîtrez, par exemple
Zapier. - Sous Access, gardez Every scope, including ones added later. Pour limiter plutôt la clé, choisissez Only the scopes I choose et cochez les scopes du tableau ci-dessous.
- Cliquez sur Create key, puis sur Copy.
- Dans Zapier ou Make, ajoutez une étape intoCHAT, choisissez de connecter un nouveau compte et collez la clé dans API key.
Utilisez une clé par outil, pour pouvoir en révoquer une sans arrêter l'autre. Consultez Créer une clé API.
| Scope | Nécessaire pour |
|---|---|
agents:read | La connexion, et la liste Agent |
webhooks:write | Les déclencheurs instantanés |
leads:read | Les exemples de données de New lead, New form submission, New booking et New return request dans Zapier |
conversations:read | New conversation, Find conversation, et les exemples de données de Hand-off requested et Live chat requested dans Zapier |
chat | Send a message to an agent |
sources:write | Add a Q&A pair et Add a text snippet |
Fonctionnement des déclencheurs instantanés
Quand vous activez un Zap, ou ajoutez un déclencheur instantané dans un scénario Make, l'outil demande à intoCHAT d'envoyer cet événement à une adresse qui lui est propre. intoCHAT l'enregistre comme un webhook sur l'agent :
- Il apparaît dans l'onglet Leads de l'agent sous Webhooks, avec la mention via Zapier ou via Make. Consultez Webhooks créés par des intégrations.
- Il est envoyé, retenté et journalisé comme n'importe quel webhook : Recent deliveries montre donc ce qui a été envoyé à l'outil.
- Quand vous désactivez le Zap, ou supprimez le déclencheur ou le scénario dans Make, l'outil retire de nouveau le webhook.
Le webhook de chaque événement est signé, mais Zapier et Make ne savent pas vérifier la signature : les applications n'utilisent donc pas le secret de signature. L'adresse que l'outil donne à intoCHAT est propre à votre Zap ou à votre scénario.
Exemples de données
Quand vous testez un déclencheur, Zapier charge jusqu'à trois des derniers vrais événements de ce type de l'agent. S'il n'y en a pas encore, par exemple avant votre première réservation, il affiche un exemple avec les mêmes champs, pour que vous puissiez quand même les associer. Dans Make, l'exemple est fourni avec le module ; exécutez le scénario une fois et déclenchez un vrai événement pour voir de vraies données.
Révoquer une clé
Révoquer une clé dans Settings, API keys arrête les applications qui l'utilisent dès leur requête suivante, et supprime les webhooks que cette clé a créés pour Zapier ou Make, avec leur historique d'envois. Les Zaps et les scénarios restent activés mais ne reçoivent plus d'événements. Pour vous reconnecter, créez une nouvelle clé, mettez à jour la connexion dans Zapier ou Make, puis désactivez et réactivez le Zap (dans Make, recréez le webhook du déclencheur), afin qu'un nouveau webhook soit créé.
Limites
- Les limites de l'API REST s'appliquent : 60 requêtes par minute et par clé, et les messages de l'offre pour Send a message to an agent. Consultez Limites de débit.
- Un agent peut avoir jusqu'à 25 webhooks issus d'intégrations, en plus des 5 que vous ajoutez vous-même. Désactiver les Zaps que vous n'utilisez plus en libère.
- Les déclencheurs n'incluent pas les modifications ultérieures, comme une réservation annulée ou une demande de retour traitée.
- Les exemples de données de Hand-off requested reconstitués à partir de transferts passés n'ont pas de
summary(il n'est pas conservé) ; les événements en direct l'ont.
Dépannage
- La connexion échoue. Vérifiez que la clé commence par
ic_live_, qu'elle n'a pas été révoquée et que votre compte est sur Starter ou une offre supérieure. - Un déclencheur indique qu'il manque un scope à la clé. Créez une clé avec Every scope, ou avec les scopes listés ci-dessus, et reconnectez-vous.
- Un Zap ne reçoit plus d'événements. Vérifiez l'onglet Leads de l'agent : si son webhook via Zapier a disparu, il a été retiré dans intoCHAT ou sa clé a été révoquée. Désactivez et réactivez le Zap pour vous abonner de nouveau. Si le webhook est Paused, réactivez-le.
- Trop de webhooks. Désactivez les Zaps ou supprimez les déclencheurs Make que vous n'utilisez plus, ou retirez leurs webhooks dans l'onglet Leads.
Étapes suivantes
- Ce que contient chaque événement : Webhooks.
- Tous les points de terminaison qu'utilisent les applications : API REST.
- Publiez les mêmes événements dans un canal Slack sans aucun outil : Alertes Slack.