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

> Déclenchez des appels VoiceAgent CloudTalk directement depuis Salesforce à l'aide de Flow Builder et d'un HTTP Callout Apex

<Note>
  Vous pouvez déclencher automatiquement un appel VoiceAgent CloudTalk depuis Salesforce à l'aide de Flow Builder avec un HTTP Callout, appuyé par une classe Apex. Ce guide vous explique comment configurer la connexion, ajouter l'action d'appel et vérifier que l'appel a bien été lancé.
</Note>

**Niveau d'utilisateur :** Admin

***

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

Vous aurez besoin de :

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

* [Identifiants d'API CloudTalk](/fr/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) (Clé API et Secret)

* Salesforce Enterprise edition ou version supérieure (Flow Builder avec HTTP Callout)

* Un champ de téléphone disponible sur vos enregistrements Contact ou Lead, au format `E.164` (par exemple, `+14155550100`)

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

<h3 id="h_1a1932ad04">
  Créer le Named Credential
</h3>

Commencez par créer un External Credential afin de stocker votre clé API CloudTalk en toute sécurité :

1. Accédez à **Setup > Security > Named Credentials > External Credentials**.

2. Cliquez sur **New External Credential** :

   * **Label :** CloudTalk API

   * **Name :** CloudTalk\_API

   * **Authentication Protocol :** Basic

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/f42afbda40a0-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=9aa5faa95041ed98f83abc78b33f4f9c" alt="" width="909" height="284" data-path="images/help-center/articles/16064425/f42afbda40a0-image.png" />
   </Frame>

3. Cliquez sur **Save**, puis, sous **Principals**, cliquez sur **New** :

   * Choisissez un nom et définissez **Identity Type** sur **Named Principal**.

   * Saisissez votre **API Key ID** CloudTalk comme nom d'utilisateur et votre **API Secret** comme mot de passe.

   * Cliquez sur **Save**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/80d0479bd0d9-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=2bc7d38895a1ff4a48d88726ddb32479" alt="" width="899" height="864" data-path="images/help-center/articles/16064425/80d0479bd0d9-image.png" />
</Frame>

Créez ensuite le Named Credential qui pointe vers CloudTalk :

1. Accédez à **Setup > Security > Named Credentials > Named Credentials**.

2. Cliquez sur **New Named Credential** :

   * **Label :** CloudTalk

   * **Name :** CloudTalk

   * **URL :** `https://api.cloudtalk.io`

   * **External Credential :** CloudTalk API

   * Sous **Callout Options**, activez **Generate Authorization Header** et **Allow Formulas in HTTP Body**.

3. Cliquez sur **Save**.

Enfin, accordez-vous l'accès à ce credential :

1. Accédez à **Setup > Permission Sets**, ouvrez (ou créez) un permission set qui vous est attribué, puis allez dans **External Credential Principal Access > Edit**, ajoutez votre principal `CloudTalk_API` et cliquez sur **Save**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/3714caae4af3-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=3a0b3aa65e24b50345d6613885bb28fc" alt="" width="909" height="284" data-path="images/help-center/articles/16064425/3714caae4af3-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/f22a61ebe097-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=e91164bb89d61a0ec4f33a675a6b2775" alt="" width="899" height="864" data-path="images/help-center/articles/16064425/f22a61ebe097-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/c3209907f03c-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=c24c2ae14f775dec4986bc5ef012b629" alt="" width="899" height="460" data-path="images/help-center/articles/16064425/c3209907f03c-image.png" />
</Frame>

<h3 id="h_0c78cde929">
  Créer la classe Apex
</h3>

1. Accédez à **Setup > Apex Classes > New**.

2. Collez le code ci-dessous, remplacez `YOUR_VOICE_AGENT_ID` à la ligne 3 par l'ID de votre VoiceAgent, puis cliquez sur **Save**.

```
public with sharing class CloudTalkVoiceAgent {

    private static final String VOICE_AGENT_ID = 'YOUR_VOICE_AGENT_ID';

    @InvocableMethod(label='Start CloudTalk Voice Agent Call' description='Triggers a CloudTalk voice agent call')
    public static void invoke(List<Request> requests) {
        for (Request r : requests) {
            startCall(r.callNumber);
        }
    }

    @future(callout=true)
    public static void startCall(String callNumber) {
        HttpRequest req = new HttpRequest();
        req.setEndpoint('callout:CloudTalk/v1/voice-agent/calls');
        req.setMethod('POST');
        req.setHeader('Content-Type', 'application/json');
        req.setBody(JSON.serialize(new Map<String, Object>{
            'call_number'    => callNumber,
            'voice_agent_id' => VOICE_AGENT_ID
        }));
        HttpResponse res = new Http().send(req);
        System.debug('CloudTalk status: ' + res.getStatusCode());
    }

    public class Request {
        @InvocableVariable(label='Call Number' required=true)
        public String callNumber;
    }
}
```

<h3 id="h_8eb7a6f11f">
  Construire le Flow
</h3>

1. Accédez à **Setup > Process Automation > Flows > New Flow**.

2. Sélectionnez **Record-Triggered Flow**.

3. Configurez le déclencheur (Object : Contact ou Lead ; When : un enregistrement est créé ou un champ est modifié).

4. Ajoutez une condition pour filtrer les enregistrements, par exemple uniquement lorsque le champ de téléphone n'est pas vide.

5. Cliquez sur **+ > Action** et recherchez « Start CloudTalk Voice Agent Call ».

6. Définissez la valeur d'entrée **Call Number** sur `{!$Record.Phone}`.

7. Cliquez sur **Save**, puis sur **Activate** pour activer le Flow.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/be2af2a8b68a-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=3cb9bb48204255b2c370e1710c2691b2" alt="" width="971" height="767" data-path="images/help-center/articles/16064425/be2af2a8b68a-image.png" />
</Frame>

<Warning>
  `call_number` et `voice_agent_id` sont les seuls champs obligatoires. Vous pouvez éventuellement ajouter `call_properties`, comme des variables de prompt système (données que le VoiceAgent utilise pendant l'appel) et des variables de sortie (données renvoyées à votre endpoint après l'appel), selon la configuration de votre VoiceAgent. [Découvrez ce qu'il faut inclure](/fr/articles/11401649-voiceagents-for-outbound-calls).
</Warning>

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

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

2. Consultez **Setup > Debug Logs** ou les détails de l'interview du Flow 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 Flow Salesforce déclenchera désormais automatiquement un appel VoiceAgent CloudTalk dès qu'un enregistrement remplit les conditions que vous avez choisies.

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

* **Callout non autorisé :** assurez-vous que `api.cloudtalk.io` est ajouté dans Remote Site Settings.

* **401 Unauthorized :** vérifiez les identifiants enregistrés dans le principal de l'External Credential.

* **400 Bad Request :** vérifiez que le numéro de téléphone est au format E.164 (par exemple, `+14155550100`).

* **Le Flow ne se déclenche pas :** vérifiez que l'enregistrement remplit toutes les conditions d'entrée et que le Flow est actif.

***

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 Freshdesk](/fr/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)
- [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)


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