> ## 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 unterstützen Ihre Agenten, indem sie aktuelle Informationen wie Kundenhistorie, Deal-Status oder individuelle Anrufskripte anzeigen.

<Note>
  Diese Anleitung erklärt die Einrichtung von Cue Cards in CloudTalk, damit Ihre Agenten während der Anrufe Kundendaten, Skripte oder Dokumente in Echtzeit sehen.
</Note>

**Benutzerebene:** Admin

***

<h2 id="h_efa5c36012">
  So funktionieren Cue Cards
</h2>

Wenn ein Anruf beginnt, löst CloudTalk eine **Workflow-Automatisierung** aus, die die eindeutige Kennung des Anrufs (Call UUID) an Ihr externes System (CRM, Zapier oder ein eigenes Backend) sendet.

Ihr externes System:

1. verwendet die UUID, um die passenden Kunden- oder Geschäftsdaten nachzuschlagen.

2. bereitet diese Daten im richtigen Format auf (HTML oder Blocks).

3. sendet die Daten über die [Cue Cards API](/api-reference/cuecard/create-cuecard) zurück an CloudTalk.

CloudTalk zeigt diese Daten dem Agenten sofort in CloudTalk Phone an.

<Warning>
  Cue Cards sind in der **CloudTalk Web-App, der Desktop-App und in CTI-Integrationen** verfügbar. Sie werden **in der mobilen App CloudTalk Go nicht unterstützt**.
</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">
  Einrichtungsablauf
</h2>

<h3 id="h_463877e4a2">
  Workflow-Automatisierung in CloudTalk konfigurieren
</h3>

1. Gehen Sie in Ihrem CloudTalk Dashboard zu **[Workflow-Automatisierungen](/de/articles/5450779-configuring-workflow-automations)**.

2. Klicken Sie auf **+ Workflow hinzufügen**.

3. Wählen Sie den **Trigger** aus:

   * Objekt: `Anruf`

   * Aktion: `Beantwortet` (oder `Gestartet`, je nach Anwendungsfall)

     <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. (Optional) Fügen Sie **Bedingungen** hinzu, z. B.:

   * Nur bei eingehenden Anrufen anzeigen → `#{{ Call_direction == "Inbound" }}`

   * VIP-Tags, bestimmte Länder oder ausgewählte Agenten/Gruppen

5. Fügen Sie eine **Aktion** hinzu: API-Anfrage.

   * Methode: `POST`

   * Endpunkt: URL Ihres externen Systems (z. B. Zapier-Webhook oder CRM-API).

   * Header: z. B. `Content-Type: application/json`

   * Werte: `call_uuid` → `#{{ Call_uuid }}` einfügen

<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 sendet nun die Call UUID an Ihr externes System, sobald ein passender Anruf beantwortet wird.

<h3 id="h_46eb3ecff1">
  Logik in Ihrem externen Tool konfigurieren
</h3>

Ihr externes Tool (CRM, Zapier oder ein eigenes Backend) muss vier Schritte abdecken:

1. **Die Anfrage von CloudTalk empfangen**

   * Die CloudTalk Workflow-Automatisierung sendet einen HTTP-POST an den von Ihnen angegebenen Endpunkt.

   * Die Anfrage enthält mindestens die `call_uuid` sowie alle weiteren von Ihnen konfigurierten Werte.

2. **Die anzuzeigenden Daten nachschlagen**

   * Rufen Sie beispielsweise das CRM-Profil des Anrufers, die letzte Bestellung oder ein Anrufskript aus Ihrer Datenbank ab.

3. **Das Cue-Card-Payload erstellen**

   * Formatieren Sie die Antwort entweder als:

     * **HTML** (einfacher Text/Links) oder

     * **Blocks** (strukturierte Felder wie Textfelder, Links, Bilder oder Dateien).

4. **Das Payload zurück an CloudTalk senden**

   * Senden Sie eine POST-Anfrage an die [Cue Cards API](/api-reference/cuecard/create-cuecard) mit:

     * `call_uuid` (zur Zuordnung des richtigen Anrufs)

     * `type` (`html` oder `blocks`)

     * `content` (die Daten, die angezeigt werden sollen)

Sobald CloudTalk das Payload erhält, erscheint die Cue Card sofort im Panel des Agenten.

<h3 id="h_5be3701868">
  Beispiel-Einrichtung in CloudTalk (mit Zapier)
</h3>

Hier ein vereinfachtes Beispiel, wie Sie CloudTalk Workflow-Automatisierungen mit Zapier verbinden können, um Cue Cards anzuzeigen:

**In CloudTalk (Schritt 1)**

* Erstellen Sie eine Workflow-Automatisierung mit **Trigger = Anruf beantwortet**.

* Fügen Sie eine **Aktion „API-Anfrage"** hinzu, die auf Ihre Zapier-Webhook-URL verweist.

* Senden Sie den folgenden Wert:

  * `call_uuid → #{{ Call_uuid }}`

**In Zapier (Schritt 2)**

* **Catch Webhook**: Zapier empfängt den `POST` von CloudTalk mit der `call_uuid`.

* **Daten nachschlagen**: Nutzen Sie Zapier-Schritte (z. B. CRM-Datensätze durchsuchen oder Daten aus einer Datenbank abrufen).

* **Cue-Card-Payload formatieren**: Erstellen Sie einen JSON-Body für die Cue Cards API, zum Beispiel:

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

**An die CloudTalk API senden (Schritt 3)**

* Verwenden Sie einen Zapier-Webhook-Schritt **`POST`**.

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

* Header:

  * `Content-Type: application/json`

  * `Authorization: Bearer <YOUR_API_KEY>`

* Body: das von Ihnen vorbereitete Cue-Card-JSON.

Wenn der Anruf beantwortet wird, schlägt Zapier die Daten nach, erstellt das Payload, und CloudTalk zeigt dem Agenten die Cue Card sofort an.

***

*Brauchen Sie Hilfe oder haben Sie eine Frage?* Melden Sie sich einfach über unser [Support-Portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — wir sind für Sie da.


## Related topics

- [So nutzen Sie WhatsApp mit CloudTalk](/de/articles/6811232-how-to-use-whatsapp-with-cloudtalk.md)
- [WhatsApp sendet oder empfängt keine Nachrichten](/de/articles/13333950-whatsapp-not-sending-or-receiving-messages.md)
- [Lokale Rufnummern in den Vereinigten Arabischen Emiraten erhalten](/de/articles/11397627-getting-local-numbers-in-the-united-arab-emirates.md)


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