Skip to main content
Dans ce guide, vous apprendrez à déclencher automatiquement un appel d’un VoiceAgent CloudTalk depuis Zoho CRM à l’aide des Workflow Rules.
Niveau d’utilisateur : Admin

​
Avant de commencer

Vous aurez besoin de :
  • Un VoiceAgent CloudTalk déjà créé (notez l’ID du VoiceAgent)
  • Des identifiants API CloudTalk (Clé API et Secret), disponibles dans Paramètres de l’entreprise > Intégrations > API (Comment accéder à vos clés API CloudTalk et les générer)
  • Zoho CRM plan Professional ou supérieur
  • Un champ téléphone disponible sur les fiches Contact ou Lead

​
Générer l’en-tête Authorization

CloudTalk utilise l’authentification Basic pour les requêtes API.
  1. Ouvrez https://www.debugbear.com/basic-auth-header-generator
  2. Saisissez votre clé API CloudTalk comme nom d’utilisateur et votre secret API comme mot de passe
  3. Copiez la valeur générée. Elle ressemble à ceci : Basic XXXXXXXXX

​
Configurer l’intégration

​
Créer le webhook

1. Dans Zoho CRM, cliquez sur l’icône Engrenage en haut à droite, puis accédez à Automation > Actions > Webhooks
2. Cliquez sur Configure Webhook
3. Renseignez les détails du webhook :
4. Sous Custom Headers, ajoutez :
  • Authorization → Basic XXXXXXXXX (la valeur que vous avez générée)
  • Content-Type → application/json
5. Sous Body, réglez Type sur Raw et Format sur JSON, puis collez :
call_number et voice_agent_id sont les seuls champs obligatoires. Vous pouvez également transmettre des call_properties facultatifs, comme des variables de prompt système et des variables de sortie, selon la configuration de votre VoiceAgent. Découvrez ce qu’il faut inclure
6. Cliquez sur Save

​
Créer la règle de workflow

1. Cliquez sur l’icône Engrenage en haut à droite, puis accédez à Automation > Workflow Rules
2. Cliquez sur Create Rule
Remarque : les webhooks sont disponibles à partir de l’édition Zoho CRM Professional.
3. Configurez la règle :
  • Sélectionnez le module (par ex. Contacts ou Leads) et donnez un nom à la règle
  • Définissez le déclencheur (par ex. création d’une fiche, modification d’un champ)
  • Ajoutez des conditions pour filtrer les fiches (par ex. le champ téléphone n’est pas vide)
  • Sous Instant Actions, ajoutez : Webhook > CloudTalk VoiceAgent
4. Cliquez sur Save, puis sur Activate pour activer la règle

​
Tester et vérifier

  1. Créez ou mettez à jour un contact qui remplit les conditions de votre déclencheur
  2. Accédez à icône Engrenage > Automation > Workflow Rules, sélectionnez votre règle et cliquez sur View Usage pour vérifier l’exécution
  3. Vérifiez dans CloudTalk que l’appel du VoiceAgent a bien été lancé
Tout est prêt ! 🚀 Votre workflow Zoho CRM déclenchera désormais un appel d’un VoiceAgent CloudTalk dès qu’une fiche remplira les conditions que vous avez choisies.
💡 Limites d’API à garder à l’espritPour éviter les échecs ou la limitation du débit, veillez à ce que votre workflow gère la répartition des appels avec précaution. Utilisez des délais ou une logique de planification si nécessaire, car la limite de débit standard de l’API (60 requêtes par minute) s’applique au point de terminaison VoiceAgent.

​
Dépannage

Si l’appel du VoiceAgent n’a pas été passé, accédez à View Usage et cliquez sur Failures. Recherchez votre fiche et consultez la colonne Reason For Failures.
Besoin d’aide ou une question ? Contactez-nous via notre Portail Support. Nous sommes là pour vous.