Chatbot com IA

​

Onde fica

​

Ligar e desligar o módulo

• nenhum bot responde no WhatsApp, mesmo os marcados como ativos;
• a lista de bots e as abas de cada bot (conector de API, identidade, configuração e conversas) ficam ocultas. Se alguém abrir um link direto, volta para a tela do Chatbot WhatsApp;
• a Base de Conhecimento continua disponível se o Chatbot do site estiver ativo, porque ele usa a mesma base;
• as configurações, a base de conhecimento e o histórico continuam salvos. As mensagens recebidas continuam sendo registradas, só não recebem resposta automática.

​

Criar um bot

• Cada bot atende exatamente um número de WhatsApp, e cada número só pode ter um bot. A lista de conexões mostra só as que ainda não estão em uso. Se nenhuma aparecer, a tela avisa Nenhuma conexão de WhatsApp livre: conecte um número novo em WhatsApp.
• A conexão do bot não pode ser trocada depois da criação. Para atender em outro número, crie um novo bot.
• O painel não tem opção para renomear um bot. Para liberar um número já vinculado, exclua o bot (veja Excluir um bot).
• O bot nasce inativo: ele só responde depois que você marcar Bot ativo no WhatsApp e salvar.
• Um número conectado que não tem bot não recebe resposta automática.

​

Configuração do bot

​

Instruções da empresa

​

Meu LLM (opcional)

1. Escolha o Provedor: Anthropic (Claude), OpenAI, Grok (xAI) ou DeepSeek.
2. Escolha o Modelo desse provedor.
3. Cole a Chave de API e clique em Salvar token.

​

Excluir um bot

• São apagados a configuração, a identidade, os conectores de API, as conversas e o histórico de mensagens daquele bot. A exclusão não pode ser desfeita.
• A base de conhecimento continua: ela é da empresa, não do bot.
• O número de WhatsApp fica livre para você criar outro bot nele.
• O assistente do Chatbot do site não é excluído por aqui.

​

Base de conhecimento

​

Adicionar uma fonte

​

Site inteiro

• Mapear de novo lê o site outra vez: procura páginas novas e lê de novo as que já estavam na base.
• Numa página, Reprocessar lê só aquela página de novo, e Remover (com confirmação) tira os trechos dela da base. Uma página removida não volta quando o site é mapeado de novo; para trazê-la de volta, use Incluir de novo na tabela.
• Excluir apaga o site e todas as páginas lidas dele.
• O escopo vale para todas as páginas do site. Para trocar, exclua o site e mapeie de novo.
• Um mesmo site só pode ser cadastrado uma vez. Para atualizá-lo, use Mapear de novo.
• A tela avisa quando o mapeamento para no limite de 500 páginas e quando o site parece montado por JavaScript, caso em que o conteúdo não pode ser lido.

• Tamanho máximo: 50 MB por arquivo. O mesmo limite vale para a página baixada de uma URL.
• PDF: até 500 páginas.
• Imagens e documentos digitalizados: o texto é reconhecido automaticamente (OCR), em português e em inglês.
• URL: precisa ser um endereço público. Endereços internos ou inválidos são recusados. A página tem 30 segundos para responder e pode redirecionar até 5 vezes.
• Tempo de leitura: a leitura de PDF, Word, PowerPoint, Excel, imagem e URL roda em segundo plano. Se não terminar em 15 minutos, a plataforma tenta um método de leitura alternativo (disponível para PDF, Word e URL). Sem alternativa, a fonte fica com erro e você pode reprocessar.

​

Status da fonte

• fontes com erro não são consultadas;
• uma fonte que está sendo reprocessada continua respondendo com o conteúdo anterior até a nova leitura terminar.

​

Mensagens de erro

​

Escopo

• Compartilhado — vale para todas as conversas.
• Privado a um sub-cliente — vale só para as conversas de um cliente específico do seu sistema. Útil quando cada cliente tem regras, contratos ou condições próprias. Informe o ID do sub-cliente, exatamente o mesmo identificador que o seu sistema devolve na identificação do usuário (veja abaixo).

