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

# Cue Cards

> Les Cue Cards aident vos agents en affichant des informations à jour, comme l'historique du client, le statut de l'affaire ou des scripts d'appel personnalisés.

<Note>
  Ce guide explique comment configurer les Cue Cards dans CloudTalk afin que vos agents voient en temps réel les informations client, les scripts ou les documents pendant les appels.
</Note>

**Niveau utilisateur :** Admin

***

<h2 id="h_efa5c36012">
  Fonctionnement des Cue Cards
</h2>

Lorsqu'un appel démarre, CloudTalk déclenche une **Automatisation des flux de travail** qui envoie l'identifiant unique de l'appel (Call UUID) à votre système externe (CRM, Zapier ou backend personnalisé).

Votre système externe :

1. Utilise l'UUID pour retrouver les données client ou métier pertinentes.

2. Prépare ces données au bon format (HTML ou Blocks).

3. Renvoie les données à CloudTalk via l'[API Cue Cards](/api-reference/cuecard/create-cuecard).

CloudTalk affiche immédiatement ces données à l'agent dans CloudTalk Phone.

<Warning>
  Les Cue Cards sont disponibles dans l'**application Web CloudTalk, l'application de bureau et les intégrations CTI**. Elles ne sont **pas prises en charge dans l'application mobile CloudTalk Go**.
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0LuB-WYxwheF-8cl/images/help-center/articles/11154936/f7c6162fdd45-product-knowledge-faq-uploads3cbf0d3c-d79d-41ed-90e2-00c4f8d.png?fit=max&auto=format&n=0LuB-WYxwheF-8cl&q=85&s=8c5dadd8f0443ecfce587e2e45660e0d" alt="" width="300" data-path="images/help-center/articles/11154936/f7c6162fdd45-product-knowledge-faq-uploads3cbf0d3c-d79d-41ed-90e2-00c4f8d.png" />
</Frame>

<h2 id="h_0d54f1f5dd">
  Procédure de configuration
</h2>

<h3 id="h_463877e4a2">
  Configurer l'Automatisation des flux de travail dans CloudTalk
</h3>

1. Dans votre CloudTalk Dashboard, accédez à **[Automatisations des flux de travail](/fr/articles/5450779-configuring-workflow-automations)**.

2. Cliquez sur **+ Ajouter un workflow**.

