> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Cue Cards
> As Cue Cards ajudam os seus agentes ao mostrar informações atualizadas, como o histórico do cliente, o estado do negócio ou guiões de chamadas personalizados.
Este guia explica como configurar as Cue Cards na CloudTalk para que os seus agentes vejam detalhes do cliente, guiões ou documentos em tempo real durante as chamadas.
**Nível de utilizador:** Admin
***
Como funcionam as Cue Cards
Quando uma chamada é iniciada, a CloudTalk aciona uma **Automação de fluxo de trabalho** que envia o identificador único da chamada (Call UUID) para o seu sistema externo (CRM, Zapier ou backend personalizado).
De seguida, o seu sistema externo:
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](/api-reference/cuecard/create-cuecard).
A CloudTalk apresenta imediatamente estes dados ao agente no CloudTalk Phone.
As Cue Cards estão disponíveis na **aplicação web da CloudTalk, na aplicação desktop e nas integrações CTI**. **Não são suportadas na aplicação móvel CloudTalk Go**.
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](/pt/articles/5450779-configuring-workflow-automations)**.
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 }}`
A CloudTalk passa agora a enviar o Call UUID para o seu sistema externo sempre que uma chamada correspondente é atendida.
Configurar a lógica na sua ferramenta externa
A sua ferramenta externa (CRM, Zapier ou backend personalizado) tem de executar quatro passos:
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](/api-reference/cuecard/create-cuecard) incluindo:
* `call_uuid` (para corresponder à chamada correta)
* `type` (`html` ou `blocks`)
* `content` (os dados que pretende apresentar)
Assim que a CloudTalk receber o payload, a Cue Card aparece instantaneamente no painel do agente.
Exemplo de configuração na CloudTalk (com o Zapier)
Eis um exemplo simplificado de como pode ligar as Automações de fluxo de trabalho da CloudTalk ao Zapier para apresentar Cue Cards:
**Na CloudTalk (Passo 1)**
* 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 }}`
**No Zapier (Passo 2)**
* **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:
```json theme={"system"}
{
"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"
}
]
}
```
**Enviar para a API da CloudTalk (Passo 3)**
* Utilize um passo Webhook do Zapier **`POST`**.
* Endpoint: [`https://platform-api.cloudtalk.io/api/cuecards`](https://platform-api.cloudtalk.io/api/cuecards)
* Cabeçalhos:
* `Content-Type: application/json`
* `Authorization: Bearer `
* Corpo: o JSON da Cue Card que preparou.
Quando a chamada é atendida, o Zapier procura os dados, cria o payload e a CloudTalk apresenta instantaneamente a Cue Card ao agente.
***
*Precisa de ajuda ou tem alguma questão?* Contacte-nos através do nosso [Portal de Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aqui para si.
## Related topics
- [Como utilizar o WhatsApp com a CloudTalk](/pt/articles/6811232-how-to-use-whatsapp-with-cloudtalk.md)
- [WhatsApp não envia nem recebe mensagens](/pt/articles/13333950-whatsapp-not-sending-or-receiving-messages.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.