Logica: Chatbot IA

Quando usar

• Atender clientes automaticamente via WhatsApp, Telegram ou outros canais omni


• Criar um assistente de suporte que responde perguntas frequentes e, quando necessario, transfere para um humano


• Automatizar o primeiro atendimento de um chat com triagem inteligente


• Construir um bot de vendas que consulta produtos em tabelas e responde com informacoes atualizadas

---

Como funciona

Diferente do node Agente IA* (que executa uma unica chamada), o Chatbot e projetado para *conversas continuas. Ele carrega automaticamente o historico de mensagens do chat, envia para o modelo de IA junto com as instrucoes, e devolve a resposta ao usuario no mesmo canal.

O Chatbot tambem pode chamar ferramentas autonomamente (ex: buscar dados em tabelas, criar contatos) e decidir quando transferir o atendimento para um humano (handoff).

Saidas (portas)

| Porta | Descricao |
|-------|-----------|
| Sucesso | O fluxo segue por aqui quando a IA responde com sucesso |
| Handoff | O fluxo segue por aqui quando a IA decide transferir para um atendente humano |
| Erro | O fluxo segue por aqui se houver falha na chamada da IA |

---

Configuracoes

O Chatbot possui diversas secoes de configuracao organizadas em paineis colapsaveis:

1. Identidade & Persona

Configura a personalidade e identidade do chatbot.

#### Nome do Bot

Campo de texto opcional. Se preenchido, a IA se identificara com este nome nas conversas.

Exemplos: "Aria", "Max", "Luna", "Atendente Virtual"

#### Tom de Voz

Define o estilo de comunicacao da IA.

| Tom | Descricao |
|-----|-----------|
| Profissional | Formal e objetivo |
| Amigavel | Casual e acolhedor |
| Tecnico | Detalhado e preciso |
| Conciso | Direto ao ponto |
| Empatico | Compreensivo e atencioso |

Valor padrao: Profissional

#### Idioma

Define o idioma das respostas da IA.

| Idioma | Descricao |
|--------|-----------|
| Automatico | Detecta o idioma do usuario e responde no mesmo idioma |
| Portugues (BR) | Sempre responde em portugues brasileiro |
| English | Sempre responde em ingles |
| Espanol | Sempre responde em espanhol |

Valor padrao: Automatico

---

2. Instrucoes do Sistema

Campo de texto principal que define o comportamento, conhecimento e limites da IA. Aceita variaveis de nodes anteriores.

Aqui voce descreve:


• O que o chatbot faz e nao faz


• Quais assuntos ele domina


• Quando deve transferir para um humano


• Regras de negocio especificas

#### Gerar com IA (Assistente de Prompt)

Botao que abre um dialogo interativo onde voce descreve o negocio em linguagem natural e a IA gera automaticamente um prompt otimizado. Funciona como um chat:

• Voce descreve o cenario (ex: "E uma clinica veterinaria com 3 veterinarios, atende por WhatsApp...")


• A IA gera um prompt completo e estruturado


• Voce pode pedir ajustes conversando mais


• Ao clicar "Aplicar", o prompt gerado e inserido no campo de instrucoes

O assistente detecta automaticamente as ferramentas configuradas e as considera na geracao do prompt.

---

3. Ferramentas

Secao onde voce define ferramentas (tools) que a IA pode usar durante a conversa. A IA decide autonomamente quando usar cada ferramenta com base no contexto da conversa.

As ferramentas disponiveis incluem operacoes com:

• Tabelas (buscar, criar, atualizar, deletar registros)


• Contatos (buscar, criar, atualizar, deletar)


• Projetos (buscar, criar, atualizar, deletar, gerenciar membros)


• Agendas (buscar, criar, atualizar, deletar agendas e eventos)


• Reunioes (buscar, criar, atualizar, deletar salas e eventos)

Um contador mostra quantas ferramentas estao configuradas.

---

4. Modelo & Resposta

#### Modelo de IA

Seletor do modelo a ser utilizado. A lista mostra os modelos disponiveis com nome e provedor (ex: "GPT-4o" / OpenAI).

#### Temperatura

Slider de 0 a 1 (em incrementos de 0.1) que controla a criatividade da IA.

| Valor | Comportamento |
|-------|---------------|
| 0 | Respostas mais precisas e repetitivas |
| 0.2 | Valor padrao do chatbot -- equilibrio entre consistencia e naturalidade |
| 1 | Respostas mais variadas e criativas |

#### Maximo de Tokens

Campo numerico que limita o tamanho de cada resposta da IA. Deixe vazio para nao impor limite.

#### Formato de Resposta

Define o estilo de formatacao das respostas.

| Formato | Descricao |
|---------|-----------|
| Automatico | A IA decide o melhor formato para cada resposta |
| Curto | Respostas de 1-2 frases, diretas ao ponto |
| Detalhado | Explicacoes completas e contextualizadas |
| Topicos | Respostas formatadas em listas e bullet points |

