Automatize o atendimento da sua corretora de ponta a ponta: construa fluxos conversacionais com o ChatBot, deixe a Inteligência Artificial generativa receber e qualificar clientes como um SDR, e monte jornadas completas no editor visual do Flow. Esta área reúne tudo o que você precisa para responder mais rápido, 24 horas por dia, sem perder o toque humano.

O módulo de Automações é a página índice que reúne três ferramentas complementares: o ChatBot, o Prompt IA e o Flow. Você pode usá-las isoladamente ou em conjunto, conforme a maturidade da automação que deseja construir.

ChatBot

Tutorial em vídeo disponível na plataforma

O ChatBot permite criar fluxos de atendimento automatizados. Acesse pelo menu lateral em ChatBot. A tela oferece filtros por Ativos e Inativos, além dos botões Adicionar e Importar (a partir de um JSON exportado de outra plataforma).

Criar um chatbot

Clique em Adicionar e preencha os campos abaixo:

Descrição

Nome do chatbot.

Ativo

Define se o bot está em operação.

Chatbot de Atendimento

Indica que o bot é usado em atendimentos ativos.

Número para teste

Número usado para validar o fluxo antes de publicar.

Palavras-chave

Termos que ativam bots específicos.

Cada bot listado oferece os botões: Editar, Duplicar, Abrir fluxo, Inativar/Ativar e Exportar Json.

Interações

API não oficial

Clique na etapa de boas-vindas e adicione mensagens.

API oficial

Use o segundo ícone da interação. Informe a mensagem e clique em Adicionar Opção. A Meta exibe como botões até 3 opções; de 4 a 10 opções vira lista interativa; o limite é de 20 caracteres por opção (padrão da Meta).

Arquivos por etapa

Limites da API oficial: áudio 16 MB, documento 100 MB, imagem 5 MB, sticker 100 KB, vídeo 16 MB.

Delay do chatbot

Tempo de espera em segundos que humaniza a conversa. Um tempo muito longo pode causar problemas no envio.

Ação contínua

Novidade A Ação contínua (v26.02.15) executa uma ação sem necessidade de input do cliente, logo após o delay anterior. As rotinas disponíveis são: Etapa, Fechar, API e chatbot (o roteamento para departamento/usuário ainda não está disponível).

Callback

Novidade O Callback (v26.02.15) trava o bot até que a requisição da API seja enviada, evitando que o fluxo avance antes da resposta. O bot continua após receber o callback via API, procurando uma condição do tipo Callback. O endpoint move o ticket para a próxima etapa quando o nó é Callback (parâmetros: id da API externa e ticketId).

Exemplo de body enviado:

{ "note": { "body": "Cliente avançou após pagamento confirmado" } }

Respostas possíveis:

Documentação adicional disponível na sua URL acrescida de /#/docs.

Configuração geral do bot

Mensagem de saudação

Última mensagem do bot, que indica a transferência.

Mensagem de feedback

Resposta enviada quando o cliente responde algo fora das opções.

Ausência de resposta

Define para onde encaminhar (departamento/usuário) ou finalizar após determinado tempo.

Máximo de tentativas

Número de tentativas antes de uma ação de fallback.

Autodistribuição

Distribui automaticamente os atendimentos.

Encerrar atendimento

Finaliza sem motivo de fechamento para métrica.

Avaliação de condição

Habilita a avaliação de condições no fluxo.

Condições (If/Else)

As condições permitem ramificar o fluxo conforme a resposta do cliente.

Se (condição de entrada): Qualquer resposta, Resposta específica ou Callback. A partir daí você pode:

• Guardar a resposta em uma variável.
• Salvar no campo customizado.
• Adicionar etiquetas (várias).
• Adicionar Status Cliente (um).
• Adicionar Origem do Lead.

Rotear (Else): Etapa, Departamento, Usuário, Fechar (com motivo), API (requisição), Chatbot (outro bot) ou Bloquear (Broadcast ou comum). As setas movimentam as condições na ordem desejada.

