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

> Cue Cards helpen uw agenten door actuele gegevens te tonen, zoals klanthistorie, dealstatus of aangepaste gespreksscripts.

<Note>
  In deze handleiding leest u hoe u Cue Cards in CloudTalk instelt, zodat uw agenten tijdens gesprekken realtime klantgegevens, scripts of documenten zien.
</Note>

**Gebruikersniveau:** Admin

***

<h2 id="h_efa5c36012">
  Hoe Cue Cards werken
</h2>

Wanneer een gesprek begint, activeert CloudTalk een **Workflow-automatisering** die de unieke identificatie van het gesprek (Call UUID) naar uw externe systeem (CRM, Zapier of een eigen backend) stuurt.

Uw externe systeem doet vervolgens het volgende:

1. Gebruikt de UUID om relevante klant- of bedrijfsgegevens op te zoeken.

2. Bereidt deze gegevens voor in het juiste formaat (HTML of Blocks).

3. Stuurt de gegevens terug naar CloudTalk via de [Cue Cards API](/api-reference/cuecard/create-cuecard).

CloudTalk toont deze gegevens direct aan de agent in CloudTalk Phone.

<Warning>
  Cue Cards zijn beschikbaar in de **CloudTalk-webapp, de desktopapp en CTI-integraties**. Ze worden **niet ondersteund in de mobiele app 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">
  Configuratieproces
</h2>

<h3 id="h_463877e4a2">
  Workflow-automatisering configureren in CloudTalk
</h3>

1. Ga in uw CloudTalk Dashboard naar **[Workflowautomatiseringen](/nl/articles/5450779-configuring-workflow-automations)**.

2. Klik op **+ Workflow toevoegen**.

3. Selecteer **Trigger**:

   * Object: `Oproep doen`

   * Actie: `Beantwoord` (of `Gestart`, afhankelijk van uw use case)

     <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. (Optioneel) Voeg **condities** toe, bijvoorbeeld:

   * Alleen tonen bij inkomende oproepen → `#{{ Call_direction == "Inbound" }}`

   * VIP-tags, specifieke landen of geselecteerde agenten/groepen

5. Voeg een **Actie** toe: API Request.

   * Methode: `POST`

   * Endpoint: de URL van uw externe systeem (bijvoorbeeld een Zapier-webhook of een CRM-API).

   * Headers: bijvoorbeeld `Content-Type: application/json`

   * Waarden: neem `call_uuid` → `#{{ Call_uuid }}` op

<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 stuurt de Call UUID nu naar uw externe systeem zodra een overeenkomend gesprek wordt beantwoord.

<h3 id="h_46eb3ecff1">
  De logica in uw externe tool configureren
</h3>

Uw externe tool (CRM, Zapier of een eigen backend) moet vier stappen afhandelen:

1. **Het verzoek van CloudTalk ontvangen**

   * De CloudTalk Workflow-automatisering stuurt een HTTP POST naar het endpoint dat u opgeeft.

   * Het verzoek bevat ten minste de `call_uuid` en eventuele andere waarden die u hebt geconfigureerd.

2. **De gegevens opzoeken die u wilt tonen**

   * Haal bijvoorbeeld het CRM-profiel of de recente bestelling van de beller op, of haal een gespreksscript uit uw database.

3. **De Cue Card-payload opbouwen**

   * Maak de respons op als:

     * **HTML** (eenvoudige tekst/links), of

     * **Blocks** (gestructureerde velden zoals textfields, links, afbeeldingen of bestanden).

4. **De payload terugsturen naar CloudTalk**

   * Doe een POST-verzoek naar de [Cue Cards API](/api-reference/cuecard/create-cuecard) met daarin:

     * `call_uuid` (om het juiste gesprek te koppelen)

     * `type` (`html` of `blocks`)

     * `content` (de gegevens die u wilt tonen)

Zodra CloudTalk de payload ontvangt, verschijnt de Cue Card direct in het paneel van de agent.

<h3 id="h_5be3701868">
  Voorbeeldconfiguratie in CloudTalk (met Zapier)
</h3>

Hier ziet u een vereenvoudigd voorbeeld van hoe u CloudTalk Workflowautomatiseringen met Zapier kunt verbinden om Cue Cards te tonen:

**In CloudTalk (stap 1)**

* Maak een Workflow-automatisering met **Trigger = Oproep doen / Beantwoord**.

* Voeg een **API Request-actie** toe die naar uw Zapier Webhook-URL verwijst.

* Stuur de volgende waarde:

  * `call_uuid → #{{ Call_uuid }}`

**In Zapier (stap 2)**

* **Catch Webhook**: Zapier ontvangt de `POST` van CloudTalk met de `call_uuid`.

* **Gegevens opzoeken**: gebruik Zapier-stappen (bijvoorbeeld CRM-records doorzoeken of gegevens uit een database ophalen).

* **Cue Card-payload opmaken**: bouw een JSON-body voor de Cue Card API, bijvoorbeeld:

```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"
    }
  ]
}
```

**Naar de CloudTalk API sturen (stap 3)**

* Gebruik een Zapier Webhook **`POST`**-stap.

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

* Headers:

  * `Content-Type: application/json`

  * `Authorization: Bearer <YOUR_API_KEY>`

* Body: de Cue Card-JSON die u hebt voorbereid.

Wanneer het gesprek wordt beantwoord, zoekt Zapier de gegevens op, bouwt de payload op en toont CloudTalk de Cue Card direct aan de agent.

***

*Hulp nodig of een vraag?* Neem gerust contact met ons op via ons [Supportportaal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we staan voor u klaar.


## Related topics

- [WhatsApp gebruiken met CloudTalk](/nl/articles/6811232-how-to-use-whatsapp-with-cloudtalk.md)
- [WhatsApp verzendt of ontvangt geen berichten](/nl/articles/13333950-whatsapp-not-sending-or-receiving-messages.md)
- [Gids voor workflowautomatiseringen](/nl/articles/10568412-workflow-automations-guide.md)


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