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

# Étape Requête HTTP

> Configurez l'échange de données dans le CFD pour un routage des appels plus intelligent, piloté par les données.

<Note>
  L'étape **Requête HTTP** vous permet de connecter vos flux d'appels CloudTalk à des systèmes et API externes. Dans ce guide, vous apprendrez à configurer et à utiliser l'étape Requête HTTP pour envoyer des requêtes, traiter les réponses et intégrer des données externes directement dans vos flux d'appels.
</Note>

**Niveau d'utilisateur :** Admin

***

<h2 id="h_535647b013">
  Utiliser une étape Requête HTTP
</h2>

L'étape **Requête HTTP** vous permet d'étendre vos flux d'appels au-delà de CloudTalk en vous connectant à des systèmes et API externes. Elle rend possibles l'échange de données, l'automatisation et la prise de décision en temps réel pendant un appel.

Que vous enrichissiez les données d'appel, mettiez à jour des enregistrements externes ou personnalisiez l'expérience client, l'étape Requête HTTP vous donne la souplesse nécessaire pour créer des flux de travail plus intelligents et mieux connectés.

<h3 id="h_0e85528647">
  Ajouter une Requête HTTP à votre flux d'appels
</h3>

1. Depuis le **Dashboard**, cliquez sur **Numéros**.

2. Dans l'onglet **Mes numéros**, trouvez le numéro que vous souhaitez configurer.

