Utiliser ThunderPhone avec Zapier

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 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. Pour une présentation des deux façons d’utiliser Zapier avec ThunderPhone, consultez la page d’intégration 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.

1. Ajouter une étape ThunderPhone

   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.

2. Se connecter et choisir l’organisation

   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.

3. Vérifier le nom de la connexion

   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.

1. Effectuer un appel pour utiliser des données d’exemple

   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.

2. Ajouter le déclencheur

   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.

3. Ajouter Google Sheets

   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).

4. Publier le Zap

   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.

5. Le tester

   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 :

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 pour voir tous les champs.

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.

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 :

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.

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.
• 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.

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 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.

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.

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 affiche les tentatives de livraison récentes.