# 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](/fr/docs/rest-api) et les [webhooks](/fr/docs/webhooks) : elles utilisent donc les mêmes données et les mêmes limites.

> Les applications sont prêtes, et elles deviennent disponibles dans les annuaires d'applications de Zapier et de Make une fois qu'elles y sont publiées. En attendant, vous pouvez connecter l'un ou l'autre outil dès aujourd'hui avec son propre module de webhook entrant et un [webhook](/fr/docs/webhooks#ajouter-un-webhook) intoCHAT, ou appeler l'[API REST](/fr/docs/rest-api) depuis son module HTTP.

## 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](/fr/docs/rest-api#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](/fr/docs/lead-collection) ou dans le chat. | `lead.created` |
| **New form submission** | Un visiteur envoie l'un de vos [formulaires de chat](/fr/docs/chat-forms). | `form.submitted` |
| **New booking** | Un visiteur réserve un rendez-vous depuis le chat. Consultez [Réservation avec Cal.com ou Calendly](/fr/docs/booking). | `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](/fr/docs/orders). | `return.requested` |
| **Hand-off requested** | L'agent envoie une conversation à votre équipe par e-mail. Consultez [Transfert par e-mail](/fr/docs/handoff). | `handoff.requested` |
| **Live chat requested** | L'agent demande à votre équipe de rejoindre un chat. Consultez [Chat en direct](/fr/docs/live-chat). | `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](/fr/docs/webhooks#evenements). **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é](/fr/docs/webhooks#ce-qui-est-envoye), 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](/fr/docs/rest-api#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](/fr/docs/text-and-qa).

## Se connecter avec une clé API

1. Dans intoCHAT, dans la barre latérale sous **Settings**, cliquez sur **API keys**.
2. Sous **Create a key**, donnez à la clé un **Name** que vous reconnaîtrez, par exemple `Zapier`.
3. 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.
4. Cliquez sur **Create key**, puis sur **Copy**.
5. 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](/fr/docs/rest-api#creer-une-cle-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](/fr/docs/webhooks#webhooks-crees-par-des-integrations).
- 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](/fr/docs/rest-api#limites-de-debit).
- 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](/fr/docs/webhooks).
- Tous les points de terminaison qu'utilisent les applications : [API REST](/fr/docs/rest-api).
- Publiez les mêmes événements dans un canal Slack sans aucun outil : [Alertes Slack](/fr/docs/lead-alerts-and-export#alertes-slack).