3. Sélectionnez le **Déclencheur** :

   * Objet : `Appeler`

   * Action : `Répondu` (ou `Commencé`, selon votre cas d'usage)

     <Frame>
       <img src="https://mintcdn.com/cloudtalk/0LuB-WYxwheF-8cl/images/help-center/articles/11154936/de0eaa0ab98e-screenshot-2025-04-29-at-13-16-20.png?fit=max&auto=format&n=0LuB-WYxwheF-8cl&q=85&s=0039d3d5585dbc3d452184509d29687d" alt="" width="500" data-path="images/help-center/articles/11154936/de0eaa0ab98e-screenshot-2025-04-29-at-13-16-20.png" />
     </Frame>

4. (Facultatif) Ajoutez des **Conditions**, par ex. :

   * Afficher uniquement pour les appels entrants → `#{{ Call_direction == "Inbound" }}`

   * Étiquettes VIP, pays spécifiques ou agents/groupes sélectionnés

5. Ajoutez une **Action** : Requête API.

   * Méthode : `POST`

   * Point de terminaison : URL de votre système externe (par ex. un webhook Zapier ou une API CRM).

   * En-têtes : par ex. `Content-Type: application/json`

   * Valeurs : incluez `call_uuid` → `#{{ Call_uuid }}`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0LuB-WYxwheF-8cl/images/help-center/articles/11154936/a1212237907a-screenshot-2025-04-29-at-14-47-14.png?fit=max&auto=format&n=0LuB-WYxwheF-8cl&q=85&s=ea3ec40830b120b9d35ea9578b832f00" alt="" width="500" data-path="images/help-center/articles/11154936/a1212237907a-screenshot-2025-04-29-at-14-47-14.png" />
</Frame>

CloudTalk envoie désormais le Call UUID à votre système externe lorsqu'un appel correspondant est répondu.

<h3 id="h_46eb3ecff1">
  Configurer la logique dans votre outil externe
</h3>

Votre outil externe (CRM, Zapier ou backend personnalisé) doit gérer quatre étapes :

1. **Recevoir la requête de CloudTalk**

   * L'Automatisation des flux de travail de CloudTalk envoie une requête HTTP POST au point de terminaison que vous indiquez.

   * La requête contient au minimum le `call_uuid` ainsi que toutes les autres valeurs que vous avez configurées.

2. **Rechercher les données à afficher**

   * Par exemple, récupérez la fiche CRM de l'appelant, sa dernière commande ou un script d'appel depuis votre base de données.

3. **Construire le payload de la Cue Card**

   * Formatez la réponse dans l'un de ces formats :

     * **HTML** (texte/liens simples), ou

     * **Blocks** (champs structurés comme des champs de texte, des liens, des images ou des fichiers).

4. **Renvoyer le payload à CloudTalk**

   * Effectuez une requête POST vers l'[API Cue Cards](/api-reference/cuecard/create-cuecard) en incluant :

     * `call_uuid` (pour associer le bon appel)

     * `type` (`html` ou `blocks`)

     * `content` (les données à afficher)

Dès que CloudTalk reçoit le payload, la Cue Card apparaît instantanément dans le panneau de l'agent.

<h3 id="h_5be3701868">
  Exemple de configuration dans CloudTalk (avec Zapier)
</h3>

Voici un exemple simplifié de la façon dont vous pouvez connecter les Automatisations des flux de travail de CloudTalk à Zapier pour afficher des Cue Cards :

**Dans CloudTalk (étape 1)**

* Créez une Automatisation des flux de travail avec **Déclencheur = Appeler Répondu**.

* Ajoutez une **Action Requête API** pointant vers l'URL de votre webhook Zapier.

* Envoyez la valeur suivante :

  * `call_uuid → #{{ Call_uuid }}`

**Dans Zapier (étape 2)**

* **Catch Webhook** : Zapier reçoit le `POST` de CloudTalk avec le `call_uuid`.

* **Rechercher les données** : utilisez des étapes Zapier (par ex. rechercher des enregistrements CRM ou récupérer des données depuis une base de données).

* **Formater le payload de la Cue Card** : construisez un corps JSON pour l'API Cue Cards, par exemple :

```json theme={"system"}
{
  "call_uuid": "#{{Call_uuid}}",
  "type": "blocks",
  "content": [
    {
      "type": "textfield",
      "name": "Customer Name",
      "value": "Jane Smith"
    },
    {
      "type": "richtext",
      "name": "Script No. 123",
      "value": "Hello Jane, thank you for calling!"
    },
    {
      "type": "link",
      "name": "Profile",
      "url": "https://crm.example.com/clients/123"
    }
  ]
}
```

**Envoi vers l'API CloudTalk (étape 3)**

* Utilisez une étape Webhook Zapier **`POST`**.

* Point de terminaison : [`https://platform-api.cloudtalk.io/api/cuecards`](https://platform-api.cloudtalk.io/api/cuecards)

* En-têtes :

  * `Content-Type: application/json`

  * `Authorization: Bearer <YOUR_API_KEY>`

* Corps : le JSON de la Cue Card que vous avez préparé.

Lorsque l'appel est répondu, Zapier recherche les données, construit le payload et CloudTalk affiche instantanément la Cue Card à l'agent.

***

*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

- [Comment utiliser WhatsApp avec CloudTalk](/fr/articles/6811232-how-to-use-whatsapp-with-cloudtalk.md)
- [WhatsApp n'envoie ni ne reçoit de messages](/fr/articles/13333950-whatsapp-not-sending-or-receiving-messages.md)


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