Cue Cards

​

Hoe Cue Cards werken

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.

​

Configuratieproces

​

Workflow-automatisering configureren in CloudTalk

1. Ga in uw CloudTalk Dashboard naar Workflowautomatiseringen.
2. Klik op + Workflow toevoegen.
3. Selecteer Trigger:
   • Object: Oproep doen
   • Actie: Beantwoord (of Gestart, afhankelijk van uw use case)
     
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

​

De logica in uw externe tool configureren

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 met daarin:
     • call_uuid (om het juiste gesprek te koppelen)
     • type (html of blocks)
     • content (de gegevens die u wilt tonen)

​

Voorbeeldconfiguratie in CloudTalk (met Zapier)

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

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

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

• Gebruik een Zapier Webhook POST-stap.
• Endpoint: 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.