Ações

Conhecer quem liga antes de a chamada começar

Procure quem liga no seu próprio sistema antes de o agente cumprimentar.

Um Pre fetch pergunta ao seu sistema sobre quem liga enquanto a chamada é estabelecida e entrega a resposta ao agente antes da primeira palavra — assim pode cumprimentar pelo nome um cliente que regressa, ver uma encomenda em aberto ou saber o nível de quem liga.

Configurar

1. Adicione um Pre fetch

   Abra o agente → Ações → Adicionar ferramenta e escolha Pre fetch no topo do menu.

2. Aponte-o para o seu endpoint

   Campo	O que introduzir
   Nome	Um nome curto, p. ex. crm_lookup. É também o nome do bloco que o agente lê
   API URL	O seu endpoint, p. ex. https://crm.example.com/lookup?phone={phone}
   Método HTTP	GET é o mais adequado; POST, PUT, PATCH e DELETE também funcionam
   Cabeçalhos	Opcionais, p. ex. a sua chave API
   Parâmetros de consulta	Opcionais; um novo pre fetch começa com phone={phone}

3. Use os marcadores

   São preenchidos em cada chamada, no URL, nos cabeçalhos e nos parâmetros:

   Marcador	Valor
   {phone}	O número de quem liga; numa chamada efetuada, o número marcado
   {direction}	inbound ou outbound
   {agent_id}	O ID do agente
   {user_id}	O ID do proprietário da conta
   {call_id}	O ID da chamada — cruze-o com os dados que recebe depois da chamada

O que o agente recebe

A sua resposta é acrescentada às instruções do agente como um bloco com nome. Se o seu endpoint devolver { "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }, o agente lê-o antes da saudação. No prompt pode dizer o que fazer com isso, p. ex. se o contexto da chamada tiver o nome do cliente, cumprimenta-o pelo nome.

Limites

• Só chamadas telefónicas — uma chamada web não tem número para procurar.
• Cada pedido tem 1,5 segundos, todos juntos 2 segundos. Um endpoint lento ou com falhas nunca atrasa a saudação: o agente começa sem esse bloco.
• As respostas com mais de 8 KB são cortadas. Devolva alguns campos, não a ficha completa do cliente.
• Um pre fetch é sempre executado; não tem condição.

Casos de uso

• Cumprimentar pelo nome os clientes que regressam.
• Conhecer a encomenda em aberto antes de quem liga a explicar.
• Tratar de forma diferente os números VIP desde a primeira frase.

Relacionado

• Obter dados em tempo real durante a chamada — quando o agente deve decidir durante a chamada se procura alguma coisa
• Enviar os dados da chamada para o seu sistema — depois da chamada