​

Editar, reprocessar e excluir

• O tipo de uma fonte não muda. Para trocar, exclua e cadastre de novo.
• Em fontes do tipo arquivo, Baixar arquivo gera um link temporário para o arquivo original.
• Reprocessar (na lista ou na página da fonte) lê o conteúdo de novo sem alterar nada.
• Excluir pede confirmação e remove a fonte e os trechos dela.
• Se a tela avisar que as alterações foram salvas mas o reprocessamento não começou, use Reprocessar.

​

Tom de voz

• A plataforma traz 20 tons prontos, em cinco grupos: Corporativos e profissionais, Proximidade e relacionamento, Autoridade e impacto, Educacionais e criativos e Suporte e vendas.
• Use Definir como padrão para escolher o tom da conta. Sem escolha, a IA usa o tom Formal.
• Em Criar tom personalizado você escreve um tom da sua marca: Nome (até 60 caracteres, sem repetir o nome de outro tom seu), Descrição (até 300) e Instruções para a IA (até 2.000). Nome e instruções são obrigatórios. Tons personalizados podem ser editados e excluídos; os prontos, não.
• Cada bot pode usar um tom diferente do padrão, no campo Tom de voz da aba Configuração do Bot. As etapas de IA das automações também podem escolher o tom.
• Ao excluir um tom, os bots e as automações que o usavam passam a seguir o padrão da conta. Se o tom excluído era o padrão, a IA volta ao Formal.

​

Identificação do usuário

​

Credencial dos endpoints

• A credencial fica cifrada e nunca volta para a tela: o bloco mostra só Configurada ou Não configurada, com o campo mascarado. Para trocar, use Substituir e salve a nova.
• Remover credencial pede confirmação. Sem credencial, os endpoints passam a ser chamados sem autenticação; se a sua API exigir o token, o bot deixa de identificar os clientes até você salvar uma nova.
• Salvar os demais campos da aba Identidade não mexe na credencial salva.

​

Como a identificação acontece

1. Na primeira mensagem que o bot processa numa conversa, a OctaSend envia o telefone ao endpoint de resolução. Se o seu sistema reconhecer o número, a conversa já fica identificada. Se não reconhecer (ou se a identificação foi ligada depois que a conversa começou), a consulta pelo telefone é repetida nas mensagens seguintes, no máximo uma vez por hora, enquanto a conversa não estiver identificada nem aguardando a credencial.
2. Sem identificação, o cliente conversa normalmente: o bot usa só o conteúdo compartilhado da base e só as consultas à API que não exigem identificação (veja Parâmetro de escopo, mais abaixo). Isso permite, por exemplo, navegar por um catálogo público.
3. Quando o pedido exige saber quem é o cliente (comprar, ver pedidos, dados da conta), o bot pede a credencial usando a mensagem de desafio. Sem mensagem configurada, ele pede o CPF ou o e-mail cadastrado.
4. A mensagem seguinte do cliente é enviada ao endpoint de validação. Se o seu sistema confirmar, a conversa fica identificada; se não, o bot envia a mensagem de desafio de novo (sem mensagem configurada, pede para tentar novamente).

​

O que o seu sistema recebe e devolve

{
  "phone": "5511999999999"
}

{
  "phone": "5511999999999",
  "credential": "123.456.789-00"
}

{
  "sub_client_id": "cliente-4821"
}

• Responda com status 2xx e sub_client_id preenchido como texto (entre aspas, mesmo que o seu ID seja numérico, ex.: "4821") quando reconhecer o cliente. Um valor numérico conta como não identificado.
• Qualquer outra resposta (status de erro, sub_client_id vazio ou ausente, falha de conexão) conta como não identificado. Uma recusa por falta de autenticação também: se os seus endpoints exigem token, configure a credencial dos endpoints.

​

Consultar seus sistemas

​

Importar um conector

​

Como a especificação vira ferramentas