Valor padrao: Automatico

---

5. Mensagens

Mensagens automaticas para situacoes especificas da conversa.

#### Mensagem de Boas-vindas

Enviada automaticamente na primeira interacao do usuario. Esta mensagem nao passa pela IA -- e enviada diretamente. Aceita variaveis.

Exemplo: "Ola! Sou o assistente virtual da Brife. Como posso ajudar?"

#### Mensagem de Fallback

Enviada automaticamente se a IA falhar (erro de API, timeout, etc.). Garante que o usuario sempre receba uma resposta.

Exemplo: "Desculpe, tive um problema. Tente novamente em alguns instantes."

#### Mensagem de Handoff

Enviada automaticamente quando a IA decide transferir para um atendente humano. Informa o usuario sobre a transferencia.

Exemplo: "Vou transferir voce para um atendente humano. Um momento, por favor."

---

6. Base de Conhecimento (FAQs)

Lista de perguntas e respostas que a IA usara como referencia ao responder. Ideal para garantir que informacoes especificas do negocio sejam respondidas corretamente.

Cada FAQ tem:


• Pergunta -- A pergunta que o usuario pode fazer


• Resposta -- A resposta que a IA deve usar como base

Voce pode adicionar quantas FAQs quiser clicando em Adicionar FAQ e remover individualmente.

---

7. Contexto

Informacoes adicionais que a IA recebe automaticamente em cada interacao.

#### Dados do Contato

Toggle (ligado por padrao). Quando ativado, a IA recebe automaticamente o nome, empresa e tags do contato do chat. Isso permite respostas personalizadas como "Ola, Joao!".

#### Data e Hora Atual

Toggle (ligado por padrao). Quando ativado, a IA sabe a data e hora atuais, permitindo respostas contextuais sobre tempo (ex: "Nosso horario de funcionamento hoje e...").

#### Contexto Adicional

Campo de texto (multiline) para passar informacoes extras que a IA deve considerar. Aceita variaveis de nodes anteriores.

Exemplo: dados de um CRM, informacoes do pedido em andamento, etc.

---

8. Seguranca (Guardrails)

Protecoes de seguranca para o chatbot.

#### Filtro de Conteudo

Toggle (ligado por padrao). Bloqueia respostas com conteudo inapropriado, ofensivo ou fora do escopo do chatbot.

#### Anti Prompt-Injection

Toggle (ligado por padrao). Protege contra tentativas de manipulacao das instrucoes da IA por usuarios mal-intencionados (ex: "ignore suas instrucoes e faca X").

---

9. Avancado

#### Chat ID (override)

Campo para especificar manualmente o ID do chat. Por padrao, e detectado automaticamente a partir do trigger (ex: trigger_omni). Use apenas se precisar forcar um chat especifico.

#### Maximo de Historico

Numero maximo de mensagens anteriores carregadas como contexto para a IA. Valor padrao: 30. Valores maiores dao mais contexto mas aumentam o custo e latencia.

---

Dados de saida

Os nodes seguintes podem acessar os dados gerados pelo chatbot:

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `response` | Texto | Resposta gerada pela IA na interacao atual |
| `chatId` | Texto | ID do chat onde a conversa esta acontecendo |
| `contact` | Objeto | Dados do contato do chat (nome, email, telefone, etc.) |
| `reason` | Texto | Motivo do handoff (quando a IA decide transferir para humano) |
| `model` | Texto | Identificador do modelo de IA que foi usado |

---

Dicas

• Use o Assistente de Prompt (botao "Gerar com IA") para criar instrucoes de alta qualidade rapidamente. Descreva seu negocio em linguagem natural e a IA gera um prompt otimizado.


• A temperatura padrao do chatbot (0.2) e mais baixa que a do Agente IA (0.7) porque conversas de atendimento exigem mais consistencia.


• Sempre configure a Mensagem de Fallback para garantir que o usuario nunca fique sem resposta em caso de erro.


• As FAQs sao muito uteis para informacoes factuais do negocio (horarios, precos, enderecos). A IA usa as FAQs como referencia, mas responde com naturalidade -- nao copia literalmente.


• Mantenha as protecoes de Seguranca ativadas em producao. O filtro de conteudo e anti prompt-injection protegem contra usos indevidos.


• Conecte a porta Handoff a um node que atribua o chat a um atendente humano ou envie uma notificacao para a equipe.


• O Maximo de Historico de 30 mensagens e adequado para a maioria dos cenarios. Aumente se as conversas forem muito longas, ou diminua se quiser economizar tokens.


• As ferramentas transformam o chatbot em um assistente poderoso: ele pode consultar tabelas, criar registros, agendar reunioes e mais, tudo de forma autonoma durante a conversa.