--- title: "Utiliser ThunderPhone avec Zapier" description: "Connectez l’application ThunderPhone sur Zapier à votre organisation et créez un Zap qui s’exécute chaque fois qu’un appel se termine." --- [Zapier](https://zapier.com) connecte des applications à l’aide de workflows automatisés appelés Zaps. L’application ThunderPhone sur Zapier ajoute : - **Déclencheurs :** **Appel terminé** se déclenche lorsqu’un appel téléphonique, web ou de test se termine. **Appel évalué** se déclenche lorsque l’évaluation d’un appel terminé est disponible. - **Actions :** **Passer un appel sortant**, **Ajouter des contacts à une campagne** et **Démarrer une campagne**. - **Recherche :** **Rechercher un appel** recherche un appel par ID et le renvoie avec sa transcription et une URL d’enregistrement signée lorsqu’elle est disponible. Retrouvez-la sur [ThunderPhone sur Zapier](https://zapier.com/apps/thunderphone/integrations). Pour une présentation des deux façons d’utiliser Zapier avec ThunderPhone, consultez la [page d’intégration Zapier](https://thunderphone.com/integrations/zapier). ## Connecter votre organisation L’application se connecte via OAuth. Vous vous connectez à ThunderPhone et approuvez l’accès à une organisation, sans copier de clé API dans Zapier. Dans l’éditeur Zap, recherchez **ThunderPhone** (affiché avec le libellé Bêta) et choisissez un déclencheur ou une action. Lorsque Zapier demande un compte, connectez-en un nouveau. Zapier ouvre une fenêtre de connexion ThunderPhone. Connectez-vous, vérifiez les autorisations demandées, choisissez l’organisation et sélectionnez **Approuver**. L’application demande l’autorisation de lire vos agents et numéros de téléphone, de lire et écrire les appels et les campagnes, de gérer les intégrations telles que les points de terminaison webhook, et de voir l’adresse e-mail de votre compte. Zapier nomme la connexion d’après l’organisation que vous avez approuvée afin que vous puissiez distinguer les connexions lorsque vous appartenez à plusieurs organisations. Connectez-vous avec un compte disposant du rôle d’administrateur ou de propriétaire dans cette organisation. L’activation ou la désactivation d’un Zap de déclenchement, ainsi que chaque action, nécessite ce rôle. Un Zap de déclenchement déjà activé continue de recevoir des événements d’appel après un changement de rôle ou la révocation de la connexion. Désactivez-le pour les arrêter. Rechercher un appel fonctionne pour tout membre. L’application n’entraîne aucun frais ThunderPhone propre. Les appels qu’elle passe ou démarre sont facturés selon vos tarifs ThunderPhone habituels, et Zapier comptabilise les tâches selon votre forfait Zapier. ## Créer un premier Zap Ce Zap ajoute une ligne à une feuille Google Sheets chaque fois qu'un appel se termine. Ouvrez un agent dans le builder, cliquez sur **Parler**, puis terminez l’appel. Les appels de test du builder déclenchent Appel terminé, ce qui fournit au déclencheur un appel récent à charger. Choisissez **ThunderPhone** comme application de déclenchement, définissez l’événement sur **Appel terminé**, puis sélectionnez votre connexion ThunderPhone. Testez le déclencheur. Zapier charge vos appels terminés les plus récents comme exemples, avec la même structure qu’un événement en direct. Ajoutez une action Google Sheets qui crée une ligne de feuille de calcul. Choisissez une feuille avec une ligne d’en-tête, puis associez chaque colonne à un champ du déclencheur (voir le tableau ci-dessous). Publiez et activez le Zap. Son activation crée un point de terminaison webhook dans votre organisation ThunderPhone nommé **Zapier: Appel terminé**. La désactivation du Zap supprime ce point de terminaison. Effectuez un autre appel de test dans le builder. Lorsqu’il se termine, le Zap s’exécute et une ligne apparaît. Colonnes utiles : | Colonne | Champ Appel terminé | |---|---| | ID d’appel | ID d’appel | | Agent | Nom de l’agent | | Sens | Sens | | De | Numéro source | | À | Numéro de destination | | Début | Date de début | | Fin | Date de fin | | Durée (s) | Durée en secondes | | Statut | Statut | | Motif de fin | Motif de fin | | Lien de l’appel | Saisissez `https://app.thunderphone.com/dashboard/call-history/`, puis insérez l’ID d’appel | Le lien de l’appel ouvre l’appel dans le tableau de bord ThunderPhone pour les membres de votre organisation, avec sa transcription et son enregistrement. La feuille n’a donc pas besoin de stocker ces éléments. L’événement peut également contenir la transcription, sous forme de liste de tours de parole, et une URL d’enregistrement, un lien signé qui expire. Ajoutez-les uniquement si la feuille en a besoin. Les transcriptions, résumés et enregistrements d’appels peuvent contenir des informations personnelles ou de santé. Envoyez-les uniquement aux applications que votre organisation est autorisée à utiliser pour ces données, dans le cadre d’un BAA lorsque des informations de santé sont concernées, et ne conservez que les champs dont vous avez besoin. Consultez [`telephony.complete` / `web.complete`](/fr/webhooks/call-complete) pour voir tous les champs. Chaque livraison est signée. L’application vérifie le HMAC `X-ThunderPhone-Signature` par rapport au secret du point de terminaison avant l’exécution du Zap et s’arrête pour tout élément non signé ou non valide. Si Zapier n’accepte pas une livraison, ThunderPhone la réessaie pendant un maximum de 24 heures. Consultez la [présentation des webhooks](/fr/webhooks/overview). ## Déclencheurs, actions et recherche **Appel évalué** fournit l’ID de l’appel, l’ID de l’agent, le nom de l’agent et l’évaluation : ID de l’évaluation, score, résultat de l’appel, résumé, modèle d’évaluation et date d’évaluation. L’activation d’un Zap crée un endpoint nommé **Zapier: Appel évalué**. Un appel peut être évalué plusieurs fois, et chaque exécution d’évaluation terminée déclenche le déclencheur. Consultez [`call.graded`](/fr/webhooks/events). **Rechercher un appel** prend un ID d’appel, avec une liste déroulante des appels récents. Il renvoie l’agent de l’appel, la direction, les numéros, les heures de début et de fin, le statut, la raison de fin, le score d’évaluation et le résultat de l’appel, la transcription, ainsi qu’une URL d’enregistrement signée lorsqu’elle est disponible. Un ID d’appel inconnu ne renvoie aucun résultat au lieu d’une erreur. **Passer un appel sortant** prend : | Champ | Signification | |---|---| | Agent | Un agent enregistré. La liste déroulante répertorie vos agents. | | Numéro destinataire | Destination au format E.164, telle que `+14155552671`. | | Numéro d’origine | La liste déroulante répertorie uniquement les numéros activés pour les appels sortants. | | Variables | Objet JSON facultatif de valeurs pour les espaces réservés dans le prompt de l’agent. | | Clé d’idempotence | ID stable provenant du déclencheur ou de l’enregistrement source. Obligatoire. | Cette action renvoie l’ID de l’appel, le statut et la répétition idempotente. **Ajouter des contacts à une campagne** ajoute des contacts à une campagne en brouillon. Pour un contact, renseignez **Numéro de téléphone** au format E.164 et, éventuellement, **Variables de contact**, un objet JSON dont les propriétés deviennent des variables de campagne. Pour un lot, renseignez **JSON des contacts** avec un tableau pouvant contenir jusqu’à 5 000 objets. Chacun doit contenir `phone_number`, et ses autres propriétés deviennent des variables. L’étape échoue lorsque tous les contacts sont rejetés et définit **Succès partiel** lorsque seuls certains le sont. **Démarrer une campagne** démarre ou reprend une campagne contenant au moins un contact. Cette action requiert le **Consentement de facturation**. Consultez [Campagnes sortantes](/fr/guides/outbound-campaigns). ## Avant qu’un Zap passe des appels Passer un appel sortant et Démarrer une campagne composent de vrais numéros de téléphone et lancent des appels facturables. - Si ThunderPhone demande à votre organisation de confirmer que ses appels sortants respectent la TCPA et les autres lois sur les appels, un administrateur doit enregistrer cette confirmation dans le tableau de bord avant qu’un Zap puisse lancer des appels. - Le numéro d’origine doit être activé pour les appels sortants. Les numéros apportés depuis votre propre opérateur sont admissibles une fois vérifiés. Les numéros fournis par ThunderPhone sont initialement réservés aux appels entrants, et vous pouvez demander l’accès aux appels sortants pour ces numéros dans le tableau de bord. Consultez [Obtenir un numéro de téléphone](/fr/guides/get-a-phone-number). - Passer un appel sortant requiert une **Clé d’idempotence**. Mappez un ID stable provenant du déclencheur ou de l’enregistrement source, tel que l’ID d’événement ThunderPhone ou l’ID d’un enregistrement CRM. Si Zapier réessaie l’étape, ThunderPhone reconnaît la clé et renvoie l’appel d’origine au lieu d’en passer un second. Évitez les horodatages, les valeurs aléatoires ou l’ID du Zap seul. - Démarrer une campagne requiert le **Consentement de facturation**, qui confirme que le Zap peut lancer des appels sortants facturables sur votre compte. - Votre organisation est responsable de disposer du consentement nécessaire pour appeler chaque numéro et de respecter les lois applicables aux appels. Consultez [lois sur les appels sortants](/fr/guides/outbound-calling-laws). Une clé d’idempotence est unique dans votre organisation et peut comporter au maximum 128 caractères. Réutiliser une clé avec un agent, un numéro ou des variables différents échoue avec un conflit. Si deux Zaps peuvent appeler au sujet du même enregistrement, attribuez à chaque Zap son propre préfixe fixe avant l’ID de l’enregistrement. [Passer des appels sortants](/fr/guides/place-outbound-calls) décrit l’API sous-jacente à cette action. ## Exemples de Zaps - **Appel terminé vers un CRM.** Enregistrez une activité pour chaque appel terminé avec son statut, son motif de fin et sa transcription. - **Appel évalué vers un suivi.** Filtrez selon le résultat ou le score de l'appel et acheminez l'appel vers le bon workflow de suivi. - **Nouveau lead vers une campagne.** Ajoutez le lead à une campagne brouillon avec Add Contacts to Campaign, puis exécutez Start Campaign une fois que quelqu'un a approuvé la liste. Les transcriptions, résumés et enregistrements d'appels peuvent contenir des informations personnelles ou de santé. Envoyez-les uniquement aux applications que votre organisation est autorisée à utiliser pour ces données, dans le cadre d'un BAA lorsque des informations de santé sont concernées, et conservez uniquement les champs dont vous avez besoin. ## Dépannage **Une étape échoue avec une erreur d'autorisation.** Reconnectez la connexion ThunderPhone dans Zapier et approuvez-la à nouveau. Une connexion cesse de fonctionner lorsque la personne qui l'a connectée la révoque dans ThunderPhone sous **Organisation → Clés → Applications autorisées**, lorsque cette personne quitte l'organisation, ou lorsqu'elle reste 30 jours sans actualisation réussie du jeton. Consultez [Se connecter avec OAuth](/fr/guides/oauth). **L'activation ou la désactivation d'un Zap échoue, ou une action est refusée.** La personne qui s'est connectée doit avoir le rôle d'administrateur ou de propriétaire dans l'organisation. Reconnectez-vous avec un compte qui l'a. Un Zap déclencheur déjà activé continue de recevoir des événements d'appel après le changement de rôle ou la révocation de la connexion. Désactivez-le pour arrêter leur réception. **Vous souhaitez déconnecter l'application.** Désactivez vos Zaps ThunderPhone avant de révoquer la connexion, car désactiver un Zap supprime son point de terminaison et nécessite une connexion fonctionnelle. Si vous l'avez d'abord révoquée, supprimez le point de terminaison **Zapier: …** restant avec `DELETE /v1/developer/webhook-endpoints/{id}` à l'aide d'une clé API d'administrateur. Consultez [Points de terminaison webhook](/fr/webhooks/endpoints). **Le Zap doit utiliser une autre organisation.** Chaque connexion couvre une seule organisation. Désactivez d'abord le Zap afin que son point de terminaison webhook soit supprimé de l'organisation actuelle. Connectez ensuite un nouveau compte ThunderPhone dans Zapier, choisissez l'autre organisation lorsque vous approuvez, puis sélectionnez cette connexion à chaque étape ThunderPhone. Les agents, numéros et campagnes diffèrent selon les organisations, sélectionnez donc de nouveau **Agent**, **Numéro d'origine** et **Campagne** à chaque étape qui les contient. Réactivez ensuite le Zap. **Le déclencheur ne se lance plus.** Chaque Zap avec un déclencheur ThunderPhone possède un point de terminaison webhook dans votre organisation, nommé **Zapier: Appel terminé** ou **Zapier: Appel évalué**. Il est créé lorsque le Zap est activé et supprimé lorsqu'il est désactivé. Laissez-le tel quel. S'il a été modifié ou supprimé dans ThunderPhone, désactivez puis réactivez le Zap pour en créer un nouveau. Avec une clé API d'administrateur, [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) affiche les tentatives de livraison récentes. Vous souhaitez que l'agent vocal utilise des actions Zapier pendant un appel plutôt qu'après celui-ci ? Connectez un point de terminaison MCP Zapier dans **Connexions → MCP**. Consultez [Serveurs MCP](/fr/guides/mcp-servers). Pour envoyer les mêmes événements d'appel vers votre propre serveur, consultez [Points de terminaison webhook](/fr/webhooks/endpoints).