Requisição de API

A Requisição de API permite integrações com sistemas externos — por exemplo, emissão de 2ª via de boleto ou IA acionada via N8N. A automação envia e recebe dados estruturados em JSON, conectando o seu fluxo a serviços de terceiros.

Prompt IA

Tutorial em vídeo disponível na plataforma

A IA do AtendeSEG é baseada em prompt de comando e funciona como um SDR: recebe clientes, tira dúvidas e distribui para o departamento adequado. Ela é generativa, ou seja, gera textos conforme o contexto e "raciocina" sobre os cenários para decidir quais ferramentas utilizar.

Modelos utilizados

Texto

GPT-4.o mini.

Áudio

eleven_turbo_v2_5.

Regras de funcionamento

1. Não continua após o aceite. A IA não segue atuando depois que o ticket é aceito por um atendente.
2. Responde apenas o cliente. Atua somente sobre as mensagens enviadas pelo cliente.
3. Sem reativação. Não é reativada quando o ticket é aceito e lançado novamente nos pendentes.
4. Tamanho do histórico. Corresponde à quantidade de mensagens salvas como dado para o contato.
5. Consumo de tokens. São consumidos por envio/recebimento de mensagem e análise de sentimento (texto), e por envio/recebimento de áudio (tokens de áudio).
6. Recargas. São obrigatórios tokens de conversa; áudio→texto exige créditos de voz para texto; texto→voz exige créditos de texto para voz.

Tags do prompt

O prompt é estruturado por tags que organizam o comportamento da IA:

<responder por voz>

Define como entender áudios e pronunciar corretamente.

<persona>

Quem é a assistente virtual.

<personalidade>

Tom e estilo de comunicação.

<missão>

Objetivos e diretrizes de condução.

<listas>

Formato de apresentação de listas.

<chatbots>

Detecção de loops entre chatbots.

<contexto>

Informações da empresa e FAQ. Estrutura do FAQ: Pergunta / Resposta correta.

Elementos de configuração

Nome do prompt

Identificação do prompt.

Prompt de comandos

O texto que orienta a IA.

Tamanho do histórico

Quantidade de mensagens de contexto.

Departamento padrão

Para onde direcionar por padrão.

Voz da IA

Timbre utilizado nas respostas em áudio.

Modelo de prompt genérico

Use o modelo abaixo como ponto de partida para os seus testes, adaptando persona, contexto e FAQ à realidade da sua corretora:

Sempre verifique no contexto se "Responder por Voz" tem o valor "1" e se tiver, aplique as regras dentro de "<responder por voz></responder por voz>".
Se o usuário solicitar "e-mail", "link", "site" ou algo que remeta a uma URL, e "Responder por Voz" for "1", ignore as instruções desta sessão para Sites e e-mails.
Se "Responder por Voz" for "0", ignore o bloco "<responder por voz>" e use as instruções do <contexto>.
Nunca cite a informação "Responder por Voz".

<responder por voz>
Números/dígitos por extenso em pt-BR (1=Um, 2=Dois, ... 0=Zero; 10=Dez, 11=Onze...).
Medidas: m2=Metro quadrado; km=Quilômetro; hs=Horas; m=Metros; d=Dias.
Moedas/Valores: "R$599,00"=Quinhentos e noventa e nove reais; "1.999,00"=Mil, novecentos e noventa e nove; "R$"=Reais.
Sites/e-mails: "."=Ponto; ".com"=Ponto com; ".com.br"=Ponto com, ponto bêérre; "https"=agá tê tê pê êésse; ":"=Dois pontos; "//"=bárra bárra; "@"=Arrôba.
</responder por voz>

<persona>
Você é a LIA, uma assistente virtual especializada em atendimento para empresas de tecnologia. Sua missão é ajudar clientes com dúvidas e orientações sobre o sistema AtendeSEG, guiando cada interação com clareza, simpatia e foco em resultados.
</persona>