3. Cliquez sur **+ Configurer** (ou sur le nom du flux, s'il en existe un) dans la colonne **Flux d'appels**.

4. Sur le canevas, cliquez sur le bouton **`+`** à l'endroit où vous voulez placer l'étape.

5. Dans la bibliothèque d'étapes, sous **Automatisation**, sélectionnez **Requête HTTP**.

<h3 id="h_0104eecf35">
  Configurer les requêtes HTTP
</h3>

6\. Cliquez sur l'étape Requête HTTP dans le canevas pour ouvrir son panneau de configuration. Les éléments suivants sont disponibles :

<h4 id="h_a1bf5cf058">
  Endpoint
</h4>

L'endpoint définit l'URL à appeler. La communication nécessite HTTPS.

<h4 id="h_7725891ee3">
  Méthode
</h4>

La méthode de la requête HTTP, c'est-à-dire le type d'action que le destinataire de l'endpoint est invité à effectuer. Options disponibles : **GET**, **POST**, **PUT**, **PATCH**, **DELETE**.

<h4 id="h_d768b9c724">
  En-têtes de la requête (facultatif)
</h4>

Les en-têtes de requête fournissent des méta-informations sur la requête, comme le format du corps de la requête ou les identifiants d'autorisation.

Cliquez sur **Ajouter** pour définir des en-têtes supplémentaires. Le type d'en-têtes dépend de l'API externe à laquelle vous vous connectez.

<h4 id="h_fea696e64e">
  Corps de la requête
</h4>

Le corps de la requête est la charge utile envoyée avec la requête. Cliquez sur **Ajouter** pour définir des paires clé-valeur en tant qu'attributs de données. Vous pouvez également cliquer sur **Ajouter un champ personnalisé de contact** pour insérer directement des données de contact.

Le corps de la requête est envoyé au format JSON (par exemple : `{"key1":"value1", "key2":"value2"}`).

Outre des valeurs constantes, vous pouvez utiliser les variables dynamiques suivantes :

**Attributs d'appel :**

| **Variable** | **Description** |
| - | - |
| `#{{call.external_number}}` | Numéro de l'appelant au format E.164 (par ex. +10005555555) |
| `#{{call.waiting_time}}` | Temps en secondes entre le début de l'appel et la prise en charge par l'agent |
| `#{{call.uuid}}` | Identifiant unique de l'appel |
| `#{{call.agent_id}}` | ID de l'agent (uniquement sur une branche répondue, renvoie null sinon) |
| `#{{call.agent_email}}` | E-mail de l'agent (uniquement sur une branche répondue, renvoie null sinon) |

**Attributs de contact :**

| **Variable** | **Description** |
| - | - |
| `#{{contact.name}}` | Nom du contact |
| `#{{contact.id}}` | ID du contact |
| `#{{contact.title}}` | Titre du contact |
| `#{{contact.company}}` | Entreprise du contact |
| `#{{contact.industry}}` | Secteur d'activité du contact |
| `#{{contact.address}}` | Adresse du contact |
| `#{{contact.city}}` | Ville du contact |
| `#{{contact.zip}}` | Code postal du contact |
| `#{{contact.state}}` | État du contact |
| `#{{contact.type}}` | Renvoie « contact » ou « lead » |
| `#{{contact.tags}}` | Renvoie le tableau des étiquettes attribuées (par ex. `["Vip", "CampaignA"]`) |
| `#{{contact.custom_fields["field_name"]}}` | Valeur d'un champ personnalisé (par ex. `#{{contact.custom_fields["MRR"]}}`) |
| `#{{contact.emails}}` | Renvoie le tableau des e-mails du contact |
| `#{{contact.emails[0]}}` | Renvoie le premier e-mail du tableau |

**Collecte de saisie :**

| **Variable** | **Description** |
| - | - |
| `#{{input[step_id].value}}` | Valeur saisie par l'appelant lors d'une étape Collecte de saisie. Remplacez *step\_id* par l'ID de l'étape Collecte de saisie (par ex. `#{{input[389008].value}}`). |

<Warning>
  **Astuce :** enregistrez votre flux avant de référencer un ID d'étape. Avant l'enregistrement, les étapes portent des ID négatifs temporaires qui peuvent ne pas fonctionner correctement. Après l'enregistrement, l'ID de l'étape devient un nombre positif permanent.
</Warning>

<Tip>
  **Remarque :** la Collecte de saisie peut renvoyer une valeur vide si l'appelant n'a rien saisi. Lors de la création initiale, vous pouvez utiliser l'ID temporaire ; il sera remplacé une fois le flux enregistré.
</Tip>

<h3 id="h_7e82174a72">
  Options d'imbrication
</h3>

Si un endpoint externe exige des objets imbriqués, utilisez la notation par points dans le champ Clé : `key.subkey`.

Par exemple :

* `customer.firstname` = John

* `customer.lastname` = Doe

Donne : `{ "customer": { "firstname": "John", "lastname": "Doe" }}`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Ayep-6hjQnBpSGZo/images/help-center/articles/6883940/077a7c92f065-screenshot-2026-08-18-at-11-39-01.png?fit=max&auto=format&n=Ayep-6hjQnBpSGZo&q=85&s=a748961395ac547915cf1ddd2a33dda6" alt="" width="1895" height="1331" data-path="images/help-center/articles/6883940/077a7c92f065-screenshot-2026-08-18-at-11-39-01.png" />
</Frame>

***

<h3 id="h_5e7c90d4d4">
  Analyser la réponse
</h3>

La case **Analyser la réponse** définit la manière dont CloudTalk traite les données reçues du système externe.

* **Lorsqu'elle est désactivée**

  Le flux d'appels se poursuit immédiatement après l'envoi de la requête, sans attendre de réponse. Utile pour les requêtes « envoyer et oublier » lorsque les données de la réponse ne sont pas nécessaires.

- **Lorsqu'elle est activée**

  Le flux d'appels attend la réponse HTTP avant de continuer. Les données renvoyées sont alors disponibles pour les étapes suivantes.

<h3 id="h_4ded083405">
  Conserver les données après l'appel
</h3>

Cochez **Conserver les données après l'appel** pour que les données de la réponse HTTP restent disponibles une fois l'appel terminé. C'est utile si vous avez besoin de ces données pour un traitement ou un reporting après l'appel.

***

<h2 id="h_d637dad6fb">
  Utiliser la réponse dans les étapes suivantes
</h2>

Lorsque l'option Analyser la réponse est activée, le corps de la réponse peut être utilisé dans un [Séparateur de condition](/fr/articles/5763009-caller-based-routing-with-conditions) afin de router les appels en fonction des données renvoyées.

Dans la configuration du Séparateur de condition :

1\. Sélectionnez **Réponse HTTP** dans la liste déroulante **Propriété**. Elle affiche l'URL de l'endpoint de l'étape Requête HTTP (par ex. « Réponse HTTP - [https://api.example.com/customer](https://api.example.com/customer) ») afin que vous sachiez à quelle requête elle fait référence.

2\. Saisissez le **chemin JSON** vers la propriété de la réponse en utilisant la notation par points.

**Exemple :** si la réponse ressemble à ceci :

```json theme={"system"}
{
  "status": "success",
  "error": {
    "code": 200,
    "message": "OK"
  }
}
```

* Pour référencer la propriété de premier niveau *status*, utilisez : `status`

* Pour référencer la propriété imbriquée *error code*, utilisez : `error.code`

* Pour les propriétés indexées (liste ou tableau), utilisez la notation par points avec le numéro d'index : `status.0` pour le premier élément, `status.1` pour le deuxième, et ainsi de suite.

3\. Définissez la condition souhaitée (**Opérande** et **Valeur**) en fonction de ce que vous voulez faire correspondre.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Ayep-6hjQnBpSGZo/images/help-center/articles/6883940/6fbeb2f5bd19-screenshot-2026-08-18-at-11-50-32.png?fit=max&auto=format&n=Ayep-6hjQnBpSGZo&q=85&s=79e6c5ab41bef0bd969cd97635c47ad9" alt="" width="1552" height="1323" data-path="images/help-center/articles/6883940/6fbeb2f5bd19-screenshot-2026-08-18-at-11-50-32.png" />
</Frame>

Avec cette configuration, chaque fois qu'un appel atteint l'étape Requête HTTP, une requête est envoyée au système externe. Les données de la réponse déterminent ensuite le chemin de routage suivant de l'appel, ce qui permet de traiter chaque appel de façon dynamique à partir des informations les plus à jour.

***

*Besoin d'aide ou une question ?* Écrivez-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

- [Utiliser votre intégration Salesforce dans les requêtes HTTP des flux d'appels](/fr/articles/16941452-using-your-salesforce-integration-in-call-flow-http-requests.md)
- [Étape Collecter l'entrée de l'appelant](/fr/articles/5878950-collect-input-from-caller-step.md)
- [Questionnaire post-appel](/fr/articles/8200861-post-call-survey.md)


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