Dashboard
Rascunhos (propostas da IA)
Itens criados pela IA ficam como rascunho até você aprovar. Use Testar para rodar o fluxo do bloco antes de aprovar, Editar para ajustar e Aprovar para ativar no bot.
Carregando…
Ideias e implementações (IA)
Sugestões e implementações registradas pela IA. A documentação para a IA está em docs/ia/GUIA-SISTEMA-EBOT.md — a IA usa esse guia para saber como trabalhar no sistema e pode enviar ideias via POST /api/admin/ia/ideias.
Carregando…
Fluxo
Start (palavras-chave) → Menu → Opções (links) → Blocos em sequência. A primeira mensagem passa pelo Start antes do menu.
0. Start (palavras-chave)
Captura a primeira mensagem do usuário e redireciona conforme a regra. Use palavra-chave (contém, exato, começa com) ou Regex. Sem menu principal, o bot ainda processa palavras-chave e regex e chama o destino (bloco, menu, etc.). Ordem: a primeira regra que der match vale.
Nova regra
Quando não der nenhum match
Destino quando a mensagem do usuário não corresponder a nenhuma regra acima (ex.: menu principal, um bloco ou encerramento).
Vínculo por telefone
No primeiro contato, se não houver registro em bot_contato_vinculo, o bot cria um vínculo só com o número. Depois envia para o destino abaixo. O admin define pelos menus se quer cadastrar o contato (nome, CPF, etc.) ou não.
Sessão (retomada)
Se o usuário abandonar a conversa no meio de um bloco, após X minutos sem responder a sessão expira. Os dados (payload) são preservados. Quando ele mandar mensagem de novo, o bot envia a mensagem abaixo e retoma de onde parou. Use {bloco} na mensagem para o nome do bloco.
1. Menus
Crie quantos menus precisar. Apenas um pode ser o principal (★). O envio no WhatsApp usa lista modelo (botão + itens) ou botões (até 3).
Criar novo menu
Lista: mensagem com botão que abre a lista de opções. Botões: até 3 opções como botões.
Como a mensagem será exibida no WhatsApp (lista ou botões).
Visualização
Funções
Tabelas disponíveis para buscas e funções prontas (quase endpoints) reutilizáveis em blocos ou pelo bot.
Tabelas disponíveis
Cadastre tabelas do banco para usar em buscas ou ao criar funções.
JOINs são definidos na criação da função (Nova função), não aqui.
| ID | Tabela | Título | Ordem |
|---|
Funções prontas
Funções completas com busca configurada. Use em blocos (em vez de montar busca manual) ou deixe o bot chamar automaticamente (ex: usuário manda só CPF).
| Chave | Título | Tabela | Trigger |
|---|
Modelos de dados
Conjuntos de campos reutilizáveis para confirmações e mensagens. Ex.: modelo "paciente" com nome, CPF, data de nascimento — uma vez definido, use em qualquer etapa de confirmação com modelo_chave: "paciente" e no texto use {payload._modelo_paciente}.
Modelos
Campos para listas WhatsApp
Mapeamento de campos ao exibir resultado de função em lista interativa. Define qual campo usar para id, título, descrição. Se a função não estiver aqui, o sistema usa fallback padrão. Execute scripts/fluxo-lista-campos.sql se a tabela não existir.
Novo / Editar mapeamento
Título alternativos: vírgula separada. Se o campo principal estiver vazio, tenta o próximo. Ex: nomepaciente,nome,name
Mapeamentos cadastrados
Carregando…
Pré-agendamentos
| Data | Paciente | CPF | Especialidade | Médico | Data/ Hora | Status |
|---|
Cron / fila campanhas (Flutter)
O app Flutter enfileira em bioma.campanha_bot_*; o e-bot chama periodicamente o
campanhaBotDisparo/processarFila no PHP até zerar pendentes. PM2 mantém este processo ativo.
Disparos automáticos
Fluxo avançado: 1) criar listas → 2) criar eventos → 3) configurar automações.
1) Listas de disparo
2) Eventos (o que será enviado)
3) Automação (lista + evento + trigger)
Disparos cadastrados
Conversas
Lista de quem já falou com o eBot. Use os filtros Ao vivo / Hoje / Ontem. Clique em uma conversa para ver histórico, interesses, linha do tempo e redirecionar o usuário para um menu.
Config API
Credenciais para integração com Meta (WhatsApp). Podem ser preenchidas aqui ou no arquivo .env. O valor salvo aqui tem prioridade.
Meta (WhatsApp Cloud API)
Dados obtidos no painel do app em developers.facebook.com → seu app → WhatsApp.
Onde: você inventa essa string. Use a mesma no Meta em WhatsApp → Configuração → Verificar token.
Onde: WhatsApp → Introdução (Gerar token de acesso) ou Configuração → Token permanente.
Onde: Configurações do app → Básico → Chave secreta do app.
Onde: WhatsApp → Introdução → Enviar e receber mensagens → número De → Identificação do número de telefone.
Integração IA
Use um modelo (Llama/Ollama ou API compatível) para auxiliar o fluxo e interpretar o contexto das mensagens. A IA entra quando não houver match no menu ou conforme a opção abaixo. O sistema envia automaticamente a estrutura de menus (opções e destinos) para a IA; use os exemplos abaixo para “treinar” respostas comuns.
Ligar / Desligar IA
Com a IA desligada, ela não será usada na conversa nem na caixa "Solicitar à IA" abaixo.
Solicitar à IA
Digite o que você quer que a IA implemente. O sistema envia automaticamente o que a IA precisa (estrutura atual do bot, formato JSON aceito). A IA responde em JSON e o sistema aplica na hora (cria rascunhos). Você só vai em Rascunhos (IA) testar e aprovar.
Ex.: "Crie um menu para identificação e cadastro de paciente" → a IA gera menu, bloco e funções; tudo vira rascunho para você revisar. Para fluxos grandes, aumente Max tokens na Configuração abaixo.
Quando ativo, a IA vê as mensagens anteriores e você pode responder "sim", "crie o fluxo", etc. Use "Limpar conversa" para recomeçar.
Cada envio é um pedido independente. Se a IA perguntar algo, digite o pedido completo na próxima mensagem.
Histórico da IA
Rascunhos e ideias que a IA já criou ou registrou. Use os links para ir direto à seção de revisão.
Configuração
Ollama local: http://localhost:11434. API externa: URL completa do endpoint (ex.: https://api.openai.com/v1/chat/completions).
Instrução fixa que define o papel da IA (ex.: “Você auxilia o bot. Responda curto. Se identificar a opção do menu, termine com [OPCAO:valor].”).
Uma linha por exemplo: mensagem do usuário|opção. A IA usa esses exemplos para interpretar melhor. Ex.: quero agendar|1, qual meu exame|2.
Chat com IA
Converse com a IA para criar fluxos, menus, blocos, funções, ideias e regras de palavra-chave (Start). Abaixo de cada resposta, itens criados aparecem como chips clicáveis (abrem o JSON).
Config (afeta este chat)
Importar / Aplicar JSON como rascunho
Cole aqui o JSON completo (ex.: FLUXO_BIOCLINICA_IA.json) e clique em aplicar. O sistema executará como se fosse a IA e criará tudo como rascunhos para você testar e aprovar.
Conversa
Interpretar (menu)
Quando o usuário digita algo que não bate com nenhuma opção do menu, a IA pode interpretar a intenção e mapear para uma opção. Configure aqui os toggles que afetam essa função.
Start (palavras-chave)
Regras aplicadas em qualquer estado: quando o usuário digitar a palavra-chave, o bot redireciona para o destino. A IA pode criar ou sugerir regras — use o Chat com IA e peça ex.: "Crie regra: palavra 'sair' → encerramento sair".
Logs
| Data | Telefone | Direção | Mensagem |
|---|