<personalidade>
Extrovertida na medida certa. Bem-humorada, leve e objetiva. Explicações curtas e diretas. Linguagem natural, adaptada ao estilo de quem conversa. Consultora investigativa, protagonista, usando Rapport e PNL com naturalidade.
</personalidade>

<missão>
Iniciar cada conversa com simpatia e objetividade. Primeiro contato: cumprimente de forma leve. Com histórico: demonstre familiaridade e retome o último assunto. Conduza de forma proativa, respostas curtas, sem termos técnicos. Foco em esclarecer dúvidas e mostrar o diferencial — sem comparar com concorrentes. Pode responder por texto ou áudio, mas nunca anuncie que enviará por voz. Perguntas inusitadas: trazer para o contexto dos serviços. Demonstração: você é o próprio exemplo funcional. Use Rapport e PNL. Nunca use emojis em frases, apenas em listas. Máximo 150 caracteres por resposta.
</missão>

<listas>
Marque cada item com "◽" antes do item.
Exemplo certo: ◽ item; ◽ item.
Exemplo errado: 1 - item; 2 - item.
</listas>

<chatbots>
Monitore para identificar se está interagindo com outro chatbot (mensagens repetidas 3+ vezes = loop). Em loop, responda: "Detectamos um loop entre chatbots e por isso estamos desativando esta conversa. Em breve um atendente entrará em contato. Obrigado!".
</chatbots>

<contexto>
Sobre a IA: automatiza atendimento por WhatsApp com IA, sem o aspecto engessado dos bots tradicionais.
Funcionalidades: ◽ Reconhecimento de mensagens de texto/áudio; ◽ Respostas por texto/áudio; ◽ Reconhecimento de intenção; ◽ Direcionamento para departamentos.
Benefícios: ◽ Atendimento humanizado 24h; ◽ Aumento de conversão e satisfação; ◽ Respostas naturais e assertivas.
FAQ: Pergunta: Qual o horário de atendimento? Resposta: Atendimento 24h via IA; humano das 8h às 18h.
Instruções específicas: ao agendar treinamento, pergunte o nome da empresa e o melhor dia/horário.
Contatos: ◽ Suporte: +55 84 9 8888-8888
</contexto>

Intenções da IA

As Intenções são configurações externas ao prompt que permitem enviar dados a um sistema externo e receber a resposta via push — por exemplo, a 2ª via de um boleto. Cada prompt exibe 3 botões: Excluir, Editar e Intenções.

Ao criar uma intenção, você define:

Ação

Nome da intenção (ex.: "Segunda via de boleto").

Dados necessários

Campos a coletar, com o respectivo tipo.

Webhook

Endereço que recebe o dado.

Tipos de eventos

Eventos que disparam a intenção.

Formato JSON de envio

Estrutura dos dados enviados.

As intenções também permitem atrelar Etiquetas e Campos Customizados ao contato que interage com a IA.

IA Externa

A IA Externa é uma inteligência conectada via API/Webhook, executada em um ambiente separado — como N8N, servidores próprios ou outros serviços de terceiros que você escolher. Pré-requisitos:

• Um webhook público (URL que recebe requisições POST).
• A configuração API/Webhook com a URL de retorno e um Token.

O fluxo opera em loop: Início → Boas-vindas → Loop. Em cada iteração há uma condição "Qualquer resposta", a mensagem é salva em mensagem_cliente e há o roteamento via POST ao webhook da IA.

Chamada da plataforma para o webhook da IA

Requisição POST com Content-Type: application/json:

{
  "numero_cliente": "{{number}}",
  "sessionId": "{{protocolo}}",
  "mensagem_cliente": "{{mensagem_cliente}}",
  "url_envio": "https://teste01.teste.com.br/v1/api/external/<id>/?token=<JWT>"
}

Resposta síncrona opcional (200 OK):

{ "message": "texto para o cliente" }

Resposta da IA para a plataforma (push)

Endpoint: POST https://teste01.teste.com.br/v1/api/external/{id} — headers Content-Type: application/json e Authorization: Bearer <TOKEN>. Body mínimo:

