Cue Cards

​

Cómo funcionan las Cue Cards

1. Usa el UUID para buscar los datos relevantes del cliente o del negocio.
2. Prepara esos datos en el formato correcto (HTML o Blocks).
3. Devuelve los datos a CloudTalk a través de la Cue Cards API.

​

Proceso de configuración

​

Configura la Automatización de flujo de trabajo en CloudTalk

1. En tu CloudTalk Dashboard, ve a Automatizaciones de flujo de trabajo.
2. Haz clic en + Agregar Flujo de Trabajo.
3. Selecciona el Activador:
   • Objeto: Llamar
   • Acción: Respondido (o Iniciado, según tu caso de uso)
     
4. (Opcional) Añade Condiciones, por ejemplo:
   • Mostrar solo en llamadas entrantes → #{{ Call_direction == "Inbound" }}
   • Etiquetas VIP, países concretos o agentes/grupos seleccionados
5. Añade una Acción: solicitud a la API.
   • Método: POST
   • Endpoint: la URL de tu sistema externo (por ejemplo, un webhook de Zapier o la API de tu CRM).
   • Cabeceras: por ejemplo, Content-Type: application/json
   • Valores: incluye call_uuid → #{{ Call_uuid }}

​

Configura la lógica en tu herramienta externa

1. Recibir la solicitud de CloudTalk
   • La Automatización de flujo de trabajo de CloudTalk envía una solicitud HTTP POST al endpoint que indiques.
   • La solicitud contiene, como mínimo, el call_uuid y cualquier otro valor que hayas configurado.
2. Buscar los datos que quieres mostrar
   • Por ejemplo, recuperar la ficha del cliente en el CRM, su último pedido o un guion de llamada de tu base de datos.
3. Crear el payload de la Cue Card
   • Da a la respuesta uno de estos formatos:
     • HTML (texto y enlaces simples), o
     • Blocks (campos estructurados como campos de texto, enlaces, imágenes o archivos).
4. Enviar el payload de vuelta a CloudTalk
   • Haz una solicitud POST a la Cue Cards API que incluya:
     • call_uuid (para asociarlo a la llamada correcta)
     • type (html o blocks)
     • content (los datos que quieres mostrar)

​

Ejemplo de configuración en CloudTalk (con Zapier)

• Crea una Automatización de flujo de trabajo con Activador = Llamada respondida.
• Añade una Acción de solicitud a la API que apunte a la URL de tu webhook de Zapier.
• Envía el siguiente valor:
  • call_uuid → #{{ Call_uuid }}

• Catch Webhook: Zapier recibe el POST de CloudTalk con el call_uuid.
• Buscar los datos: usa pasos de Zapier (por ejemplo, buscar registros en el CRM o consultar una base de datos).
• Dar formato al payload de la Cue Card: crea un cuerpo JSON para la Cue Cards API, por ejemplo:

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

• Usa un paso Webhook POST de Zapier.
• Endpoint: https://platform-api.cloudtalk.io/api/cuecards
• Cabeceras:
  • Content-Type: application/json
  • Authorization: Bearer <YOUR_API_KEY>
• Cuerpo: el JSON de la Cue Card que has preparado.