< Todos Tópicos
Imprimir

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

  1. Onde fica e o que é preciso
  2. Quem pode fazer o quê
  3. Como o bot atende uma conversa
  4. Criar e publicar um fluxo
  5. O editor
  6. Configurações do fluxo
  7. Ligações entre blocos
  8. Os blocos, um por um
  9. Variáveis
  10. Chamada API e Segredos
  11. Relatório, Excel e Execuções
  12. Exemplos prontos (adminws)
  13. Problemas comuns
  14. 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:

ItemOnde se configura
Módulo All-Bot liberado para a revendaPainel Master › Planos / módulos da revenda
Módulo All-Bot ligado para a empresaCadastro da empresa (revenda) › Módulos
Usuário com perfil Gestor para montar o fluxoUsuários da empresa
Pelo menos um canal de WhatsApp conectadoCanais

Canais que o All-Bot atende:

CanalFunciona?Observação
WhatsApp oficial (Meta / Cloud API)SimMenus aparecem como botões (até 3 opções) ou lista (até 10).
WAHA (não oficial)SimMenus aparecem como texto numerado.
Zender (não oficial)SimMenus aparecem como texto numerado.
EvolutionNãoCanal 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:

BlocoPrecisa ter cadastrado
Transferir para SetorSetores
Transferir para UsuárioAtendentes (usuários)
Abrir ChamadoCategorias de chamado (opcional)
Agente de IAUm agente de IA cadastrado (Configurações › Inteligência Artificial)
CRM (lead e negócio)Funil e etapas do CRM
Mapeamento de OrigemOrigens 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çãoGestor (e superadmin)Gerente e demais perfis
Ver a lista de fluxos e abrir um fluxoSimSim, somente visualização
Criar, editar, importar, usar a IA, salvar, publicar, despublicar, excluirSimNão
Canais do fluxo, Segredos, Configurações do fluxoSimNão
Simulador e “Testar API”SimNão (podem chamar sistemas de verdade)
Relatório do fluxo, Excel e ExecuçõesSimNã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

  1. 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).
  2. O fluxo começa pelo bloco marcado Início (o primeiro bloco que não recebe nenhuma ligação).
  3. 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.
  4. A resposta do contato decide o próximo caminho (pelas ligações). O bot continua de onde parou.
  5. 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ãoO que faz
Novo fluxoFluxo em branco (nome e descrição).
Importar JSONCarrega 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 modeloBaixa um fluxo de exemplo para importar e adaptar.
IAChat 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

  1. Crie o fluxo e abra o editor (ícone de lápis).
  2. Arraste os blocos da paleta e ligue um no outro (veja Ligações).
  3. Configure cada bloco no painel da direita (clique no bloco).
  4. Salvar grava o rascunho. O fluxo ainda não atende.
  5. Canais: marque os canais que esse fluxo vai atender.
  6. Simular (opcional): converse com o fluxo dentro do editor para testar o caminho.
  7. 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.
  8. 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

RecursoComo usar
Mover a telaArrastar o fundo, ou segurar Espaço / Ctrl / ⌘. Trackpad: dois dedos.
ZoomPinça no trackpad, Ctrl+scroll ou os botões + / −. Botão de encaixe enquadra o fluxo todo.
Selecionar váriosShift + arrastar (caixa de seleção). Ctrl+A seleciona tudo. Arrastar um move todos.
ApagarLixeira no bloco ou tecla Delete.
Ligar blocosArrastar da bolinha de baixo de um bloco até a bolinha de cima do outro.
Curvar uma linhaArrastar a etiqueta (ou o meio) da linha. Para endireitar: arrastar de volta ao meio ou “Endireitar linha” no diálogo da ligação.
FormatarOrganiza o fluxo em camadas, do início para baixo, e endireita as linhas. Aparece o aviso “Fluxo formatado” com Desfazer.
Tela inteiraBotão de expandir (ESC sai).
SimularTesta o fluxo no próprio editor; o bloco atual acende no canvas. Chamadas de API no simulador são reais.
Exportar JSONBaixa 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çãoO que fazValores
Intervalo entre mensagensEspera 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 sumirDepois desse tempo sem resposta, a próxima mensagem começa do início15 min, 30 min (padrão), 1 h, 2 h, 4 h, 12 h, 1 dia ou Nunca
Respostas inválidas antes de transferirQuantas respostas erradas seguidas num menu/perguntaSem 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:

TipoQuando segue
Resposta exataA resposta é exatamente o valor (o valor da opção do menu, ex.: 1 ou sim).
Contém textoA resposta contém o texto.
Padrão (fallback)Nenhuma outra ligação serviu.
Respostas inválidas esgotadasO contato errou o limite de vezes seguidas. Sem essa ligação, transfere para a fila.

Saindo de blocos com resultado (duas saídas):