{ "body": "Olá! Encontrei seu boleto...", "number": "5564999999999", "externalKey": "12345" }

Para incluir uma nota com mídia, adicione o campo opcional note:

{ "note": { "body": "...", "mediaUrl": "https://...pdf" } }

Ações na IA

Novidade A partir da v26.02.17.2, o menu de três pontinhos da IA traz novas ações:

Limpar o cache

Limpa o cache, que tem duração de 5 minutos.

Limpar memória persistente

Limpa o cache e as conversas com o contato (tabela independente do chat). As mensagens do chat são preservadas.

Desativar

Remove a IA da listagem, mantendo-a visível por meio de uma opção dedicada.

Comportamento ao receber mídia: antes a IA transferia para um agente; agora ela pede para o cliente descrever a mídia (mensagem editável no prompt). Mensagem de transferência: pode ser ativada ou inativada externamente ao prompt, sem comando de transferência duplicado nas tags.

Reconhecimento de imagem

Regras críticas:

• Nunca enviar uma transcrição robotizada.
• Sempre analisar o contexto.
• Se a imagem estiver fora do contexto do prompt, responder apenas: "Recebi sua imagem! Como posso te ajudar hoje?".

Flow

O Flow é o editor visual de fluxos do AtendeSEG. Esta seção é a referência completa dos blocos (nodes) do editor. Cada node documenta Quando usar, Configuração, Saídas (handles), Gotchas e Exemplo. O type interno aparece em cada node.

Conceitos gerais

• Templates de variável. {{nomeVar}}, {{contact.name}} e {{ticket.id}} são resolvidos em runtime. As variáveis ficam visíveis nos nodes seguintes e viram customFields do contato.
• Aba "Logs". Presente nos nodes com chamada externa (API, Enviar/Receber Webhook).
• Validação visual. Badge vermelho impede salvar; badge amarelo é apenas um aviso. A saída default sempre funciona.
• Loops. Permitidos somente com um bloco que pausa (Pergunta, Opções, Agente IA, Pausa, Botões/Lista WABA).
• Sub-fluxos. Via Ação transferFluxo (com awaitReturn:true volta ao fluxo pai, preservando as variáveis).
• Pausa do bot. O bot pausa quando um humano assume (status "open" + responsável); volta a atuar se o ticket fechar e reabrir.

Gatilhos

Início — type:"start"

Ponto de entrada (1 por fluxo, não removível). Dispara quando uma mensagem do contato chega. Não dispara se o ticket estiver "open" com userId setado, nem para mensagens fromMe.

Agendamento — type:"scheduleTrigger"

Dispara por cron. Config: enabled (true), cron (ex.: 0 9 * * 1-5), timezone (America/Sao_Paulo), initialVars ({}). Execuções headless (sem ticket/contact). Exemplo: cron:"0 8 * * 1-5", timezone "America/Sao_Paulo", initialVars { campanha:"promo-maio" }.

Receber Webhook — type:"webhookTrigger"

Cria uma URL pública; um POST dispara o fluxo com o body em initialVars.payload. Config: enabled, token (gerado no save), initialVars. Headless. O body cru fica em variables.payload (extraia com Script/Set Variable).

Mensageria

Conteúdo — type:"content"

Envia uma sequência de mensagens (texto/mídia). items[] com kind (text/image/audio/video/document), text, url, caption. Um erro em um item é logado e o fluxo continua. No WABA Cloud, a mídia precisa de URL pública HTTPS ou ID.

Pergunta — type:"ask"

Pergunta e pausa aguardando a resposta (salva em variableName). validation: none/email/phone/cpf/cnpj/number/date/regex. retry (enabled, maxAttempts, invalidMessage). noReply (enabled, timeout). Saídas: default, reply, invalid, no_reply. Sem variableName a resposta é descartada; o retry exige validation.

Pausa — type:"pause"

Pausa por milissegundos (bloqueante). mode fixed/smart; minMilliseconds (1500), maxMilliseconds (smart). Não usar pausas longas (acima de 1 min → usar o bloco Espera).