• Cada operação GET, POST, PUT, PATCH ou DELETE vira uma ferramenta.
• O nome da ferramenta é o operationId. Sem ele, a plataforma gera um nome a partir do método e do caminho.
• O summary é a descrição que o bot lê para decidir quando usar a ferramenta. operationId e summary descritivos melhoram bastante a qualidade das respostas.
• Os parâmetros de caminho e de query e as propriedades do corpo JSON (application/json) viram os campos que o bot preenche.

• parâmetros de caminho (/pedidos/{id}) são substituídos na URL;
• em GET e DELETE, os demais campos vão na query string;
• em POST, PUT e PATCH, os demais campos vão no corpo, em JSON;
• a resposta da sua API é repassada ao bot do jeito que chega, para ele montar a resposta ao cliente.

​

Parâmetro de escopo

• a ferramenta só fica disponível depois que a conversa foi identificada;
• o valor desse campo é sempre o sub-cliente da identificação, substituindo qualquer valor que o modelo de IA tenha tentado informar.

​

Reimportar e excluir

• Importar de novo um conector com o mesmo nome no mesmo bot atualiza a especificação e substitui a lista de ferramentas: elas voltam todas ativas e sem parâmetro de escopo, então revise-as depois. Se você deixar a credencial em branco, a anterior é mantida.
• Excluir um conector pede confirmação e remove também todas as ferramentas dele.

​

Pagamento por PIX

{
  "pix": {
    "copia_e_cola": "00020126...",
    "qr_code_base64": "iVBORw0KGgo..."
  }
}

• copia_e_cola — o código é enviado numa mensagem separada, para o cliente copiar com facilidade, e é retirado do texto da resposta para não aparecer duplicado.
• qr_code_base64 — uma imagem PNG em base64, enviada como imagem depois do texto.

​

Como o atendimento acontece

1. O cliente manda uma mensagem para o número de um bot. Mensagens em grupos de WhatsApp nunca acionam o bot.
2. O bot só responde se o módulo estiver ligado, o bot estiver marcado como ativo e a conversa não estiver pausada por um atendente (veja Quando uma pessoa assume a conversa). Em qualquer outro caso, a mensagem fica registrada sem resposta.
3. Se a mensagem for de voz, ela é transcrita conforme a configuração de mensagens de voz. Imagem, vídeo ou documento com legenda recebem resposta à legenda (o bot não enxerga o arquivo). Arquivos e figurinhas sem texto não recebem resposta.
4. O bot tenta identificar o cliente, se a identificação estiver configurada.
5. Se a base de conhecimento estiver ligada no bot, ele busca os trechos mais relevantes para a mensagem.
6. Se precisar de dado ao vivo, chama a sua API pelas ferramentas do conector, até o limite de chamadas por turno.
7. Responde ao cliente, seguindo as instruções da empresa, as instruções do bot e o tom de voz. Se o modelo de IA não produzir texto, envia a mensagem de fallback.

​

Mensagens de voz

​

Quando uma pessoa assume a conversa

• Ao enviar uma mensagem manual, o bot fica pausado por 30 minutos naquela conversa. Cada novo envio manual reinicia os 30 minutos. Passado esse tempo, o bot volta a responder sozinho.
• Enquanto a pausa durar, a conversa aparece com o aviso Bot pausado na lista, e as mensagens do cliente continuam sendo registradas, sem resposta automática. Dentro da conversa, a faixa Bot pausado até HH:MM tem o botão Reativar bot, que devolve a conversa ao bot na hora, sem esperar os 30 minutos.
• A mensagem manual aparece no histórico com Enviado por e o nome de quem enviou.
• Responder pelo aplicativo do WhatsApp no celular não pausa o bot: só o envio pelo painel pausa.
• O envio manual pelo painel funciona em conversas de números conectados via QR code (Evolution API). A mensagem sai pelo mesmo número em que o cliente escreveu. Se esse número estiver desativado, o envio é recusado com um aviso para reativá-lo, em vez de sair por outro número.

​

Acompanhar as conversas

​

Perguntas frequentes

​

Pré-requisito