BlocoSaída de sucessoSaída de erro
Chamada APIAPI: sucessoAPI: erro (erro, tempo esgotado ou resposta fora de 2xx)
Agente de IAIA: saiu da conversa (palavra de saída, ex.: “menu”)IA: precisa de humano (pediu atendente, IA pediu transferir, falhou ou bateu o limite)
Consultar ChamadoChamado encontradoChamado não encontrado
CRMCRM: cadastradoCRM: erro (ex.: o contato já é cliente)
Enviar MídiaMídia enviadaSem arquivo (link vazio ou inválido)
CondiçãoVerdadeiroFalso
Horário de AtendimentoDentro do horárioFora do horário (dia fechado ou feriado)
Mapeamento de OrigemOrigem aplicadaNenhuma 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ávelDe 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ê derBloco 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

CampoPara que serve
Método e URLGET, POST, PUT, PATCH ou DELETE. A URL aceita variáveis (são codificadas automaticamente).
HeadersPares chave/valor. O nome do header vai sem dois-pontos (ApiKey, não ApiKey:).
BodyJSON, Formulário (x-www-form-urlencoded) ou Sem body. Variáveis no JSON são escapadas automaticamente; coloque-as entre aspas: “documento”: “{{documento}}”.
Sucesso quandoAlé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 respostaVariável ← caminho no JSON. Ex.: saldo ← balance, status ← documento.status, primeiro ← 0.due_date.
Lista da respostaMonta 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 limitePadrão 10 s, até 30 s.
Mensagem de Sucesso / de ErroEnviadas 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

SintomaCausa provávelO que verificar / fazer
Bot não responde nadaFluxo não publicado, canal não ligado ao fluxo, ou módulo desligadoSelo *Publicado; botão *Canais do fluxo; módulo All-Bot na empresa
Bot parou no meioUm atendente assumiu ou a conversa foi transferidaNormal: com atendente, o bot fica quieto. Depois recomeça do início
Bot ignora foto ou áudioO fluxo só entende textoPeça para o contato responder em texto
Contato voltou e caiu no inícioPassou 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çãoNa ligação “Resposta exata”, use o valor da opção (um só, ex.: 1)
Transferiu sozinho depois de respostas erradasLimite de respostas inválidasConfigurações do fluxo, ou crie a saída “Respostas inválidas esgotadas”
Variável sai vazia na mensagemNome diferente (maiúsculas, acento, espaço){{cep}} ≠ {{CEP}}. Confira no bloco que guarda a variável
API dá erro 401/403Header com nome errado ou segredo erradoNome do header sem dois-pontos; segredo cadastrado e com o domínio certo
API dá 400/422 no testeVariável vazia na requisiçãoPreencha Valores para o teste
“segredo não permitido para este endereço”Domínio do segredo diferente do da URLAjuste o domínio do segredo
“endereço de rede interna não permitido”URL aponta para IP interno/localhostUse o endereço público da API
API sempre cai no erro“Sucesso quando” aponta para um campo que não vemVeja o payload no Testar API e ajuste o caminho
Lista vaziaCaminho da lista erradoResposta que já é uma lista: caminho .
Mídia não chega no WhatsApp oficialAcima do limite da MetaImagem até 5 MB; áudio/vídeo até 16 MB
Upload de mídia recusadoArquivo acima de 20 MB ou tipo diferente do escolhidoReduza o arquivo ou troque o tipo no bloco
Não consigo publicarErros de validaçãoLista “Corrija antes de publicar”: clique no erro para ir ao bloco
Não aparecem botões de editar/publicarPerfil sem permissãoSó o Gestor edita; gerente e demais só visualizam
Não vejo Relatório/ExecuçõesPerfil sem permissãoSó o Gestor vê
“muitas requisições seguidas”Limite de uso do editorAguarde um minuto
Recarga sem linkAsaas falhou na horaConfigure “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

ItemLimite
Botões nativos (WhatsApp oficial)Até 3 botões; 4 a 10 opções viram lista; texto do menu até 1024 caracteres
Intervalo entre mensagens0 a 10 s; no máximo 45 s de espera somada por resposta
Recomeçar o fluxo15 min a 1 dia, ou nunca (padrão 30 min)
Respostas inválidasSem limite, 2, 3, 4, 5 ou 10 (padrão 3)
Blocos seguidos sem esperar resposta25 (acima disso o fluxo para, por suspeita de laço)
Chamada APITempo limite padrão 10 s, máximo 30 s
Testar APIMostra até 8 KB da resposta
Lista da respostaPadrão 10 itens, máximo 50
Upload de mídia20 MB
Mídia no WhatsApp oficialImagem 5 MB; áudio e vídeo 16 MB; documento 100 MB
Memória do Agente de IAÚltimas 20 mensagens
Arquivo de importação512 KB
Relatório7, 30 ou 90 dias
Execuções24 h, 7, 30 ou 90 dias; 50 por página (“Carregar mais”)
Uso do editor300 ações por minuto por usuário; Simulador e Testar API: 30 por minuto
Sumário