Opções — type:"options"

Menu numerado (texto) ou botões (WABA). text; options[] {id,label}; saveAs; noReply. O contato pode digitar o número ou o label.

Botões/Lista WABA — type:"wabaInteractive"

Botões (máx. 3) ou lista (máx. 10). mode buttons/list; body; header; footer; itemsSource static/dynamic; items[]/sections[]; arrayVar; idField/titleField/descriptionField; maxItems; saveAs (default lastSelectedOption); textFallback. O modo dinâmico precisa de arrayVar populado antes.

Template WABA — type:"wabaTemplate"

Envia um HSM aprovado (inicia conversa fora da janela de 24h). templateHsmId; templateName; language (pt_BR); whatsappId; bodyParams[]; headerMediaUrl; buttonParams[]; awaitReply. Saídas: success/error (ou reply/no_reply/error com awaitReply). Os parâmetros devem casar com o template aprovado.

Inteligência — Agente IA

O Agente IA (type:"agent") é o bloco mais poderoso do Flow, baseado em LLM da OpenAI. Sua configuração é organizada em abas:

Abas de configuração do Agente IA

① Prompt

Persona + promptTemplate, com suporte a templates de variável.

② Coleta

collection.enabled, fields[] {name, description, type [text/email/phone/cpf/cnpj/number/date/enum/regex], required, enumValues, regex, example}, saveOnComplete.

③ Tools

Built-ins: end_success, end_error, transfer_human, datetime, http, knowledge_base, collect_data, route_to. Config comum: id, kind, name (sem espaço/acento), description, enabled, config.

④ Saídas

handles[] {id, label, kind success/error/transfer}, onMaxTurnsHandle, onErrorHandle; o route_to é exposto com mais de 1 handle.

⑤ Memória

Pré-contexto: includeTicketHistory true, historyMessages 20. Memória persistente: persistAcrossSessions true. Compactação: summarizeAfterTokens 0/off (rec. 4000), compactKeepTail 6. Debounce: debounceMs 0 (rec. 4000).

⑥ Guardrails

blockedTopics[], requireValidation true.

⑦ Modelo

provider openai; model gpt-4o-mini (opções: gpt-4o, gpt-4o-2024-08-06, gpt-4-turbo, o1-mini, o1-preview, gpt-3.5-turbo); temperature 0.7; maxTokens 1024; maxTurns 15.

Tool HTTP

Config da tool HTTP: method (GET), url (templates {{args.x}}/{{vars.y}}/{{contact.z}}), headers, query, bodyType (none/json/form/urlencoded/raw), bodyJson, auth (none/basic/bearer/apiKey), timeoutMs (15000), argsLocation (auto/body/query/none), params[] {name, type, description, required}.

Exemplo — Tool HTTP (GET com path param):

{ "id":"t_consulta_pedido","kind":"http","name":"consultar_pedido",
  "description":"Consulta status de um pedido pelo número.",
  "config":{ "method":"GET","url":"https://api.empresa.com/pedidos/{{args.numero}}",
    "headers":{"Authorization":"Bearer {{vars.api_token}}"},"timeoutMs":10000,
    "params":[{"name":"numero","type":"string","description":"Número do pedido","required":true}] } }

Exemplo — Tool HTTP (POST body JSON, argsLocation none):

{ "id":"t_criar_chamado","kind":"http","name":"criar_chamado",
  "description":"Abre um chamado no sistema interno.",
  "config":{ "method":"POST","url":"https://api.empresa.com/chamados","bodyType":"json",
    "bodyJson":{"contactId":"{{contact.id}}","titulo":"{{args.titulo}}","descricao":"{{args.descricao}}","prioridade":"{{args.prioridade}}","canal":"whatsapp"},
    "auth":{"type":"bearer","token":"{{vars.api_token}}"},"argsLocation":"none",
    "params":[{"name":"titulo","type":"string","description":"Título","required":true},{"name":"descricao","type":"string","description":"Descrição","required":true},{"name":"prioridade","type":"string","description":"baixa/normal/alta","required":false}] } }

