Criar o ALLBOOT
Guia do All-Bot (para o Suporte)
O All-Bot é o bot de atendimento por fluxo visual da Allenda. A empresa desenha o fluxo (menus, perguntas, consultas a sistemas, chamados, CRM, transferência para atendentes) num editor de blocos, liga o fluxo aos canais de WhatsApp e o bot passa a atender sozinho.
Este guia explica o que é preciso para usar, como configurar cada parte, como o bot se comporta numa conversa e como investigar os problemas mais comuns.
Sumário
- Onde fica e o que é preciso
- Quem pode fazer o quê
- Como o bot atende uma conversa
- Criar e publicar um fluxo
- O editor
- Configurações do fluxo
- Ligações entre blocos
- Os blocos, um por um
- Variáveis
- Chamada API e Segredos
- Relatório, Excel e Execuções
- Exemplos prontos (adminws)
- Problemas comuns
- Limites e números
1. Onde fica e o que é preciso
Onde fica: Configurações › Bots › aba All-Bot. A aba só aparece quando o módulo está liberado para a empresa.
Checklist para a empresa começar a usar:
| Item | Onde se configura |
|---|---|
| Módulo All-Bot liberado para a revenda | Painel Master › Planos / módulos da revenda |
| Módulo All-Bot ligado para a empresa | Cadastro da empresa (revenda) › Módulos |
| Usuário com perfil Gestor para montar o fluxo | Usuários da empresa |
| Pelo menos um canal de WhatsApp conectado | Canais |
Canais que o All-Bot atende:
| Canal | Funciona? | Observação |
|---|---|---|
| WhatsApp oficial (Meta / Cloud API) | Sim | Menus aparecem como botões (até 3 opções) ou lista (até 10). |
| WAHA (não oficial) | Sim | Menus aparecem como texto numerado. |
| Zender (não oficial) | Sim | Menus aparecem como texto numerado. |
| Evolution | Não | Canal desativado para o All-Bot. |
Um canal atende com um fluxo só. Um mesmo fluxo pode atender vários canais.
Alguns blocos dependem de cadastros prévios:
| Bloco | Precisa ter cadastrado |
|---|---|
| Transferir para Setor | Setores |
| Transferir para Usuário | Atendentes (usuários) |
| Abrir Chamado | Categorias de chamado (opcional) |
| Agente de IA | Um agente de IA cadastrado (Configurações › Inteligência Artificial) |
| CRM (lead e negócio) | Funil e etapas do CRM |
| Mapeamento de Origem | Origens do CRM (Configurações do CRM › Origens) |
| Botão IA (criar fluxo conversando) | Conta de IA da empresa (Configurações › Inteligência Artificial) |
2. Quem pode fazer o quê
| Ação | Gestor (e superadmin) | Gerente e demais perfis |
|---|---|---|
| Ver a lista de fluxos e abrir um fluxo | Sim | Sim, somente visualização |
| Criar, editar, importar, usar a IA, salvar, publicar, despublicar, excluir | Sim | Não |
| Canais do fluxo, Segredos, Configurações do fluxo | Sim | Não |
| Simulador e “Testar API” | Sim | Não (podem chamar sistemas de verdade) |
| Relatório do fluxo, Excel e Execuções | Sim | Não |
Quem só visualiza vê o aviso “Somente visualização”: sem paleta de blocos, sem arrastar, sem ligar ou apagar blocos, com todos os campos travados.
Usuário desativado, ou empresa/revenda bloqueada, perde o acesso ao All-Bot na hora (não precisa esperar o login expirar).
3. Como o bot atende uma conversa
- Chega uma mensagem num canal. Se esse canal está ligado a um fluxo publicado e o módulo está ativo, o All-Bot assume. Caso contrário, a mensagem segue o caminho de antes (bot antigo / atendimento normal).
- O fluxo começa pelo bloco marcado Início (o primeiro bloco que não recebe nenhuma ligação).
- O bot executa os blocos em sequência até chegar num bloco que espera resposta (menu ou pergunta). A conversa aparece no painel enquanto o bot atende.
- A resposta do contato decide o próximo caminho (pelas ligações). O bot continua de onde parou.
- A conversa termina quando o fluxo chega em *Encerramento, numa *transferência (setor ou atendente) ou no fim dos blocos.
Regras importantes:
- Atendente assumiu = bot quieto. Se a conversa foi transferida ou um atendente pegou o atendimento, o bot para de responder. Depois disso, se o contato voltar a falar com o bot, o fluxo recomeça do início (nunca do meio).
- O bot só entende texto. Mídia sem legenda (foto, áudio) é ignorada pelo fluxo.
- Contato sumiu: depois do tempo de “Recomeçar o fluxo” (padrão 30 minutos), a próxima mensagem começa o fluxo do início. No relatório isso conta como “desistiu”.
- Respostas erradas seguidas: depois do limite (padrão 3), o fluxo segue pela saída “Respostas inválidas esgotadas” do bloco; se ela não existir, o bot avisa “Não consegui entender suas respostas. Vou te passar para um atendente.” e transfere para a fila.
- Mensagens do mesmo contato são processadas em ordem, uma de cada vez.
- Fluxo republicado no meio de uma conversa: se o bloco em que o contato estava foi apagado, a próxima mensagem recomeça do início.
4. Criar e publicar um fluxo
Formas de criar
| Botão | O que faz |
|---|---|
| Novo fluxo | Fluxo em branco (nome e descrição). |
| Importar JSON | Carrega um arquivo .allbot.json (ou os antigos .typebot.json). Antes de criar, mostra um resumo com os sistemas que o fluxo chama e os segredos usados. Credenciais digitadas direto no arquivo são removidas. |
| Baixar modelo | Baixa um fluxo de exemplo para importar e adaptar. |
| IA | Chat que monta o fluxo a partir de uma descrição (“Menu com Comercial, Suporte e Financeiro…”). Também dá para anexar um JSON e pedir ajustes. Usa a conta de IA da empresa. O fluxo gerado passa pela mesma checagem do Importar. |
Passo a passo
- Crie o fluxo e abra o editor (ícone de lápis).
- Arraste os blocos da paleta e ligue um no outro (veja Ligações).
- Configure cada bloco no painel da direita (clique no bloco).
- Salvar grava o rascunho. O fluxo ainda não atende.
- Canais: marque os canais que esse fluxo vai atender.
- Simular (opcional): converse com o fluxo dentro do editor para testar o caminho.
- Publicar: o sistema confere o fluxo (blocos sem configuração, funil sem etapa, credencial digitada direto etc.). Se houver erro, aparece a lista “Corrija antes de publicar”; clique no erro para ir até o bloco.
- Depois de publicado, o selo fica Publicado. Alterações novas ficam como “Publicado · alterações não publicadas” até publicar de novo.
Despublicar faz o fluxo parar de atender (as mensagens voltam ao caminho normal).
5. O editor
| Recurso | Como usar |
|---|---|
| Mover a tela | Arrastar o fundo, ou segurar Espaço / Ctrl / ⌘. Trackpad: dois dedos. |
| Zoom | Pinça no trackpad, Ctrl+scroll ou os botões + / −. Botão de encaixe enquadra o fluxo todo. |
| Selecionar vários | Shift + arrastar (caixa de seleção). Ctrl+A seleciona tudo. Arrastar um move todos. |
| Apagar | Lixeira no bloco ou tecla Delete. |
| Ligar blocos | Arrastar da bolinha de baixo de um bloco até a bolinha de cima do outro. |
| Curvar uma linha | Arrastar a etiqueta (ou o meio) da linha. Para endireitar: arrastar de volta ao meio ou “Endireitar linha” no diálogo da ligação. |
| Formatar | Organiza o fluxo em camadas, do início para baixo, e endireita as linhas. Aparece o aviso “Fluxo formatado” com Desfazer. |
| Tela inteira | Botão de expandir (ESC sai). |
| Simular | Testa o fluxo no próprio editor; o bloco atual acende no canvas. Chamadas de API no simulador são reais. |
| Exportar JSON | Baixa o fluxo (.allbot.json). Nunca leva valores de segredos nem setores/atendentes da empresa. Opção de remover URLs, headers e body das Chamadas API para compartilhar. |
| Segredos (ícone de chave) | Cofre de tokens e senhas das APIs (veja Segredos). |
O card de cada bloco mostra um resumo da configuração (ex.: “POST https://…” na Chamada API, “⚠️ Escolha o setor” quando falta algo).
6. Configurações do fluxo
Botão Configurações no topo do editor. Valem assim que o fluxo é salvo (não precisa publicar de novo).
| Opção | O que faz | Valores |
|---|---|---|
| Intervalo entre mensagens | Espera antes de cada mensagem do bot, mostrando “digitando…” | Na hora, 1, 2, 3, 4, 5, 7 ou 10 segundos |
| Recomeçar o fluxo se o contato sumir | Depois desse tempo sem resposta, a próxima mensagem começa do início | 15 min, 30 min (padrão), 1 h, 2 h, 4 h, 12 h, 1 dia ou Nunca |
| Respostas inválidas antes de transferir | Quantas respostas erradas seguidas num menu/pergunta | Sem limite, 2, 3 (padrão), 4, 5 ou 10 |
7. Ligações entre blocos
Ao ligar dois blocos, abre o diálogo da ligação para escolher quando o fluxo segue por ela.
Saindo de um menu (Mensagem com opções) ou Pergunta:
| Tipo | Quando segue |
|---|---|
| Resposta exata | A resposta é exatamente o valor (o valor da opção do menu, ex.: 1 ou sim). |
| Contém texto | A resposta contém o texto. |
| Padrão (fallback) | Nenhuma outra ligação serviu. |
| Respostas inválidas esgotadas | O contato errou o limite de vezes seguidas. Sem essa ligação, transfere para a fila. |
Saindo de blocos com resultado (duas saídas):
| Bloco | Saída de sucesso | Saída de erro |
|---|---|---|
| Chamada API | API: sucesso | API: erro (erro, tempo esgotado ou resposta fora de 2xx) |
| Agente de IA | IA: saiu da conversa (palavra de saída, ex.: “menu”) | IA: precisa de humano (pediu atendente, IA pediu transferir, falhou ou bateu o limite) |
| Consultar Chamado | Chamado encontrado | Chamado não encontrado |
| CRM | CRM: cadastrado | CRM: erro (ex.: o contato já é cliente) |
| Enviar Mídia | Mídia enviada | Sem arquivo (link vazio ou inválido) |
| Condição | Verdadeiro | Falso |
| Horário de Atendimento | Dentro do horário | Fora do horário (dia fechado ou feriado) |
| Mapeamento de Origem | Origem aplicada | Nenhuma frase bateu |
Sem ligação específica, vale a Padrão (fallback).
Cuidado comum: a ligação “Resposta exata” deve ter um valor só (ex.: 1). Valores como 7, consultar não funcionam.
8. Os blocos, um por um
Conversa
Mensagem / Menu
- Envia um texto. Com opções (rótulo + valor), vira um menu e espera a resposta.
- Exibição: texto, botões ou lista. Botões e lista nativos só no WhatsApp oficial (até 3 botões; de 4 a 10 vira lista; texto até 1024 caracteres). Nos demais canais, ou com mais de 10 opções, sai como menu numerado.
- O contato pode responder com o número, o texto da opção ou o valor.
- “Mensagem de opção inválida”: o que o bot diz antes de repetir o menu.
- Cria {{opcao_escolhida}} (rótulo da opção) ou {{resposta}} (texto digitado, quando não bateu com uma opção mas seguiu por “Contém”/”Padrão”).
Pergunta
- Pergunta e guarda a resposta numa variável (ex.: documento).
- Validação: Qualquer texto, Número (guarda só os dígitos), CPF, CNPJ ou E-mail. Resposta inválida repete a pergunta.
- Atenção com “Número”: ele remove tudo que não é dígito. 50,00 vira 5000. Para valores em dinheiro, prefira “Qualquer texto”.
- Uma pergunta guarda uma resposta. Para vários dados, use uma pergunta para cada.
Enviar Mídia
- Imagem, documento (PDF, planilha), áudio ou vídeo, por link público ou arquivo enviado do computador.
- Arquivo enviado fica guardado no armazenamento de mídia do WhatsApp (R2), até 20 MB.
- O link aceita variável (ex.: {{link_boleto}} vindo de uma Chamada API).
- No WhatsApp oficial a Meta limita: imagem 5 MB, áudio e vídeo 16 MB, documento 100 MB.
- Saídas: Mídia enviada / Sem arquivo.
Lógica
Condição
- Compara Se (ex.: {{saldo}}) com um valor: é igual, diferente, contém, não contém, maior, maior ou igual, menor, menor ou igual, está vazio, não está vazio.
- Números aceitam 12.50, 12,50 e R$ 1.234,56. Texto compara sem diferenciar maiúsculas e acentos.
- Saídas: Verdadeiro / Falso.
Horário de Atendimento
- Dias da semana com horário de início e fim, e feriados (MM-DD todo ano ou AAAA-MM-DD). Fuso de São Paulo.
- Saídas: Dentro do horário / Fora do horário.
Definir Variável
- Grava um valor numa variável, ou soma a um número que já existe (ex.: contador de tentativas).
Ações
Chamada API
- Consulta ou envia dados para outro sistema (ex.: saldo, faturas, rastreio). Detalhes na seção 10.
- Saídas: API: sucesso / API: erro.
Agente de IA
- A conversa passa a ser com um agente de IA cadastrado. Cada mensagem do contato vai para a IA até:
- uma palavra de saída (ex.: menu, sair) → saída “IA: saiu da conversa”;
- o contato pedir atendente, a IA pedir para transferir, a IA falhar ou bater o máximo de turnos → saída “IA: precisa de humano”.
- A IA lembra as últimas 20 mensagens da conversa.
Transferir para Setor / Transferir para Usuário
- Envia a mensagem de transferência (opcional) e passa a conversa para o setor ou atendente escolhido. O bot sai da conversa.
- Setor ou atendente que não pertence mais à empresa: a conversa vai para a fila geral.
Chamados e CRM
Abrir Chamado
- Abre um chamado no sistema com categoria, assunto, descrição e prioridade (aceitam variáveis).
- *Mensagem com o número do chamado: enviada ao contato assim que abre. Use {{protocolo_chamado}}. Blocos novos já vêm com: *”✅ Chamado aberto! Seu protocolo é {{protocolo_chamado}}. Guarde esse número para consultar o andamento depois.”
- “Se não conseguir abrir”: mensagem quando falha.
- Cria {{protocolo_chamado}}.
Consultar Chamado
- Mostra o status de um chamado pelo protocolo (padrão {{protocolo}}, normalmente vindo de uma Pergunta).
- Cria {{chamado_protocolo}}, {{chamado_status}}, {{chamado_assunto}}, {{chamado_atualizado}}, {{chamado_responsavel}} e {{protocolo_consultado}}.
- Saídas: Chamado encontrado / Chamado não encontrado.
CRM (Lead / Negócio)
- “O que fazer”: só cadastrar como lead, ou cadastrar como lead e transformar em negócio no funil e etapa escolhidos.
- Se o contato já tiver lead:
- Atualizar o lead que já existe (padrão): acha o lead do contato (vinculado a ele ou com o mesmo e-mail/número) e atualiza com o que o fluxo coletou. Campo em branco no bloco não apaga nada; o nome do WhatsApp não sobrescreve o que o time editou.
- Criar outro lead (duplicar): sempre cria um lead novo.
- Quem já é cliente não vira lead (sai pela saída de erro).
- Campos: nome, empresa, e-mail, telefone, valor estimado, observações, título do negócio (aceitam variáveis). Nome e telefone em branco usam os do contato.
- Cria {{lead_id}} e {{negocio_id}}.
Mapeamento de Origem
- Compara a primeira mensagem do contato com frases exatas de campanha (sem diferenciar maiúsculas, acentos e espaços) e marca a origem do lead cadastrada para a frase.
- Cria {{origem_nome}}.
- Saídas: Origem aplicada / Nenhuma frase bateu.
Fluxo
Voltar ao Menu
- Envia uma mensagem (opcional) e volta ao início do fluxo, ou a um bloco escolhido.
Encerramento
- Envia a mensagem de encerramento (opcional) e finaliza o atendimento no painel, como o botão “Encerrar”.
9. Variáveis
Use nas mensagens e campos com chaves duplas: {{nome_da_variavel}}. O nome precisa ser idêntico, inclusive maiúsculas e minúsculas ({{cep}} é diferente de {{CEP}}).
| Variável | De onde vem |
|---|---|
| {{contato_nome}} | Nome do contato no WhatsApp |
| {{contato_telefone}} | Telefone do contato |
| {{mensagem_inicial}} | Primeira mensagem do contato nessa sessão |
| {{opcao_escolhida}} | Rótulo da opção escolhida no último menu |
| {{resposta}} | Texto digitado num menu quando seguiu por “Contém” ou “Padrão” |
| Nome que você der | Bloco Pergunta, Definir Variável, “Guardar da resposta” e “Lista da resposta” da Chamada API |
| {{api_status}}, {{api_erro}} | Status HTTP e motivo do erro da última Chamada API |
| {{protocolo_chamado}} | Depois de Abrir Chamado |
| {{chamado_status}} e outras chamado_* | Depois de Consultar Chamado |
| {{lead_id}}, {{negocio_id}} | Depois do CRM |
| {{origem_nome}} | Depois do Mapeamento de Origem |
| {{secret.NOME}} | Valor do cofre de Segredos (só dentro da Chamada API, nunca em mensagens) |
10. Chamada API e Segredos
Campos
| Campo | Para que serve |
|---|---|
| Método e URL | GET, POST, PUT, PATCH ou DELETE. A URL aceita variáveis (são codificadas automaticamente). |
| Headers | Pares chave/valor. O nome do header vai sem dois-pontos (ApiKey, não ApiKey:). |
| Body | JSON, Formulário (x-www-form-urlencoded) ou Sem body. Variáveis no JSON são escapadas automaticamente; coloque-as entre aspas: “documento”: “{{documento}}”. |
| Sucesso quando | Além do HTTP 2xx, um campo da resposta precisa existir e não ser vazio/falso, ou ser igual a um valor. Ex.: payment_url. |
| Guardar da resposta | Variável ← caminho no JSON. Ex.: saldo ← balance, status ← documento.status, primeiro ← 0.due_date. |
| Lista da resposta | Monta um texto com uma linha por item de uma lista. Caminho da lista (use . quando a resposta já é a lista), variável onde guardar, modelo da linha com {{item.campo}} e {{indice}}, máximo de itens (padrão 10, até 50). |
| Tempo limite | Padrão 10 s, até 30 s. |
| Mensagem de Sucesso / de Erro | Enviadas ao contato conforme o resultado. |
Testar API
- Valores para o teste: o editor lista as variáveis usadas na requisição; preencha com um exemplo (senão a API recebe vazio e costuma responder erro 400/422).
- O resultado mostra sucesso/erro, tempo, Variáveis guardadas e o payload (resposta da API formatada, com botão Copiar), até 8 KB.
- O teste é uma chamada real. Em APIs que criam algo (ex.: recarga), o teste cria de verdade.
- Endereços de rede interna (localhost, IPs privados) são bloqueados por segurança.
Segredos
- Cofre da empresa para tokens e senhas (ícone de chave). Guardados cifrados; o valor nunca aparece de novo na tela nem no Exportar.
- Use como {{secret.NOME}} só em URL, headers ou body.
- Cada segredo é preso a um domínio: só é enviado para o endereço cadastrado nele.
- Credencial digitada direto num campo (sem {{secret…}}) gera aviso e bloqueia a publicação.
11. Relatório, Excel e Execuções
Só para *Gestor. Botões *Relatório e Execuções no topo do editor.
Relatório do fluxo
- Período: últimos 7, 30 ou 90 dias.
- Resumo: conversas, resolvidas pelo bot, transferidas, desistiram, em andamento (com %).
- *Mapa de calor no canvas: cada bloco mostra quantas conversas passaram, quantas pararam ali e quantas vezes *falhou.
- *Exportar Excel: aba *Resumo (funil com %) e aba Blocos (por bloco: passaram, % das conversas, pararam, % que parou, falhas). Blocos apagados que tiveram conversas aparecem como “(bloco removido do fluxo)”.
Execuções
- Histórico de cada conversa que passou pelo fluxo (não é em tempo real).
- Filtros: últimas 24 horas, 7, 30 ou 90 dias; Todas, Com falha ou Sem falha.
- Cada item: contato, data, resultado (Concluída, Encerrada pelo bot, Transferida, Desistiu, Em andamento), passos e falhas.
- Ao abrir uma execução:
- no canvas, os blocos por onde passou ficam verdes com o número do passo; o que falhou fica vermelho com o motivo;
- no painel, a linha do tempo com o horário de cada passo. Clique num passo para achar o bloco.
- O que conta como falha: Chamada API que falhou (com o motivo, ex.: “API respondeu Unprocessable Entity (422)”), chamado que não abriu, chamado não encontrado, CRM (com a mensagem do sistema), Agente de IA que não respondeu, mídia com link inválido ou que o canal não enviou, respostas inválidas esgotadas, fluxo em laço.
- Não contam como falha: Condição falsa, fora do horário, nenhuma frase de campanha bateu (são caminhos previstos).
12. Exemplos prontos (adminws)
APIs do adminws (https://ws.falemaisvoip.com.br/ad/api/…). Em todas: método POST, header ApiKey = {{secret.ADMINWS_APIKEY}}, body JSON. O client_id aceita código, CPF ou CNPJ do cliente.
Consultar saldo — balance.php
- Body: {“client_id”: “{{documento}}”}
- Guardar da resposta: saldo ← balance
- Sucesso: 💰 Seu saldo atual é R$ {{saldo}}
Faturas em aberto — statements.php
- Body: {“client_id”: “{{documento}}”} — a resposta já é uma lista.
- Lista da resposta: caminho ., guardar em faturas, linha {{indice}}. 📅 {{item.due_date}} — R$ {{item.amount}} 🔗 {{item.payment_url}}, máximo 5.
- Sucesso: 📄 Suas faturas em aberto:\n\n{{faturas}}
Nota fiscal — invoices.php
- Perguntas antes: mês (mes, validação Número, ex.: 09) e ano (ano, ex.: 2026).
- Body: {“client_id”: “{{documento}}”, “month”: “{{mes}}”, “year”: “{{ano}}”}
- Lista da resposta: caminho ., guardar em notas, linha {{indice}}. 📅 Venc. {{item.due_date}} · pago em {{item.payment_date}} 🔗 {{item.url}}.
- Só traz cobranças pagas do mês. Sem nota: a API responde 404 e o bloco sai pelo erro.
Recarga de créditos — balance_add.php
Fluxo: Saldo → Mensagem com opções “Deseja fazer uma recarga?” (Sim/Não) → Pergunta do valor → Chamada API.
- Pergunta do valor: variável valor, validação Qualquer texto (não use Número).
- Body: {“client_id”: “{{documento}}”, “price”: “{{valor}}”, “payment_method”: “UNDEFINED”} (UNDEFINED = o cliente escolhe PIX, boleto ou cartão na página).
- Valor inteiro de 30 a 5000 (50,00 é recusado).
- Sucesso quando: payment_url (se o Asaas falhar, a API responde 201 sem link).
- Guardar: link_pagamento ← payment_url, vencimento ← due_date. Tempo limite 20 s.
- Atenção: cria cobrança real no Asaas (vencimento em 3 dias úteis), inclusive no “Testar API”. Em teste, use cliente de teste e cancele a cobrança depois.
Atenção de segurança: hoje essas APIs aceitam qualquer CPF/código. Quem chegar nesses blocos consegue consultar ou gerar cobrança para outro cliente. Uma checagem do telefone do contato está prevista.
13. Problemas comuns
| Sintoma | Causa provável | O que verificar / fazer |
|---|---|---|
| Bot não responde nada | Fluxo não publicado, canal não ligado ao fluxo, ou módulo desligado | Selo *Publicado; botão *Canais do fluxo; módulo All-Bot na empresa |
| Bot parou no meio | Um atendente assumiu ou a conversa foi transferida | Normal: com atendente, o bot fica quieto. Depois recomeça do início |
| Bot ignora foto ou áudio | O fluxo só entende texto | Peça para o contato responder em texto |
| Contato voltou e caiu no início | Passou o tempo de “Recomeçar o fluxo” | Ajuste em Configurações do fluxo |
| Menu repete “opção inválida” | A ligação não bate com o valor da opção | Na ligação “Resposta exata”, use o valor da opção (um só, ex.: 1) |
| Transferiu sozinho depois de respostas erradas | Limite de respostas inválidas | Configurações do fluxo, ou crie a saída “Respostas inválidas esgotadas” |
| Variável sai vazia na mensagem | Nome diferente (maiúsculas, acento, espaço) | {{cep}} ≠ {{CEP}}. Confira no bloco que guarda a variável |
| API dá erro 401/403 | Header com nome errado ou segredo errado | Nome do header sem dois-pontos; segredo cadastrado e com o domínio certo |
| API dá 400/422 no teste | Variável vazia na requisição | Preencha Valores para o teste |
| “segredo não permitido para este endereço” | Domínio do segredo diferente do da URL | Ajuste o domínio do segredo |
| “endereço de rede interna não permitido” | URL aponta para IP interno/localhost | Use o endereço público da API |
| API sempre cai no erro | “Sucesso quando” aponta para um campo que não vem | Veja o payload no Testar API e ajuste o caminho |
| Lista vazia | Caminho da lista errado | Resposta que já é uma lista: caminho . |
| Mídia não chega no WhatsApp oficial | Acima do limite da Meta | Imagem até 5 MB; áudio/vídeo até 16 MB |
| Upload de mídia recusado | Arquivo acima de 20 MB ou tipo diferente do escolhido | Reduza o arquivo ou troque o tipo no bloco |
| Não consigo publicar | Erros de validação | Lista “Corrija antes de publicar”: clique no erro para ir ao bloco |
| Não aparecem botões de editar/publicar | Perfil sem permissão | Só o Gestor edita; gerente e demais só visualizam |
| Não vejo Relatório/Execuções | Perfil sem permissão | Só o Gestor vê |
| “muitas requisições seguidas” | Limite de uso do editor | Aguarde um minuto |
| Recarga sem link | Asaas falhou na hora | Configure “Sucesso quando” = payment_url; tente de novo |
Para investigar um caso específico, use Execuções com o filtro “Com falha”: mostra o caminho da conversa e o motivo exato da falha.
14. Limites e números
| Item | Limite |
|---|---|
| Botões nativos (WhatsApp oficial) | Até 3 botões; 4 a 10 opções viram lista; texto do menu até 1024 caracteres |
| Intervalo entre mensagens | 0 a 10 s; no máximo 45 s de espera somada por resposta |
| Recomeçar o fluxo | 15 min a 1 dia, ou nunca (padrão 30 min) |
| Respostas inválidas | Sem limite, 2, 3, 4, 5 ou 10 (padrão 3) |
| Blocos seguidos sem esperar resposta | 25 (acima disso o fluxo para, por suspeita de laço) |
| Chamada API | Tempo limite padrão 10 s, máximo 30 s |
| Testar API | Mostra até 8 KB da resposta |
| Lista da resposta | Padrão 10 itens, máximo 50 |
| Upload de mídia | 20 MB |
| Mídia no WhatsApp oficial | Imagem 5 MB; áudio e vídeo 16 MB; documento 100 MB |
| Memória do Agente de IA | Últimas 20 mensagens |
| Arquivo de importação | 512 KB |
| Relatório | 7, 30 ou 90 dias |
| Execuções | 24 h, 7, 30 ou 90 dias; 50 por página (“Carregar mais”) |
| Uso do editor | 300 ações por minuto por usuário; Simulador e Testar API: 30 por minuto |