Cue Cards

​

So funktionieren Cue Cards

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 zurück an CloudTalk.

​

Einrichtungsablauf

​

Workflow-Automatisierung in CloudTalk konfigurieren

1. Gehen Sie in Ihrem CloudTalk Dashboard zu Workflow-Automatisierungen.
2. Klicken Sie auf + Workflow hinzufügen.
3. Wählen Sie den Trigger aus:
   • Objekt: Anruf
   • Aktion: Beantwortet (oder Gestartet, je nach Anwendungsfall)
     
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

​

Logik in Ihrem externen Tool konfigurieren

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 mit:
     • call_uuid (zur Zuordnung des richtigen Anrufs)
     • type (html oder blocks)
     • content (die Daten, die angezeigt werden sollen)

​

Beispiel-Einrichtung in CloudTalk (mit Zapier)

• 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 }}

• 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:

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

• Verwenden Sie einen Zapier-Webhook-Schritt POST.
• Endpunkt: 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.