> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Déclencher un appel VoiceAgent depuis Freshdesk

> Automatisez les appels VoiceAgent directement depuis Freshdesk

<Note>
  Dans ce guide, vous allez apprendre à déclencher automatiquement un appel VoiceAgent CloudTalk depuis Freshdesk grâce aux règles d'automatisation. L'action **Trigger Webhook** vous donne un contrôle total sur la méthode HTTP, l'URL, les en-têtes et le corps de la requête : les appels peuvent ainsi être lancés directement à partir des événements de ticket.
</Note>

**Niveau utilisateur** : Administrateur

***

<h2 id="h_c4f65f76b0">
  Avant de commencer
</h2>

Il vous faut :

* Un VoiceAgent CloudTalk déjà créé (notez l'ID du VoiceAgent)

* Les identifiants d'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](/fr/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys))

* Un **forfait Freshdesk Pro** ou supérieur

* Un numéro de téléphone disponible sur les fiches Contact

<h2 id="h_e32b3b4cc1">
  Générer l'en-tête Authorization
</h2>

CloudTalk utilise l'authentification Basic pour les requêtes API.

1. Ouvrez [https://www.debugbear.com/basic-auth-header-generator](https://www.debugbear.com/basic-auth-header-generator)

2. Saisissez votre **Clé API CloudTalk** comme Username et votre **Secret API** comme Password

3. Copiez la valeur générée. Elle ressemble à ceci : `Basic XXXXXXXXX`

<Warning>
  **Remarque :** Freshdesk accepte aussi une simple combinaison nom d'utilisateur/mot de passe dans la configuration du webhook ; l'en-tête encodé en Base64 est donc facultatif. Les deux méthodes fonctionnent.
</Warning>

<h2 id="h_da76a54a08">
  Configurer l'intégration
</h2>

<h3 id="h_e02ace1232">
  Créer la règle d'automatisation
</h3>

1\. Dans Freshdesk, allez dans **Admin > Automation > Ticket Creation** (ou **On Ticket Update**, selon le moment où vous souhaitez déclencher les appels)

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/459801bf74ad-screenshot-2026-06-05-at-10-53-54.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=5a7cc485d58bd1d956110794946f4af7" alt="" width="2936" height="1322" data-path="images/help-center/articles/15457387/459801bf74ad-screenshot-2026-06-05-at-10-53-54.png" />
</Frame>

2\. Cliquez sur **Start from scratch**

3\. Définissez vos **conditions**, par exemple :

* *Ticket is created*

* *Contact phone is present*

* *Tag contains* `voiceagent`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/ebd0b5c7f2ee-screenshot-2026-06-05-at-10-59-53.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6f883a536c594b5986ed2490dbcdb112" alt="" width="2926" height="1310" data-path="images/help-center/articles/15457387/ebd0b5c7f2ee-screenshot-2026-06-05-at-10-59-53.png" />
</Frame>

4\. Sous **Actions**, cliquez sur **Add action > Trigger Webhook**

5\. Configurez le webhook :

| **Champ** | **Valeur** |
| - | - |
| Request type | POST |
| URL | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Encoding | JSON |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/06136a27c11d-screenshot-2026-06-05-at-11-00-17.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=88d12880285be17c78721cb9768b7c11" alt="" width="2926" height="1332" data-path="images/help-center/articles/15457387/06136a27c11d-screenshot-2026-06-05-at-11-00-17.png" />
</Frame>

6\. Sous **Custom Headers**, ajoutez :

* `Autorisation` > `Basic XXXXXXXXX`

* `Content-Type` > `application/json`

7\. Sous **Content (Advanced)**, collez le corps de requête suivant :

```json theme={"system"}
{
  "call_number": "#{{ticket.contact.phone}}",
  "voice_agent_id": "YOUR_VOICE_AGENT_ID"
}
```

<Warning>
  `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](/fr/articles/11401649-voiceagents-for-outbound-calls)
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/9cf3505f96ed-screenshot-2026-06-05-at-11-00-39.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=623092ba130f596b5667a223dc720089" alt="" width="2922" height="1316" data-path="images/help-center/articles/15457387/9cf3505f96ed-screenshot-2026-06-05-at-11-00-39.png" />
</Frame>

8\. Cliquez sur **Preview and save**, puis activez la règle.

<h3 id="h_9e07057933">
  Tester et vérifier
</h3>

1. Créez ou mettez à jour un ticket qui correspond à vos conditions de déclenchement

2. Allez dans **Admin > Automation** et consultez le journal d'exécution de la règle

3. Vérifiez dans CloudTalk que l'appel VoiceAgent a bien été lancé

**Tout est prêt !** 🚀 Votre règle d'automatisation Freshdesk déclenchera désormais un appel VoiceAgent CloudTalk dès qu'un ticket remplira les conditions que vous avez choisies.

<Info>
  💡 **Limites de l'API à garder à l'esprit**

  *Pour éviter les échecs ou la limitation du débit, veillez à ce que votre automatisation Freshdesk répartisse les 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.*
</Info>

<h2 id="h_c94f683814">
  Dépannage
</h2>

| Erreur | Ce qu'il faut vérifier |
| - | - |
| **401 Unauthorized** | Régénérez l'en-tête Authorization et saisissez-le à nouveau |
| **400 Bad Request** | Vérifiez que le numéro de téléphone est au format E.164 (`+1234567890`) et que `voice_agent_id` est correct |
| **La règle ne se déclenche pas** | Vérifiez que toutes les conditions sont remplies et que la règle est activée |

***

Besoin d'aide ou vous avez une question ? Contactez-nous via notre [Portail Support](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884). Nous sommes là pour vous.


## Related topics

- [Déclencher un appel VoiceAgent depuis Freshservice](/fr/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)
- [Déclencher un appel VoiceAgent depuis Pipedrive](/fr/articles/15516233-triggering-a-voiceagent-call-from-pipedrive.md)
- [Déclencher un appel VoiceAgent depuis Zendesk](/fr/articles/15934846-triggering-a-voiceagent-call-from-zendesk.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.