Chatbot: ações, API e IA
Estes três blocos fazem o fluxo agir fora da conversa: mudar dados no DeepLead, falar com outro sistema e responder com inteligência artificial. Os blocos de conversa estão em Chatbot: blocos de conversa.
# Ação
Escolha o Tipo de Ação e preencha o alvo.
| Tipo de Ação | Campos | O que faz | Depois dela |
|---|---|---|---|
| Adicionar Tag | Tag | Põe a tag. A lista separa Tags de Conversa e Tags de Contato | O fluxo continua |
| Remover Tag | Tag | Tira a tag da conversa ou do contato | O fluxo continua |
| Atribuir Agente | Agente | Entrega a conversa àquela pessoa, em Em atendimento | O bot termina |
| Atribuir Equipe | Equipe | Entrega a conversa à equipe, pelo Modo de Atribuição dela | O bot termina |
| Mover Deal | Pipeline e Etapa | Move os negócios do contato naquele pipeline para a etapa | O fluxo continua |
| Criar Deal | Pipeline, Etapa, Título do Deal, Valor do Deal (opcional), Prioridade | Cria um negócio para o contato | O fluxo continua |
| Atualizar Contato | Tipo de campo, Campo, Valor | Grava o valor no campo nativo ou personalizado | O fluxo continua |
| Encerrar Chat | Motivo do encerramento | Encerra a conversa com o motivo escolhido | O bot termina |
Regras:
- Atribuir Agente, Atribuir Equipe e Encerrar Chat encerram o bot. Blocos ligados depois deles não são executados. Envie a mensagem de despedida antes.
- Atribuir Equipe em modo Distribuição Automática escolhe o próximo atendente Disponível. Sem ninguém disponível, ou em modo Manual, a conversa fica em Aguardando, ligada à equipe.
- Ação de atribuir sem equipe ou agente escolhido é pulada em silêncio: o cliente fica sem atendente. O editor avisa ao salvar.
- Criar Deal não duplica: se o contato já tem negócio naquele pipeline, a
ação é pulada. Título do Deal e Valor de Atualizar Contato aceitam
variáveis, como
{{name}}e{{email}}. - Se a conversa ainda não tem contato, Criar Deal e Atualizar Contato criam um.
- Em Encerrar Chat, quando as regras de atendimento exigem motivo, o campo ganha um asterisco. Sem motivo, a conversa é encerrada do mesmo jeito, mas aparece sem motivo nas métricas.
# API
Chama um endereço externo e guarda partes da resposta como variáveis.
| Campo | O que é |
|---|---|
| Método | GET, POST, PUT, PATCH ou DELETE |
| URL | O endereço. Aceita variáveis: https://api.exemplo.com/?email={{email}} |
| Headers (JSON) | Cabeçalhos, como {"Authorization": "Bearer ..."} |
| Body (JSON) | Corpo da chamada. Não aparece em GET |
| Extrair da resposta JSON | Pares de caminho e variável: data.user.id → user_id |
Clique em Adicionar mapeamento para cada dado que quiser guardar. Depois
use {{user_id}} nos blocos seguintes.
Regras:
- A chamada espera até 15 segundos.
- Se der erro, o fluxo continua para o próximo bloco. Não há saída separada para sucesso e falha: o erro só aparece em Logs do fluxo.
- Headers com JSON inválido são ignorados.
- Quando a variável não é extraída, o texto
{{user_id}}é enviado como está. Use uma Condição antes de mostrar o dado ao cliente.
# IA
Envia a conversa a um modelo de inteligência artificial e manda a resposta ao cliente. Antes, cadastre um provedor em Inteligência artificial no atendimento.
| Campo | O que é |
|---|---|
| Provedor de IA | O provedor e o modelo que respondem |
| System Prompt | As instruções para a IA. Escolha um template de prompt ou Escrever manualmente |
| Max Tokens | Tamanho máximo da resposta, de 1 a 4.096 |
| Temperatura | De 0 a 1. Valores baixos dão respostas objetivas; altos, mais criativas |
| Modo Conversação Contínua | Mantém o cliente conversando com a IA até uma condição de saída |
| Ferramentas (Tools) | Endereços externos que a IA pode consultar |
A IA recebe as últimas 20 mensagens de texto da conversa como contexto. Respostas longas são divididas em mais de uma mensagem.
O System Prompt é enviado à IA exatamente como foi escrito. Variáveis como
{{name}}não são trocadas pelo dado do contato dentro do prompt.
# Sem o modo contínuo
A IA responde uma vez e o fluxo segue para o bloco seguinte.
# Com o modo contínuo
A IA responde a cada mensagem do cliente até uma das saídas acontecer:
| Campo | Quando sai | Para onde vai |
|---|---|---|
| Palavras de saída | A mensagem contém uma das palavras | Bloco seguinte |
| Palavras de transferência | A mensagem contém uma das palavras | A conversa vai para Aguardando e o bloco seguinte é executado |
| Máx. interações (0 = ilimitado) | A IA já respondeu esse número de vezes | Bloco seguinte |
| Saída por inatividade | Ninguém escreve pelo tempo definido | Bloco seguinte. Sem bloco seguinte, a conversa é encerrada |
| Transferência por inatividade | Ninguém escreve pelo tempo definido | O bloco seguinte é executado, o bot termina e a conversa vai para Aguardando |
Se os dois tempos de inatividade forem atingidos juntos, vale a transferência. Sem bloco seguinte, as saídas por palavra e por limite encerram o fluxo e a conversa vai para Aguardando.
# Ferramentas
Em Ferramentas (Tools), clique em Adicionar ferramenta e preencha Nome, Descrição, URL, Método e, se precisar, Headers (JSON, opcional). A descrição é o que a IA lê para decidir quando usar a ferramenta: escreva o que ela consulta e em que situação.
- O limite é de 10 ferramentas por bloco.
- As ferramentas só são usadas no modo contínuo, a partir da segunda resposta. A primeira resposta da IA é sempre sem ferramenta.
- Cada consulta espera até 10 segundos.
# Problemas comuns
| O que acontece | Por quê |
|---|---|
| O cliente escolheu o setor e ninguém foi atribuído | A ação Atribuir Equipe está sem equipe, ou ninguém estava Disponível |
| A mensagem depois do Atribuir Equipe não saiu | Ações de atribuir encerram o bot. Mova a mensagem para antes |
| O negócio não foi criado | O contato já tem negócio naquele pipeline, ou falta escolher a etapa |
| A IA não respondeu e o bot parou | O provedor falhou ou a chave é inválida. O erro aparece em Logs do fluxo |
| Nenhum provedor cadastrado no bloco IA | Cadastre um em Provedores de IA |
| Limite de 10 ferramentas atingido. | Remova uma ferramenta para adicionar outra |