Cue Cards

​

Fonctionnement des Cue Cards

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.

​

Procédure de configuration

​

Configurer l’Automatisation des flux de travail dans CloudTalk

1. Dans votre CloudTalk Dashboard, accédez à Automatisations des flux de travail.
2. Cliquez sur + Ajouter un workflow.
3. Sélectionnez le Déclencheur :
   • Objet : Appeler
   • Action : Répondu (ou Commencé, selon votre cas d’usage)
     
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 }}

​

Configurer la logique dans votre outil externe

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 en incluant :
     • call_uuid (pour associer le bon appel)
     • type (html ou blocks)
     • content (les données à afficher)

​

Exemple de configuration dans CloudTalk (avec Zapier)

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

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

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

• Utilisez une étape Webhook Zapier POST.
• Point de terminaison : 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é.