Handles de saída: success (end_success); error (LLM/tool/maxTurns/guardrail/end_error); customizados (route_to). Comportamento dos args: sem body e método não-GET → os args viram o JSON do body; com body → os args são expostos como {{args.x}}; GET → os args viram query; argsLocation none → ignora os args.

Lógica

Espera — type:"wait"

Pausa não-bloqueante (horas/dias). mode duration/until; durationValue + durationUnit (seconds/minutes/hours/days); untilDate/untilTime; timezone. (Pausa = bloqueante/ms; Espera = não-bloqueante/qualquer duração.)

Condição — type:"condition"

Ramifica por variável. source; branches[] {id, label, operator, value}. Operadores: equals, notEquals, contains, startsWith, endsWith, regex, gt, gte, lt, lte, isEmpty, isNotEmpty, fallback. Sempre ter fallback. O source aceita caminho com ponto.

Variável — type:"setVariable"

assignments[] {name, value, valueKind: string/number/boolean/json/template}. Viram customField do contato.

API — type:"api"

HTTP externo. method (GET), url, headers, query, bodyType (none/json/form/urlencoded/raw), auth (none/basic/bearer/oauth2/customHeader), timeoutMs (30000), followRedirects (true), rejectUnauthorized (true), retry (enabled false, maxAttempts 3, backoffMs 1000), responseVar, responseMap {var:"$.json.path"}. Saídas: success (2xx)/error. OAuth2 requer credencial pré-configurada.

Script JS — type:"script"

JS isolado. Disponível: vars, <nome_var>, contact (id/name/number/email/pushname/observations/customFields), ticket (id/status/channel/isGroup/queueId/userId/contactId/protocol), setVariable(name,value), console.*. Config: code (até 64KB), responseVar, timeoutMs (5000; 100–30000), memoryMb (32; 8–128). Saídas: success/error. SEM require/import/fetch/setTimeout/internet (para HTTP use o node API). Alterar vars/contact/ticket direto não persiste (use setVariable). Retorno acima de 256KB → erro.

Enviar Webhook — type:"webhook"

POST de notificação. method (POST), url, auth, payload.mode (preset/custom), payload.contact/ticket/fluxo/variables (true), payload.customJson, timeoutMs (30000), fireAndForget (false), retry. Saídas: success/error (ou só success com fireAndForget).

Horário Comercial — type:"businessHours"

open/closed/holiday. timezone; days[] (7 dias, {enabled, intervals[]{from,to HH:MM}}); holidays[] (MM-DD).

Exemplo de Script JS:

const total = produtos.reduce((s,p)=>s+p.preco*p.qty,0); setVariable("totalPedido", total); if(total>1000) setVariable("temDesconto", true); return { ok:true, total };

Ações

O bloco Ação (type:"action") executa steps em ordem; a primeira ação terminal interrompe a sequência. Kinds disponíveis:

addTag

Adiciona uma etiqueta.

removeTag

Remove uma etiqueta.

updateContact

Atualiza dados do contato.

transferUser

Transfere para um usuário (terminal).

transferQueue

Transfere para um departamento (terminal).

transferFluxo

Transfere para outro fluxo (terminal se sem awaitReturn; com awaitReturn:true vira sub-fluxo).

closeTicket

Fecha o ticket (terminal).

blockContact

Bloqueia o contato (terminal).

Saída: default (caso nenhuma ação terminal seja executada).

Glossário

Glossário de termos do Flow

Fluxo, Node/Bloco, Edge/Conexão, Handle/Saída, Gatilho/Trigger, Variável, Template, Contato, Ticket, Fila/Departamento, Atendente, Sub-fluxo, Tool, LLM, Token (~4 chars = 1 token), Persona, Prompt template, Coleta, Memória persistente, Compactação automática, Debounce, Validação, Fallback, Headless, WABA, Template HSM, Janela de 24h.

Boas práticas com o Agente IA