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

# Utiliser votre intégration Salesforce dans les requêtes HTTP des flux d'appels

> Appelez Salesforce depuis votre flux d'appels sans saisir d'identifiants, grâce à votre intégration Salesforce connectée.

<Note>
  L'étape **Requête HTTP** peut appeler directement votre org Salesforce. Lorsque le point de terminaison correspond à l'adresse de votre org Salesforce, CloudTalk signe la requête avec votre intégration Salesforce connectée : vous n'avez donc jamais à saisir d'identifiants Salesforce dans le flux d'appels.
</Note>

**Niveau d'utilisateur :** Admin

***

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

* Votre intégration Salesforce doit être connectée et active dans CloudTalk (**Dashboard** > **Intégrations**). Consultez [Configurer Salesforce](/fr/articles/3368501-configure-salesforce).

* Le point de terminaison doit utiliser le domaine propre à votre org, par exemple `https://yourcompany.my.salesforce.com/...`. Les autres adresses Salesforce, telles que `login.salesforce.com` ou Marketing Cloud, ne sont pas prises en charge.

* Vous devez savoir quel appel de l'API REST Salesforce vous souhaitez effectuer. La documentation de l'API Salesforce répertorie les points de terminaison disponibles.

<h2 id="h_sf_set_up">
  Configurer la requête
</h2>

1. Ajoutez une étape **Requête HTTP** à votre flux d'appels (voir le guide [Étape Requête HTTP](/fr/articles/6883940-http-request-step)).

2. Dans **Point de terminaison**, saisissez l'URL complète de l'API Salesforce sur le domaine de votre org.

3. Choisissez la **Méthode** et renseignez les **En-têtes de requête** et le **Corps de la requête** selon les exigences de l'API Salesforce. Pour un corps au format JSON, ajoutez l'en-tête `Content-Type: application/json`.

4. N'ajoutez pas d'en-tête Authorization. CloudTalk ajoute l'authentification pour vous à partir de l'intégration connectée.

5. Enregistrez le flux.

Chaque fois qu'un appel atteint cette étape, CloudTalk envoie la requête à Salesforce au nom de votre intégration. Vous pouvez utiliser des variables dynamiques telles que `#{{call.external_number}}` dans le point de terminaison, les en-têtes et le corps, exactement comme dans n'importe quelle étape Requête HTTP.

<h2 id="h_sf_example">
  Exemple : enregistrer un appel entrant comme tâche Salesforce
</h2>

<table>
  <tbody>
    <tr>
      <td>
        **Champ**
      </td>

      <td>
        **Valeur**
      </td>
    </tr>

    <tr>
      <td>
        **Point de terminaison**
      </td>

      <td>
        `https://yourcompany.my.salesforce.com/services/data/v58.0/sobjects/Task`
      </td>
    </tr>

    <tr>
      <td>
        **Méthode**
      </td>

      <td>
        POST
      </td>
    </tr>

    <tr>
      <td>
        **En-têtes**
      </td>

      <td>
        `Content-Type` = `application/json`
      </td>
    </tr>

    <tr>
      <td>
        **Corps**
      </td>

      <td>
        `Objet` = `Inbound call from #{{call.external_number}}`

        `Statut` = `Terminé`

        `Priorité` = `Normale`
      </td>
    </tr>

    <tr>
      <td>
        **Analyser la réponse**
      </td>

      <td>
        Désactivé (envoi sans attente de réponse)
      </td>
    </tr>
  </tbody>
</table>

<h2 id="h_sf_condition_splitter">
  Utiliser la réponse Salesforce dans un séparateur de condition
</h2>

Lorsque l'option **Analyser la réponse** est activée, la réponse de Salesforce est stockée comme un bloc unique. Dans un [Séparateur de condition](/fr/articles/5763009-caller-based-routing-with-conditions), vous pouvez :

* Vérifier le code de statut : sélectionnez **Réponse HTTP**, chemin `statusCode`, par exemple égal à `200`.

* Vérifier si la réponse contient une valeur : sélectionnez **Réponse HTTP**, chemin `body`, opérande **contient**.

<Tip>
  **Remarque :** la lecture d'un champ Salesforce précis dans la réponse (par exemple `records.0.Id`) n'est pas prise en charge pour le moment.
</Tip>

<h2 id="h_sf_not_available">
  Si l'intégration n'est pas disponible
</h2>

Si votre intégration Salesforce est désactivée, n'est pas connectée ou si le point de terminaison ne correspond pas à l'org à laquelle elle est connectée, la requête n'est pas envoyée à Salesforce. L'étape est consignée comme ayant échoué et le flux d'appels passe à l'étape suivante. Les appelants ne sont pas affectés.

<h2 id="h_sf_good_to_know">
  Bon à savoir
</h2>

* La communication doit se faire en HTTPS.

* Lorsque l'option Analyser la réponse est activée, le flux attend jusqu'à 10 secondes la réponse de Salesforce. Lorsqu'elle est désactivée, la requête est envoyée et le flux continue au bout de 3 secondes au maximum.

* Les requêtes sont décomptées de vos limites d'API Salesforce, comme n'importe quel autre appel d'API.

***

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


## Related topics

- [Étape Requête HTTP](/fr/articles/6883940-http-request-step.md)
- [Questionnaire post-appel](/fr/articles/8200861-post-call-survey.md)
- [Configurer Salesforce](/fr/articles/3368501-configure-salesforce.md)


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