{"id":905,"date":"2026-10-02T11:00:44","date_gmt":"2026-10-02T14:00:44","guid":{"rendered":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/?post_type=epkb_post_type_1&#038;p=905"},"modified":"2026-10-02T11:00:44","modified_gmt":"2026-10-02T14:00:44","slug":"criar-o-allboot","status":"publish","type":"epkb_post_type_1","link":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/?epkb_post_type_1=criar-o-allboot","title":{"rendered":"Criar o ALLBOOT"},"content":{"rendered":"\n<h1 class=\"wp-block-heading\">Guia do All-Bot (para o Suporte)<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">O All-Bot \u00e9 o bot de atendimento por fluxo visual da Allenda. A empresa desenha o fluxo (menus, perguntas, consultas a sistemas, chamados, CRM, transfer\u00eancia para atendentes) num editor de blocos, liga o fluxo aos canais de WhatsApp e o bot passa a atender sozinho.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Este guia explica o que \u00e9 preciso para usar, como configurar cada parte, como o bot se comporta numa conversa e como investigar os problemas mais comuns.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Sum\u00e1rio<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><a href=\"#1-onde-fica-e-o-que-%C3%A9-preciso\">Onde fica e o que \u00e9 preciso<\/a><\/li>\n\n\n\n<li><a href=\"#2-quem-pode-fazer-o-qu%C3%AA\">Quem pode fazer o qu\u00ea<\/a><\/li>\n\n\n\n<li><a href=\"#3-como-o-bot-atende-uma-conversa\">Como o bot atende uma conversa<\/a><\/li>\n\n\n\n<li><a href=\"#4-criar-e-publicar-um-fluxo\">Criar e publicar um fluxo<\/a><\/li>\n\n\n\n<li><a href=\"#5-o-editor\">O editor<\/a><\/li>\n\n\n\n<li><a href=\"#6-configura%C3%A7%C3%B5es-do-fluxo\">Configura\u00e7\u00f5es do fluxo<\/a><\/li>\n\n\n\n<li><a href=\"#7-liga%C3%A7%C3%B5es-entre-blocos\">Liga\u00e7\u00f5es entre blocos<\/a><\/li>\n\n\n\n<li><a href=\"#8-os-blocos-um-por-um\">Os blocos, um por um<\/a><\/li>\n\n\n\n<li><a href=\"#9-vari%C3%A1veis\">Vari\u00e1veis<\/a><\/li>\n\n\n\n<li><a href=\"#10-chamada-api-e-segredos\">Chamada API e Segredos<\/a><\/li>\n\n\n\n<li><a href=\"#11-relat%C3%B3rio-excel-e-execu%C3%A7%C3%B5es\">Relat\u00f3rio, Excel e Execu\u00e7\u00f5es<\/a><\/li>\n\n\n\n<li><a href=\"#12-exemplos-prontos-adminws\">Exemplos prontos (adminws)<\/a><\/li>\n\n\n\n<li><a href=\"#13-problemas-comuns\">Problemas comuns<\/a><\/li>\n\n\n\n<li><a href=\"#14-limites-e-n%C3%BAmeros\">Limites e n\u00fameros<\/a><\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">1. Onde fica e o que \u00e9 preciso<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Onde fica:<\/em> Configura\u00e7\u00f5es \u203a Bots \u203a aba <em>All-Bot<\/em>. A aba s\u00f3 aparece quando o m\u00f3dulo est\u00e1 liberado para a empresa.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Checklist para a empresa come\u00e7ar a usar:<\/em><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Item<\/th><th>Onde se configura<\/th><\/tr><\/thead><tbody><tr><td>M\u00f3dulo <em>All-Bot<\/em> liberado para a revenda<\/td><td>Painel Master \u203a Planos \/ m\u00f3dulos da revenda<\/td><\/tr><tr><td>M\u00f3dulo <em>All-Bot<\/em> ligado para a empresa<\/td><td>Cadastro da empresa (revenda) \u203a M\u00f3dulos<\/td><\/tr><tr><td>Usu\u00e1rio com perfil <em>Gestor<\/em> para montar o fluxo<\/td><td>Usu\u00e1rios da empresa<\/td><\/tr><tr><td>Pelo menos um canal de WhatsApp conectado<\/td><td>Canais<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Canais que o All-Bot atende:<\/em><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Canal<\/th><th>Funciona?<\/th><th>Observa\u00e7\u00e3o<\/th><\/tr><\/thead><tbody><tr><td>WhatsApp oficial (Meta \/ Cloud API)<\/td><td>Sim<\/td><td>Menus aparecem como <em>bot\u00f5es<\/em> (at\u00e9 3 op\u00e7\u00f5es) ou <em>lista<\/em> (at\u00e9 10).<\/td><\/tr><tr><td>WAHA (n\u00e3o oficial)<\/td><td>Sim<\/td><td>Menus aparecem como texto numerado.<\/td><\/tr><tr><td>Zender (n\u00e3o oficial)<\/td><td>Sim<\/td><td>Menus aparecem como texto numerado.<\/td><\/tr><tr><td>Evolution<\/td><td>N\u00e3o<\/td><td>Canal desativado para o All-Bot.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Um canal atende com um fluxo s\u00f3.<\/em> Um mesmo fluxo pode atender v\u00e1rios canais.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Alguns blocos dependem de cadastros pr\u00e9vios:<\/em><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Bloco<\/th><th>Precisa ter cadastrado<\/th><\/tr><\/thead><tbody><tr><td>Transferir para Setor<\/td><td>Setores<\/td><\/tr><tr><td>Transferir para Usu\u00e1rio<\/td><td>Atendentes (usu\u00e1rios)<\/td><\/tr><tr><td>Abrir Chamado<\/td><td>Categorias de chamado (opcional)<\/td><\/tr><tr><td>Agente de IA<\/td><td>Um agente de IA cadastrado (Configura\u00e7\u00f5es \u203a Intelig\u00eancia Artificial)<\/td><\/tr><tr><td>CRM (lead e neg\u00f3cio)<\/td><td>Funil e etapas do CRM<\/td><\/tr><tr><td>Mapeamento de Origem<\/td><td>Origens do CRM (Configura\u00e7\u00f5es do CRM \u203a Origens)<\/td><\/tr><tr><td>Bot\u00e3o <em>IA<\/em> (criar fluxo conversando)<\/td><td>Conta de IA da empresa (Configura\u00e7\u00f5es \u203a Intelig\u00eancia Artificial)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">2. Quem pode fazer o qu\u00ea<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>A\u00e7\u00e3o<\/th><th>Gestor (e superadmin)<\/th><th>Gerente e demais perfis<\/th><\/tr><\/thead><tbody><tr><td>Ver a lista de fluxos e abrir um fluxo<\/td><td>Sim<\/td><td>Sim, <em>somente visualiza\u00e7\u00e3o<\/em><\/td><\/tr><tr><td>Criar, editar, importar, usar a IA, salvar, publicar, despublicar, excluir<\/td><td>Sim<\/td><td>N\u00e3o<\/td><\/tr><tr><td>Canais do fluxo, Segredos, Configura\u00e7\u00f5es do fluxo<\/td><td>Sim<\/td><td>N\u00e3o<\/td><\/tr><tr><td>Simulador e &#8220;Testar API&#8221;<\/td><td>Sim<\/td><td>N\u00e3o (podem chamar sistemas de verdade)<\/td><\/tr><tr><td>Relat\u00f3rio do fluxo, Excel e Execu\u00e7\u00f5es<\/td><td>Sim<\/td><td>N\u00e3o<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Quem s\u00f3 visualiza v\u00ea o aviso <em>&#8220;Somente visualiza\u00e7\u00e3o&#8221;<\/em>: sem paleta de blocos, sem arrastar, sem ligar ou apagar blocos, com todos os campos travados.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Usu\u00e1rio desativado, ou empresa\/revenda bloqueada, perde o acesso ao All-Bot na hora (n\u00e3o precisa esperar o login expirar).<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">3. Como o bot atende uma conversa<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Chega uma mensagem num canal. Se esse canal est\u00e1 ligado a um fluxo <em>publicado<\/em> e o m\u00f3dulo est\u00e1 ativo, o All-Bot assume. Caso contr\u00e1rio, a mensagem segue o caminho de antes (bot antigo \/ atendimento normal).<\/li>\n\n\n\n<li>O fluxo come\u00e7a pelo bloco marcado <em>In\u00edcio<\/em> (o primeiro bloco que n\u00e3o recebe nenhuma liga\u00e7\u00e3o).<\/li>\n\n\n\n<li>O bot executa os blocos em sequ\u00eancia at\u00e9 chegar num bloco que espera resposta (menu ou pergunta). A conversa aparece no painel enquanto o bot atende.<\/li>\n\n\n\n<li>A resposta do contato decide o pr\u00f3ximo caminho (pelas liga\u00e7\u00f5es). O bot continua de onde parou.<\/li>\n\n\n\n<li>A conversa termina quando o fluxo chega em *Encerramento, numa *<em>transfer\u00eancia<\/em> (setor ou atendente) ou no fim dos blocos.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Regras importantes:<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>Atendente assumiu = bot quieto.<\/em> 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\u00e7a do in\u00edcio (nunca do meio).<\/li>\n\n\n\n<li><em>O bot s\u00f3 entende texto.<\/em> M\u00eddia sem legenda (foto, \u00e1udio) \u00e9 ignorada pelo fluxo.<\/li>\n\n\n\n<li><em>Contato sumiu:<\/em> depois do tempo de &#8220;Recome\u00e7ar o fluxo&#8221; (padr\u00e3o 30 minutos), a pr\u00f3xima mensagem come\u00e7a o fluxo do in\u00edcio. No relat\u00f3rio isso conta como &#8220;desistiu&#8221;.<\/li>\n\n\n\n<li><em>Respostas erradas seguidas:<\/em> depois do limite (padr\u00e3o 3), o fluxo segue pela sa\u00edda &#8220;Respostas inv\u00e1lidas esgotadas&#8221; do bloco; se ela n\u00e3o existir, o bot avisa &#8220;N\u00e3o consegui entender suas respostas. Vou te passar para um atendente.&#8221; e transfere para a fila.<\/li>\n\n\n\n<li><em>Mensagens do mesmo contato<\/em> s\u00e3o processadas em ordem, uma de cada vez.<\/li>\n\n\n\n<li><em>Fluxo republicado no meio de uma conversa:<\/em> se o bloco em que o contato estava foi apagado, a pr\u00f3xima mensagem recome\u00e7a do in\u00edcio.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">4. Criar e publicar um fluxo<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Formas de criar<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Bot\u00e3o<\/th><th>O que faz<\/th><\/tr><\/thead><tbody><tr><td><em>Novo fluxo<\/em><\/td><td>Fluxo em branco (nome e descri\u00e7\u00e3o).<\/td><\/tr><tr><td><em>Importar JSON<\/em><\/td><td>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\u00e3o removidas.<\/td><\/tr><tr><td><em>Baixar modelo<\/em><\/td><td>Baixa um fluxo de exemplo para importar e adaptar.<\/td><\/tr><tr><td><em>IA<\/em><\/td><td>Chat que monta o fluxo a partir de uma descri\u00e7\u00e3o (&#8220;Menu com Comercial, Suporte e Financeiro&#8230;&#8221;). Tamb\u00e9m d\u00e1 para anexar um JSON e pedir ajustes. Usa a conta de IA da empresa. O fluxo gerado passa pela mesma checagem do Importar.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Passo a passo<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Crie o fluxo e abra o editor (\u00edcone de l\u00e1pis).<\/li>\n\n\n\n<li>Arraste os blocos da paleta e ligue um no outro (veja <a href=\"#7-liga%C3%A7%C3%B5es-entre-blocos\">Liga\u00e7\u00f5es<\/a>).<\/li>\n\n\n\n<li>Configure cada bloco no painel da direita (clique no bloco).<\/li>\n\n\n\n<li><em>Salvar<\/em> grava o rascunho. O fluxo <em>ainda n\u00e3o atende<\/em>.<\/li>\n\n\n\n<li><em>Canais<\/em>: marque os canais que esse fluxo vai atender.<\/li>\n\n\n\n<li><em>Simular<\/em> (opcional): converse com o fluxo dentro do editor para testar o caminho.<\/li>\n\n\n\n<li><em>Publicar<\/em>: o sistema confere o fluxo (blocos sem configura\u00e7\u00e3o, funil sem etapa, credencial digitada direto etc.). Se houver erro, aparece a lista &#8220;Corrija antes de publicar&#8221;; clique no erro para ir at\u00e9 o bloco.<\/li>\n\n\n\n<li>Depois de publicado, o selo fica <em>Publicado<\/em>. Altera\u00e7\u00f5es novas ficam como &#8220;Publicado \u00b7 altera\u00e7\u00f5es n\u00e3o publicadas&#8221; at\u00e9 publicar de novo.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Despublicar<\/em> faz o fluxo parar de atender (as mensagens voltam ao caminho normal).<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">5. O editor<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Recurso<\/th><th>Como usar<\/th><\/tr><\/thead><tbody><tr><td>Mover a tela<\/td><td>Arrastar o fundo, ou segurar Espa\u00e7o \/ Ctrl \/ \u2318. Trackpad: dois dedos.<\/td><\/tr><tr><td>Zoom<\/td><td>Pin\u00e7a no trackpad, Ctrl+scroll ou os bot\u00f5es + \/ \u2212. Bot\u00e3o de encaixe enquadra o fluxo todo.<\/td><\/tr><tr><td>Selecionar v\u00e1rios<\/td><td>Shift + arrastar (caixa de sele\u00e7\u00e3o). Ctrl+A seleciona tudo. Arrastar um move todos.<\/td><\/tr><tr><td>Apagar<\/td><td>Lixeira no bloco ou tecla Delete.<\/td><\/tr><tr><td>Ligar blocos<\/td><td>Arrastar da bolinha de baixo de um bloco at\u00e9 a bolinha de cima do outro.<\/td><\/tr><tr><td>Curvar uma linha<\/td><td>Arrastar a etiqueta (ou o meio) da linha. Para endireitar: arrastar de volta ao meio ou &#8220;Endireitar linha&#8221; no di\u00e1logo da liga\u00e7\u00e3o.<\/td><\/tr><tr><td><em>Formatar<\/em><\/td><td>Organiza o fluxo em camadas, do in\u00edcio para baixo, e endireita as linhas. Aparece o aviso &#8220;Fluxo formatado&#8221; com <em>Desfazer<\/em>.<\/td><\/tr><tr><td>Tela inteira<\/td><td>Bot\u00e3o de expandir (ESC sai).<\/td><\/tr><tr><td><em>Simular<\/em><\/td><td>Testa o fluxo no pr\u00f3prio editor; o bloco atual acende no canvas. Chamadas de API no simulador s\u00e3o reais.<\/td><\/tr><tr><td><em>Exportar JSON<\/em><\/td><td>Baixa o fluxo (.allbot.json). Nunca leva valores de segredos nem setores\/atendentes da empresa. Op\u00e7\u00e3o de remover URLs, headers e body das Chamadas API para compartilhar.<\/td><\/tr><tr><td><em>Segredos<\/em> (\u00edcone de chave)<\/td><td>Cofre de tokens e senhas das APIs (veja <a href=\"#segredos\">Segredos<\/a>).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">O card de cada bloco mostra um resumo da configura\u00e7\u00e3o (ex.: &#8220;POST https:\/\/&#8230;&#8221; na Chamada API, &#8220;\u26a0\ufe0f Escolha o setor&#8221; quando falta algo).<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">6. Configura\u00e7\u00f5es do fluxo<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Bot\u00e3o <em>Configura\u00e7\u00f5es<\/em> no topo do editor. Valem assim que o fluxo \u00e9 <em>salvo<\/em> (n\u00e3o precisa publicar de novo).<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Op\u00e7\u00e3o<\/th><th>O que faz<\/th><th>Valores<\/th><\/tr><\/thead><tbody><tr><td>Intervalo entre mensagens<\/td><td>Espera antes de cada mensagem do bot, mostrando &#8220;digitando&#8230;&#8221;<\/td><td>Na hora, 1, 2, 3, 4, 5, 7 ou 10 segundos<\/td><\/tr><tr><td>Recome\u00e7ar o fluxo se o contato sumir<\/td><td>Depois desse tempo sem resposta, a pr\u00f3xima mensagem come\u00e7a do in\u00edcio<\/td><td>15 min, 30 min (padr\u00e3o), 1 h, 2 h, 4 h, 12 h, 1 dia ou Nunca<\/td><\/tr><tr><td>Respostas inv\u00e1lidas antes de transferir<\/td><td>Quantas respostas erradas seguidas num menu\/pergunta<\/td><td>Sem limite, 2, 3 (padr\u00e3o), 4, 5 ou 10<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">7. Liga\u00e7\u00f5es entre blocos<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Ao ligar dois blocos, abre o di\u00e1logo da liga\u00e7\u00e3o para escolher <em>quando<\/em> o fluxo segue por ela.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Saindo de um menu (Mensagem com op\u00e7\u00f5es) ou Pergunta:<\/em><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Tipo<\/th><th>Quando segue<\/th><\/tr><\/thead><tbody><tr><td>Resposta exata<\/td><td>A resposta \u00e9 exatamente o valor (o <em>valor<\/em> da op\u00e7\u00e3o do menu, ex.: 1 ou sim).<\/td><\/tr><tr><td>Cont\u00e9m texto<\/td><td>A resposta cont\u00e9m o texto.<\/td><\/tr><tr><td>Padr\u00e3o (fallback)<\/td><td>Nenhuma outra liga\u00e7\u00e3o serviu.<\/td><\/tr><tr><td>Respostas inv\u00e1lidas esgotadas<\/td><td>O contato errou o limite de vezes seguidas. Sem essa liga\u00e7\u00e3o, transfere para a fila.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Saindo de blocos com resultado (duas sa\u00eddas):<\/em><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Bloco<\/th><th>Sa\u00edda de sucesso<\/th><th>Sa\u00edda de erro<\/th><\/tr><\/thead><tbody><tr><td>Chamada API<\/td><td>API: sucesso<\/td><td>API: erro (erro, tempo esgotado ou resposta fora de 2xx)<\/td><\/tr><tr><td>Agente de IA<\/td><td>IA: saiu da conversa (palavra de sa\u00edda, ex.: &#8220;menu&#8221;)<\/td><td>IA: precisa de humano (pediu atendente, IA pediu transferir, falhou ou bateu o limite)<\/td><\/tr><tr><td>Consultar Chamado<\/td><td>Chamado encontrado<\/td><td>Chamado n\u00e3o encontrado<\/td><\/tr><tr><td>CRM<\/td><td>CRM: cadastrado<\/td><td>CRM: erro (ex.: o contato j\u00e1 \u00e9 cliente)<\/td><\/tr><tr><td>Enviar M\u00eddia<\/td><td>M\u00eddia enviada<\/td><td>Sem arquivo (link vazio ou inv\u00e1lido)<\/td><\/tr><tr><td>Condi\u00e7\u00e3o<\/td><td>Verdadeiro<\/td><td>Falso<\/td><\/tr><tr><td>Hor\u00e1rio de Atendimento<\/td><td>Dentro do hor\u00e1rio<\/td><td>Fora do hor\u00e1rio (dia fechado ou feriado)<\/td><\/tr><tr><td>Mapeamento de Origem<\/td><td>Origem aplicada<\/td><td>Nenhuma frase bateu<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Sem liga\u00e7\u00e3o espec\u00edfica, vale a <em>Padr\u00e3o (fallback)<\/em>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Cuidado comum:<\/em> a liga\u00e7\u00e3o &#8220;Resposta exata&#8221; deve ter <em>um valor s\u00f3<\/em> (ex.: 1). Valores como 7, consultar n\u00e3o funcionam.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">8. Os blocos, um por um<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Conversa<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Mensagem \/ Menu<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Envia um texto. Com <em>op\u00e7\u00f5es<\/em> (r\u00f3tulo + valor), vira um menu e espera a resposta.<\/li>\n\n\n\n<li>Exibi\u00e7\u00e3o: texto, bot\u00f5es ou lista. Bot\u00f5es e lista nativos s\u00f3 no WhatsApp oficial (at\u00e9 3 bot\u00f5es; de 4 a 10 vira lista; texto at\u00e9 1024 caracteres). Nos demais canais, ou com mais de 10 op\u00e7\u00f5es, sai como menu numerado.<\/li>\n\n\n\n<li>O contato pode responder com o n\u00famero, o texto da op\u00e7\u00e3o ou o valor.<\/li>\n\n\n\n<li>&#8220;Mensagem de op\u00e7\u00e3o inv\u00e1lida&#8221;: o que o bot diz antes de repetir o menu.<\/li>\n\n\n\n<li>Cria {{opcao_escolhida}} (r\u00f3tulo da op\u00e7\u00e3o) ou {{resposta}} (texto digitado, quando n\u00e3o bateu com uma op\u00e7\u00e3o mas seguiu por &#8220;Cont\u00e9m&#8221;\/&#8221;Padr\u00e3o&#8221;).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Pergunta<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Pergunta e guarda a resposta numa <em>vari\u00e1vel<\/em> (ex.: documento).<\/li>\n\n\n\n<li>Valida\u00e7\u00e3o: Qualquer texto, N\u00famero (guarda s\u00f3 os d\u00edgitos), CPF, CNPJ ou E-mail. Resposta inv\u00e1lida repete a pergunta.<\/li>\n\n\n\n<li><em>Aten\u00e7\u00e3o com &#8220;N\u00famero&#8221;<\/em>: ele remove tudo que n\u00e3o \u00e9 d\u00edgito. 50,00 vira 5000. Para valores em dinheiro, prefira &#8220;Qualquer texto&#8221;.<\/li>\n\n\n\n<li>Uma pergunta guarda <em>uma<\/em> resposta. Para v\u00e1rios dados, use uma pergunta para cada.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Enviar M\u00eddia<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Imagem, documento (PDF, planilha), \u00e1udio ou v\u00eddeo, por <em>link p\u00fablico<\/em> ou <em>arquivo enviado do computador<\/em>.<\/li>\n\n\n\n<li>Arquivo enviado fica guardado no armazenamento de m\u00eddia do WhatsApp (R2), at\u00e9 <em>20 MB<\/em>.<\/li>\n\n\n\n<li>O link aceita vari\u00e1vel (ex.: {{link_boleto}} vindo de uma Chamada API).<\/li>\n\n\n\n<li>No WhatsApp oficial a Meta limita: imagem 5 MB, \u00e1udio e v\u00eddeo 16 MB, documento 100 MB.<\/li>\n\n\n\n<li>Sa\u00eddas: M\u00eddia enviada \/ Sem arquivo.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">L\u00f3gica<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Condi\u00e7\u00e3o<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Compara Se (ex.: {{saldo}}) com um valor: \u00e9 igual, diferente, cont\u00e9m, n\u00e3o cont\u00e9m, maior, maior ou igual, menor, menor ou igual, est\u00e1 vazio, n\u00e3o est\u00e1 vazio.<\/li>\n\n\n\n<li>N\u00fameros aceitam 12.50, 12,50 e R$ 1.234,56. Texto compara sem diferenciar mai\u00fasculas e acentos.<\/li>\n\n\n\n<li>Sa\u00eddas: Verdadeiro \/ Falso.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Hor\u00e1rio de Atendimento<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Dias da semana com hor\u00e1rio de in\u00edcio e fim, e feriados (MM-DD todo ano ou AAAA-MM-DD). Fuso de S\u00e3o Paulo.<\/li>\n\n\n\n<li>Sa\u00eddas: Dentro do hor\u00e1rio \/ Fora do hor\u00e1rio.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Definir Vari\u00e1vel<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Grava um valor numa vari\u00e1vel, ou <em>soma<\/em> a um n\u00famero que j\u00e1 existe (ex.: contador de tentativas).<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">A\u00e7\u00f5es<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Chamada API<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Consulta ou envia dados para outro sistema (ex.: saldo, faturas, rastreio). Detalhes na <a href=\"#10-chamada-api-e-segredos\">se\u00e7\u00e3o 10<\/a>.<\/li>\n\n\n\n<li>Sa\u00eddas: API: sucesso \/ API: erro.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Agente de IA<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A conversa passa a ser com um agente de IA cadastrado. Cada mensagem do contato vai para a IA at\u00e9:\n<ul class=\"wp-block-list\">\n<li>uma <em>palavra de sa\u00edda<\/em> (ex.: menu, sair) \u2192 sa\u00edda &#8220;IA: saiu da conversa&#8221;;<\/li>\n\n\n\n<li>o contato pedir atendente, a IA pedir para transferir, a IA falhar ou bater o <em>m\u00e1ximo de turnos<\/em> \u2192 sa\u00edda &#8220;IA: precisa de humano&#8221;.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>A IA lembra as \u00faltimas 20 mensagens da conversa.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Transferir para Setor \/ Transferir para Usu\u00e1rio<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Envia a mensagem de transfer\u00eancia (opcional) e passa a conversa para o setor ou atendente escolhido. O bot sai da conversa.<\/li>\n\n\n\n<li>Setor ou atendente que n\u00e3o pertence mais \u00e0 empresa: a conversa vai para a fila geral.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Chamados e CRM<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Abrir Chamado<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Abre um chamado no sistema com categoria, assunto, descri\u00e7\u00e3o e prioridade (aceitam vari\u00e1veis).<\/li>\n\n\n\n<li>*Mensagem com o n\u00famero do chamado: enviada ao contato assim que abre. Use {{protocolo_chamado}}. Blocos novos j\u00e1 v\u00eam com: *&#8221;\u2705 Chamado aberto! Seu protocolo \u00e9 {{protocolo_chamado}}. Guarde esse n\u00famero para consultar o andamento depois.&#8221;<\/li>\n\n\n\n<li>&#8220;Se n\u00e3o conseguir abrir&#8221;: mensagem quando falha.<\/li>\n\n\n\n<li>Cria {{protocolo_chamado}}.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Consultar Chamado<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Mostra o status de um chamado pelo protocolo (padr\u00e3o {{protocolo}}, normalmente vindo de uma Pergunta).<\/li>\n\n\n\n<li>Cria {{chamado_protocolo}}, {{chamado_status}}, {{chamado_assunto}}, {{chamado_atualizado}}, {{chamado_responsavel}} e {{protocolo_consultado}}.<\/li>\n\n\n\n<li>Sa\u00eddas: Chamado encontrado \/ Chamado n\u00e3o encontrado.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>CRM (Lead \/ Neg\u00f3cio)<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>&#8220;O que fazer&#8221;: s\u00f3 cadastrar como lead, ou cadastrar como lead e transformar em neg\u00f3cio no <em>funil e etapa<\/em> escolhidos.<\/li>\n\n\n\n<li><em>Se o contato j\u00e1 tiver lead<\/em>:\n<ul class=\"wp-block-list\">\n<li>Atualizar o lead que j\u00e1 existe (padr\u00e3o): acha o lead do contato (vinculado a ele ou com o mesmo e-mail\/n\u00famero) e atualiza com o que o fluxo coletou. Campo em branco no bloco n\u00e3o apaga nada; o nome do WhatsApp n\u00e3o sobrescreve o que o time editou.<\/li>\n\n\n\n<li>Criar outro lead (duplicar): sempre cria um lead novo.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Quem j\u00e1 \u00e9 <em>cliente<\/em> n\u00e3o vira lead (sai pela sa\u00edda de erro).<\/li>\n\n\n\n<li>Campos: nome, empresa, e-mail, telefone, valor estimado, observa\u00e7\u00f5es, t\u00edtulo do neg\u00f3cio (aceitam vari\u00e1veis). Nome e telefone em branco usam os do contato.<\/li>\n\n\n\n<li>Cria {{lead_id}} e {{negocio_id}}.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Mapeamento de Origem<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Compara a <em>primeira mensagem<\/em> do contato com frases exatas de campanha (sem diferenciar mai\u00fasculas, acentos e espa\u00e7os) e marca a <em>origem do lead<\/em> cadastrada para a frase.<\/li>\n\n\n\n<li>Cria {{origem_nome}}.<\/li>\n\n\n\n<li>Sa\u00eddas: Origem aplicada \/ Nenhuma frase bateu.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Fluxo<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Voltar ao Menu<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Envia uma mensagem (opcional) e volta ao in\u00edcio do fluxo, ou a um bloco escolhido.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Encerramento<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Envia a mensagem de encerramento (opcional) e finaliza o atendimento no painel, como o bot\u00e3o &#8220;Encerrar&#8221;.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">9. Vari\u00e1veis<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Use nas mensagens e campos com chaves duplas: {{nome_da_variavel}}. O nome precisa ser <em>id\u00eantico<\/em>, inclusive mai\u00fasculas e min\u00fasculas ({{cep}} \u00e9 diferente de {{CEP}}).<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Vari\u00e1vel<\/th><th>De onde vem<\/th><\/tr><\/thead><tbody><tr><td>{{contato_nome}}<\/td><td>Nome do contato no WhatsApp<\/td><\/tr><tr><td>{{contato_telefone}}<\/td><td>Telefone do contato<\/td><\/tr><tr><td>{{mensagem_inicial}}<\/td><td>Primeira mensagem do contato nessa sess\u00e3o<\/td><\/tr><tr><td>{{opcao_escolhida}}<\/td><td>R\u00f3tulo da op\u00e7\u00e3o escolhida no \u00faltimo menu<\/td><\/tr><tr><td>{{resposta}}<\/td><td>Texto digitado num menu quando seguiu por &#8220;Cont\u00e9m&#8221; ou &#8220;Padr\u00e3o&#8221;<\/td><\/tr><tr><td>Nome que voc\u00ea der<\/td><td>Bloco Pergunta, Definir Vari\u00e1vel, &#8220;Guardar da resposta&#8221; e &#8220;Lista da resposta&#8221; da Chamada API<\/td><\/tr><tr><td>{{api_status}}, {{api_erro}}<\/td><td>Status HTTP e motivo do erro da \u00faltima Chamada API<\/td><\/tr><tr><td>{{protocolo_chamado}}<\/td><td>Depois de Abrir Chamado<\/td><\/tr><tr><td>{{chamado_status}} e outras chamado_*<\/td><td>Depois de Consultar Chamado<\/td><\/tr><tr><td>{{lead_id}}, {{negocio_id}}<\/td><td>Depois do CRM<\/td><\/tr><tr><td>{{origem_nome}}<\/td><td>Depois do Mapeamento de Origem<\/td><\/tr><tr><td>{{secret.NOME}}<\/td><td>Valor do cofre de Segredos (s\u00f3 dentro da Chamada API, nunca em mensagens)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">10. Chamada API e Segredos<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Campos<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Campo<\/th><th>Para que serve<\/th><\/tr><\/thead><tbody><tr><td>M\u00e9todo e URL<\/td><td>GET, POST, PUT, PATCH ou DELETE. A URL aceita vari\u00e1veis (s\u00e3o codificadas automaticamente).<\/td><\/tr><tr><td>Headers<\/td><td>Pares chave\/valor. <em>O nome do header vai sem dois-pontos<\/em> (ApiKey, n\u00e3o ApiKey:).<\/td><\/tr><tr><td>Body<\/td><td>JSON, Formul\u00e1rio (x-www-form-urlencoded) ou Sem body. Vari\u00e1veis no JSON s\u00e3o escapadas automaticamente; coloque-as entre aspas: &#8220;documento&#8221;: &#8220;{{documento}}&#8221;.<\/td><\/tr><tr><td>Sucesso quando<\/td><td>Al\u00e9m do HTTP 2xx, um campo da resposta precisa existir e n\u00e3o ser vazio\/falso, ou ser igual a um valor. Ex.: payment_url.<\/td><\/tr><tr><td>Guardar da resposta<\/td><td>Vari\u00e1vel \u2190 caminho no JSON. Ex.: saldo \u2190 balance, status \u2190 documento.status, primeiro \u2190 0.due_date.<\/td><\/tr><tr><td>Lista da resposta<\/td><td>Monta um texto com uma linha por item de uma lista. Caminho da lista (use . quando a resposta j\u00e1 \u00e9 a lista), vari\u00e1vel onde guardar, modelo da linha com {{item.campo}} e {{indice}}, m\u00e1ximo de itens (padr\u00e3o 10, at\u00e9 50).<\/td><\/tr><tr><td>Tempo limite<\/td><td>Padr\u00e3o 10 s, at\u00e9 30 s.<\/td><\/tr><tr><td>Mensagem de Sucesso \/ de Erro<\/td><td>Enviadas ao contato conforme o resultado.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Testar API<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>Valores para o teste<\/em>: o editor lista as vari\u00e1veis usadas na requisi\u00e7\u00e3o; preencha com um exemplo (sen\u00e3o a API recebe vazio e costuma responder erro 400\/422).<\/li>\n\n\n\n<li>O resultado mostra sucesso\/erro, tempo, <em>Vari\u00e1veis guardadas<\/em> e o <em>payload<\/em> (resposta da API formatada, com bot\u00e3o Copiar), at\u00e9 8 KB.<\/li>\n\n\n\n<li>O teste \u00e9 uma chamada <em>real<\/em>. Em APIs que criam algo (ex.: recarga), o teste cria de verdade.<\/li>\n\n\n\n<li>Endere\u00e7os de rede interna (localhost, IPs privados) s\u00e3o bloqueados por seguran\u00e7a.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Segredos<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Cofre da empresa para tokens e senhas (\u00edcone de chave). Guardados cifrados; o valor <em>nunca<\/em> aparece de novo na tela nem no Exportar.<\/li>\n\n\n\n<li>Use como {{secret.NOME}} s\u00f3 em URL, headers ou body.<\/li>\n\n\n\n<li>Cada segredo \u00e9 preso a um <em>dom\u00ednio<\/em>: s\u00f3 \u00e9 enviado para o endere\u00e7o cadastrado nele.<\/li>\n\n\n\n<li>Credencial digitada direto num campo (sem {{secret&#8230;}}) gera aviso e <em>bloqueia a publica\u00e7\u00e3o<\/em>.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">11. Relat\u00f3rio, Excel e Execu\u00e7\u00f5es<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">S\u00f3 para *Gestor. Bot\u00f5es *<em>Relat\u00f3rio<\/em> e <em>Execu\u00e7\u00f5es<\/em> no topo do editor.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Relat\u00f3rio do fluxo<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Per\u00edodo: \u00faltimos 7, 30 ou 90 dias.<\/li>\n\n\n\n<li>Resumo: conversas, resolvidas pelo bot, transferidas, desistiram, em andamento (com %).<\/li>\n\n\n\n<li>*Mapa de calor no canvas: cada bloco mostra quantas conversas passaram, quantas pararam ali e quantas vezes *<em>falhou<\/em>.<\/li>\n\n\n\n<li>*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 &#8220;(bloco removido do fluxo)&#8221;.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Execu\u00e7\u00f5es<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Hist\u00f3rico de cada conversa que passou pelo fluxo (n\u00e3o \u00e9 em tempo real).<\/li>\n\n\n\n<li>Filtros: \u00faltimas 24 horas, 7, 30 ou 90 dias; Todas, Com falha ou Sem falha.<\/li>\n\n\n\n<li>Cada item: contato, data, resultado (Conclu\u00edda, Encerrada pelo bot, Transferida, Desistiu, Em andamento), passos e falhas.<\/li>\n\n\n\n<li>Ao abrir uma execu\u00e7\u00e3o:\n<ul class=\"wp-block-list\">\n<li>no canvas, os blocos por onde passou ficam <em>verdes<\/em> com o n\u00famero do passo; o que falhou fica <em>vermelho<\/em> com o motivo;<\/li>\n\n\n\n<li>no painel, a linha do tempo com o hor\u00e1rio de cada passo. Clique num passo para achar o bloco.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><em>O que conta como falha<\/em>: Chamada API que falhou (com o motivo, ex.: &#8220;API respondeu Unprocessable Entity (422)&#8221;), chamado que n\u00e3o abriu, chamado n\u00e3o encontrado, CRM (com a mensagem do sistema), Agente de IA que n\u00e3o respondeu, m\u00eddia com link inv\u00e1lido ou que o canal n\u00e3o enviou, respostas inv\u00e1lidas esgotadas, fluxo em la\u00e7o.<\/li>\n\n\n\n<li><em>N\u00e3o<\/em> contam como falha: Condi\u00e7\u00e3o falsa, fora do hor\u00e1rio, nenhuma frase de campanha bateu (s\u00e3o caminhos previstos).<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">12. Exemplos prontos (adminws)<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">APIs do adminws (<a href=\"https:\/\/ws.falemaisvoip.com.br\/ad\/api\/\">https:\/\/ws.falemaisvoip.com.br\/ad\/api\/<\/a>&#8230;). Em todas: m\u00e9todo <em>POST<\/em>, header ApiKey = {{secret.ADMINWS_APIKEY}}, body JSON. O client_id aceita c\u00f3digo, CPF ou CNPJ do cliente.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Consultar saldo \u2014 balance.php<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Body: {&#8220;client_id&#8221;: &#8220;{{documento}}&#8221;}<\/li>\n\n\n\n<li>Guardar da resposta: saldo \u2190 balance<\/li>\n\n\n\n<li>Sucesso: \ud83d\udcb0 Seu saldo atual \u00e9 R$ {{saldo}}<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Faturas em aberto \u2014 statements.php<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Body: {&#8220;client_id&#8221;: &#8220;{{documento}}&#8221;} \u2014 a resposta j\u00e1 \u00e9 uma lista.<\/li>\n\n\n\n<li>Lista da resposta: caminho ., guardar em faturas, linha {{indice}}. \ud83d\udcc5 {{item.due_date}} \u2014 R$ {{item.amount}} \ud83d\udd17 {{item.payment_url}}, m\u00e1ximo 5.<\/li>\n\n\n\n<li>Sucesso: \ud83d\udcc4 <em>Suas faturas em aberto:<\/em>\\n\\n{{faturas}}<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Nota fiscal \u2014 invoices.php<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Perguntas antes: m\u00eas (mes, valida\u00e7\u00e3o N\u00famero, ex.: 09) e ano (ano, ex.: 2026).<\/li>\n\n\n\n<li>Body: {&#8220;client_id&#8221;: &#8220;{{documento}}&#8221;, &#8220;month&#8221;: &#8220;{{mes}}&#8221;, &#8220;year&#8221;: &#8220;{{ano}}&#8221;}<\/li>\n\n\n\n<li>Lista da resposta: caminho ., guardar em notas, linha {{indice}}. \ud83d\udcc5 Venc. {{item.due_date}} \u00b7 pago em {{item.payment_date}} \ud83d\udd17 {{item.url}}.<\/li>\n\n\n\n<li>S\u00f3 traz cobran\u00e7as <em>pagas<\/em> do m\u00eas. Sem nota: a API responde 404 e o bloco sai pelo erro.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Recarga de cr\u00e9ditos \u2014 balance_add.php<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Fluxo: Saldo \u2192 Mensagem com op\u00e7\u00f5es &#8220;Deseja fazer uma recarga?&#8221; (Sim\/N\u00e3o) \u2192 Pergunta do valor \u2192 Chamada API.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Pergunta do valor: vari\u00e1vel valor, valida\u00e7\u00e3o <em>Qualquer texto<\/em> (n\u00e3o use N\u00famero).<\/li>\n\n\n\n<li>Body: {&#8220;client_id&#8221;: &#8220;{{documento}}&#8221;, &#8220;price&#8221;: &#8220;{{valor}}&#8221;, &#8220;payment_method&#8221;: &#8220;UNDEFINED&#8221;} (UNDEFINED = o cliente escolhe PIX, boleto ou cart\u00e3o na p\u00e1gina).<\/li>\n\n\n\n<li>Valor inteiro de 30 a 5000 (50,00 \u00e9 recusado).<\/li>\n\n\n\n<li><em>Sucesso quando<\/em>: payment_url (se o Asaas falhar, a API responde 201 sem link).<\/li>\n\n\n\n<li>Guardar: link_pagamento \u2190 payment_url, vencimento \u2190 due_date. Tempo limite 20 s.<\/li>\n\n\n\n<li><em>Aten\u00e7\u00e3o: cria cobran\u00e7a real no Asaas<\/em> (vencimento em 3 dias \u00fateis), inclusive no &#8220;Testar API&#8221;. Em teste, use cliente de teste e cancele a cobran\u00e7a depois.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Aten\u00e7\u00e3o de seguran\u00e7a:<\/em> hoje essas APIs aceitam qualquer CPF\/c\u00f3digo. Quem chegar nesses blocos consegue consultar ou gerar cobran\u00e7a para outro cliente. Uma checagem do telefone do contato est\u00e1 prevista.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">13. Problemas comuns<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Sintoma<\/th><th>Causa prov\u00e1vel<\/th><th>O que verificar \/ fazer<\/th><\/tr><\/thead><tbody><tr><td>Bot n\u00e3o responde nada<\/td><td>Fluxo n\u00e3o publicado, canal n\u00e3o ligado ao fluxo, ou m\u00f3dulo desligado<\/td><td>Selo *Publicado; bot\u00e3o *<em>Canais<\/em> do fluxo; m\u00f3dulo All-Bot na empresa<\/td><\/tr><tr><td>Bot parou no meio<\/td><td>Um atendente assumiu ou a conversa foi transferida<\/td><td>Normal: com atendente, o bot fica quieto. Depois recome\u00e7a do in\u00edcio<\/td><\/tr><tr><td>Bot ignora foto ou \u00e1udio<\/td><td>O fluxo s\u00f3 entende texto<\/td><td>Pe\u00e7a para o contato responder em texto<\/td><\/tr><tr><td>Contato voltou e caiu no in\u00edcio<\/td><td>Passou o tempo de &#8220;Recome\u00e7ar o fluxo&#8221;<\/td><td>Ajuste em Configura\u00e7\u00f5es do fluxo<\/td><\/tr><tr><td>Menu repete &#8220;op\u00e7\u00e3o inv\u00e1lida&#8221;<\/td><td>A liga\u00e7\u00e3o n\u00e3o bate com o <em>valor<\/em> da op\u00e7\u00e3o<\/td><td>Na liga\u00e7\u00e3o &#8220;Resposta exata&#8221;, use o valor da op\u00e7\u00e3o (um s\u00f3, ex.: 1)<\/td><\/tr><tr><td>Transferiu sozinho depois de respostas erradas<\/td><td>Limite de respostas inv\u00e1lidas<\/td><td>Configura\u00e7\u00f5es do fluxo, ou crie a sa\u00edda &#8220;Respostas inv\u00e1lidas esgotadas&#8221;<\/td><\/tr><tr><td>Vari\u00e1vel sai vazia na mensagem<\/td><td>Nome diferente (mai\u00fasculas, acento, espa\u00e7o)<\/td><td>{{cep}} \u2260 {{CEP}}. Confira no bloco que guarda a vari\u00e1vel<\/td><\/tr><tr><td>API d\u00e1 erro 401\/403<\/td><td>Header com nome errado ou segredo errado<\/td><td>Nome do header <em>sem<\/em> dois-pontos; segredo cadastrado e com o dom\u00ednio certo<\/td><\/tr><tr><td>API d\u00e1 400\/422 no teste<\/td><td>Vari\u00e1vel vazia na requisi\u00e7\u00e3o<\/td><td>Preencha <em>Valores para o teste<\/em><\/td><\/tr><tr><td>&#8220;segredo n\u00e3o permitido para este endere\u00e7o&#8221;<\/td><td>Dom\u00ednio do segredo diferente do da URL<\/td><td>Ajuste o dom\u00ednio do segredo<\/td><\/tr><tr><td>&#8220;endere\u00e7o de rede interna n\u00e3o permitido&#8221;<\/td><td>URL aponta para IP interno\/localhost<\/td><td>Use o endere\u00e7o p\u00fablico da API<\/td><\/tr><tr><td>API sempre cai no erro<\/td><td>&#8220;Sucesso quando&#8221; aponta para um campo que n\u00e3o vem<\/td><td>Veja o <em>payload<\/em> no Testar API e ajuste o caminho<\/td><\/tr><tr><td>Lista vazia<\/td><td>Caminho da lista errado<\/td><td>Resposta que j\u00e1 \u00e9 uma lista: caminho .<\/td><\/tr><tr><td>M\u00eddia n\u00e3o chega no WhatsApp oficial<\/td><td>Acima do limite da Meta<\/td><td>Imagem at\u00e9 5 MB; \u00e1udio\/v\u00eddeo at\u00e9 16 MB<\/td><\/tr><tr><td>Upload de m\u00eddia recusado<\/td><td>Arquivo acima de 20 MB ou tipo diferente do escolhido<\/td><td>Reduza o arquivo ou troque o tipo no bloco<\/td><\/tr><tr><td>N\u00e3o consigo publicar<\/td><td>Erros de valida\u00e7\u00e3o<\/td><td>Lista &#8220;Corrija antes de publicar&#8221;: clique no erro para ir ao bloco<\/td><\/tr><tr><td>N\u00e3o aparecem bot\u00f5es de editar\/publicar<\/td><td>Perfil sem permiss\u00e3o<\/td><td>S\u00f3 o <em>Gestor<\/em> edita; gerente e demais s\u00f3 visualizam<\/td><\/tr><tr><td>N\u00e3o vejo Relat\u00f3rio\/Execu\u00e7\u00f5es<\/td><td>Perfil sem permiss\u00e3o<\/td><td>S\u00f3 o <em>Gestor<\/em> v\u00ea<\/td><\/tr><tr><td>&#8220;muitas requisi\u00e7\u00f5es seguidas&#8221;<\/td><td>Limite de uso do editor<\/td><td>Aguarde um minuto<\/td><\/tr><tr><td>Recarga sem link<\/td><td>Asaas falhou na hora<\/td><td>Configure &#8220;Sucesso quando&#8221; = payment_url; tente de novo<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Para investigar um caso espec\u00edfico, use <em>Execu\u00e7\u00f5es<\/em> com o filtro &#8220;Com falha&#8221;: mostra o caminho da conversa e o motivo exato da falha.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">14. Limites e n\u00fameros<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Item<\/th><th>Limite<\/th><\/tr><\/thead><tbody><tr><td>Bot\u00f5es nativos (WhatsApp oficial)<\/td><td>At\u00e9 3 bot\u00f5es; 4 a 10 op\u00e7\u00f5es viram lista; texto do menu at\u00e9 1024 caracteres<\/td><\/tr><tr><td>Intervalo entre mensagens<\/td><td>0 a 10 s; no m\u00e1ximo 45 s de espera somada por resposta<\/td><\/tr><tr><td>Recome\u00e7ar o fluxo<\/td><td>15 min a 1 dia, ou nunca (padr\u00e3o 30 min)<\/td><\/tr><tr><td>Respostas inv\u00e1lidas<\/td><td>Sem limite, 2, 3, 4, 5 ou 10 (padr\u00e3o 3)<\/td><\/tr><tr><td>Blocos seguidos sem esperar resposta<\/td><td>25 (acima disso o fluxo para, por suspeita de la\u00e7o)<\/td><\/tr><tr><td>Chamada API<\/td><td>Tempo limite padr\u00e3o 10 s, m\u00e1ximo 30 s<\/td><\/tr><tr><td>Testar API<\/td><td>Mostra at\u00e9 8 KB da resposta<\/td><\/tr><tr><td>Lista da resposta<\/td><td>Padr\u00e3o 10 itens, m\u00e1ximo 50<\/td><\/tr><tr><td>Upload de m\u00eddia<\/td><td>20 MB<\/td><\/tr><tr><td>M\u00eddia no WhatsApp oficial<\/td><td>Imagem 5 MB; \u00e1udio e v\u00eddeo 16 MB; documento 100 MB<\/td><\/tr><tr><td>Mem\u00f3ria do Agente de IA<\/td><td>\u00daltimas 20 mensagens<\/td><\/tr><tr><td>Arquivo de importa\u00e7\u00e3o<\/td><td>512 KB<\/td><\/tr><tr><td>Relat\u00f3rio<\/td><td>7, 30 ou 90 dias<\/td><\/tr><tr><td>Execu\u00e7\u00f5es<\/td><td>24 h, 7, 30 ou 90 dias; 50 por p\u00e1gina (&#8220;Carregar mais&#8221;)<\/td><\/tr><tr><td>Uso do editor<\/td><td>300 a\u00e7\u00f5es por minuto por usu\u00e1rio; Simulador e Testar API: 30 por minuto<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>Guia do All-Bot (para o Suporte) O All-Bot \u00e9 o bot de atendimento por fluxo visual da Allenda. A empresa desenha o fluxo (menus, perguntas, consultas a sistemas, chamados, CRM, transfer\u00eancia para atendentes) num editor de blocos, liga o fluxo aos canais de WhatsApp e o bot passa a atender sozinho. Este guia explica o &#8230; <a title=\"Criar o ALLBOOT\" class=\"read-more\" href=\"https:\/\/centraldetreinamento.falemaisvoip.com.br\/?epkb_post_type_1=criar-o-allboot\" aria-label=\"Read more about Criar o ALLBOOT\">Ler mais<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_themeisle_gutenberg_block_has_review":false,"footnotes":""},"epkb_post_type_1_category":[29],"epkb_post_type_1_tag":[],"class_list":["post-905","epkb_post_type_1","type-epkb_post_type_1","status-publish","hentry","epkb_post_type_1_category-allenda"],"_links":{"self":[{"href":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1\/905","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1"}],"about":[{"href":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/index.php?rest_route=\/wp\/v2\/types\/epkb_post_type_1"}],"author":[{"embeddable":true,"href":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=905"}],"version-history":[{"count":1,"href":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1\/905\/revisions"}],"predecessor-version":[{"id":906,"href":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1\/905\/revisions\/906"}],"wp:attachment":[{"href":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=905"}],"wp:term":[{"taxonomy":"epkb_post_type_1_category","embeddable":true,"href":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/index.php?rest_route=%2Fwp%2Fv2%2Fepkb_post_type_1_category&post=905"},{"taxonomy":"epkb_post_type_1_tag","embeddable":true,"href":"https:\/\/centraldetreinamento.falemaisvoip.com.br\/index.php?rest_route=%2Fwp%2Fv2%2Fepkb_post_type_1_tag&post=905"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}