Cue Cards

​

Como funcionam as Cue Cards

1. Utiliza o UUID para procurar os dados relevantes do cliente ou do negócio.
2. Prepara estes dados no formato correto (HTML ou Blocks).
3. Envia os dados de volta para a CloudTalk através da API Cue Cards.

​

Fluxo de configuração

​

Configurar a Automação de fluxo de trabalho na CloudTalk

1. No seu Dashboard da CloudTalk, aceda a Automações de fluxo de trabalho.
2. Clique em + Adicionar Fluxo de Trabalho.
3. Selecione o Acionador:
   • Objeto: Chamada
   • Ação: Respondido (ou Iniciado, consoante o seu caso de utilização)
     
4. (Opcional) Adicione Condições, por exemplo:
   • Mostrar apenas para chamadas recebidas → #{{ Call_direction == "Inbound" }}
   • Tags VIP, países específicos ou agentes/grupos selecionados
5. Adicione uma Ação: API Request.
   • Método: POST
   • Endpoint: URL do seu sistema externo (por exemplo, webhook do Zapier ou API do CRM).
   • Cabeçalhos: por exemplo, Content-Type: application/json
   • Valores: inclua call_uuid → #{{ Call_uuid }}

​

Configurar a lógica na sua ferramenta externa

1. Receber o pedido da CloudTalk
   • A Automação de fluxo de trabalho da CloudTalk envia um POST HTTP para o endpoint que indicar.
   • O pedido contém, no mínimo, o call_uuid e quaisquer outros valores que tenha configurado.
2. Procurar os dados que pretende apresentar
   • Por exemplo, obtenha o perfil de CRM do autor da chamada, a encomenda mais recente ou carregue um guião de chamada a partir da sua base de dados.
3. Criar o payload da Cue Card
   • Formate a resposta como:
     • HTML (texto/ligações simples) ou
     • Blocks (campos estruturados como textfields, ligações, imagens ou ficheiros).
4. Enviar o payload de volta para a CloudTalk
   • Faça um pedido POST à API Cue Cards incluindo:
     • call_uuid (para corresponder à chamada correta)
     • type (html ou blocks)
     • content (os dados que pretende apresentar)

​

Exemplo de configuração na CloudTalk (com o Zapier)

• Crie uma Automação de fluxo de trabalho com Acionador = Chamada Respondida.
• Adicione uma Ação API Request que aponte para o URL do seu Webhook do Zapier.
• Envie o seguinte valor:
  • call_uuid → #{{ Call_uuid }}

• Catch Webhook: o Zapier recebe o POST da CloudTalk com o call_uuid.
• Procurar dados: utilize passos do Zapier (por exemplo, pesquisar registos no CRM ou obter dados de uma base de dados).
• Formatar o payload da Cue Card: crie um corpo JSON para a API Cue Cards, por exemplo:

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

• Utilize um passo Webhook do Zapier POST.
• Endpoint: https://platform-api.cloudtalk.io/api/cuecards
• Cabeçalhos:
  • Content-Type: application/json
  • Authorization: Bearer <YOUR_API_KEY>
• Corpo: o JSON da Cue Card que preparou.