> ## 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 Freshservice

> Automatisez les appels sortants des VoiceAgents directement depuis Freshservice

<Note>
  Dans ce guide, vous allez apprendre à déclencher automatiquement un appel VoiceAgent CloudTalk depuis Freshservice à l'aide du Workflow Automator.
</Note>

**Niveau d'utilisateur** : Administrateur

***

<Warning>
  **Remarque :** Utilisez le **Web Request Node**, et non le nœud Trigger Webhook. Le Web Request Node attend la réponse de l'API et prend en charge l'analyse des réponses JSON, ce qui vous permet de détecter les erreurs. Le nœud Trigger Webhook fonctionne en mode « envoyer et oublier » et ne confirme pas la réussite.
</Warning>

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

Vous aurez besoin de :

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

* Des 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 Freshservice **Pro** ou supérieur

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

<h2 id="h_credentials">
  Trouver vos identifiants CloudTalk
</h2>

Le Web Request Node dispose d'un formulaire Basic Auth intégré : aucun encodage préalable n'est nécessaire.

1. Dans CloudTalk, accédez à **Paramètres de l'entreprise > Intégrations > API**

2. Notez votre **ID de clé API** — il servira de Username

3. Notez votre **secret API** — il servira de Password

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

<h3 id="h_create_workflow">
  Créer le workflow
</h3>

1\. Dans Freshservice, accédez à **Admin > Workflow Automator**

2\. Cliquez sur **Create > Workflow**

3\. Définissez l'**Event trigger**, par exemple :

* *Ticket raised*

* *Ticket updated* (le statut passe à Pending)

* *Requester replies*

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15502021/cfe5ebee1bfc-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=256f95008b25fbab2b0b2bbe4c572d8c" alt="" width="583" height="361" data-path="images/help-center/articles/15502021/cfe5ebee1bfc-image.png" />
</Frame>

4\. Ajoutez des **conditions** pour filtrer les tickets qui déclenchent l'appel (par exemple : le téléphone du demandeur est renseigné, une catégorie spécifique)

<h3 id="h_web_request">
  Ajouter le Web Request Node
</h3>

1\. Cliquez sur **`+`** pour ajouter un bloc d'action

2\. Sélectionnez **Web Request Node**

3\. Configurez le nœud :

| **Champ** | **Valeur** |
| - | - |
| Request type | POST |
| Endpoint | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Credentials | Inline Credential |
| Authentication | Basic Auth |
| Username | L'ID de votre clé API CloudTalk |
| Password | Votre secret API CloudTalk |
| Headers | `Content-Type`: `application/json` |

4\. Sous **Request body**, collez ce qui suit :

```json theme={"system"}
{  "call_number": "#{{ticket.requester.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` facultatives, comme des variables du 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/15502021/bd0f895867f5-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=ab3441168ef857eb20660f388de7dc13" alt="" width="581" height="685" data-path="images/help-center/articles/15502021/bd0f895867f5-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15502021/f00064942f5b-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6d8c792ec9cf6d9a0fa081cb3da4045a" alt="" width="561" height="608" data-path="images/help-center/articles/15502021/f00064942f5b-image.png" />
</Frame>

5\. Reliez le nœud au déclencheur et cliquez sur **Activate**

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

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

2. Ouvrez **Workflow Automator** et consultez l'historique des exécutions

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

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

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

  *Pour é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.*
</Info>

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

| **Erreur** | **Que vérifier** |
| - | - |
| **401 Unauthorized** | Régénérez vos identifiants d'API et saisissez-les à nouveau dans les champs Basic Auth |
| **400 Bad Request** | Assurez-vous que le numéro de téléphone est au format E.164 (`+1234567890`) et que `voice_agent_id` est correct |
| **Le workflow ne se déclenche pas** | Vérifiez que les conditions de l'événement correspondent à votre ticket de test et que le workflow est activé |

***

Besoin d'aide ou 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 Freshdesk](/fr/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.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.