Referência
Referência: blocos de lógica
Disponível no módulo Fluxos
Atualizado em 16/11/2026
Os blocos de lógica são os que não falam com o cliente, ou falam só como consequência: eles decidem para onde o fluxo vai, esperam, fazem alguma coisa no sistema ou chamam algo de fora. Este artigo descreve cada um, com o nome que aparece na paleta, cada campo do painel, as saídas e o que acontece na hora de rodar. Para entender o que é um fluxo, veja O que é Fluxos. Para montar um do zero, veja Como criar um fluxo. Para conferir o comportamento antes de ativar, veja Como testar um fluxo. Os botões e as telas do construtor ficam em Referência: Fluxos, o primeiro bloco do fluxo em Referência: gatilhos e as variáveis que você pode usar nos campos em Referência: variáveis. Os blocos que conversam com o cliente (Mensagem, Pergunta, Modelo e Agente de IA) ficam em Referência: blocos de conversa.
Menu: Automação > Fluxos. Abra um fluxo e clique no bloco para abrir o painel lateral. Ver os blocos exige a permissão Ver em Fluxos. Editar exige Gerenciar.
Onde ficam na paleta
Seção intitulada “Onde ficam na paleta”A paleta lateral agrupa os blocos pelo que eles fazem:
| Grupo | Blocos |
|---|---|
| Conversa | Mensagem, Pergunta, Aguardar mensagem, Modelo, Cobrança, Agendamento |
| Decisão | Condição, Horário e feriados, Atraso |
| Automação | Ação, Agente de IA, Chamar API |
Agendamento só aparece se a conta tem o módulo Agenda. Cobrança só aparece se a conta tem o módulo Integrações. Sem o módulo, o bloco some da paleta.
Tabela-resumo
Seção intitulada “Tabela-resumo”| Bloco | Para que serve | Saídas |
|---|---|---|
| Condição | Separa os contatos em caminhos conforme etiqueta, canal, conta, etapa do negócio, status da cobrança, campos e variáveis | Uma saída por ramificação, mais Senão |
| Horário e feriados | Pergunta se agora é horário de atendimento | Aberto, Fechado, Feriado |
| Atraso | Espera um tempo ou até uma data antes de seguir | Uma saída (e Data já passou, no modo data) |
| Aguardar mensagem | Para o fluxo até o cliente mandar a próxima mensagem | Recebeu a mensagem, Sem resposta em (tempo) |
| Ação | Executa uma ou mais ações no sistema (fila, etiqueta, tarefa, negócio, outro fluxo…) | Uma saída |
| Chamar API | Consulta um sistema de fora e guarda a resposta em variáveis | deu certo, falhou |
| Agente de IA | Passa a conversa para um Agente de IA | Resolvido, uma por transferência do agente, Humano, e Sem resposta em (tempo), se ligada |
| Agendamento | Oferece horários da agenda e marca o escolhido | Marcado, Sem horário, Desistiu |
| Cobrança | Cria uma cobrança no Asaas e manda por modelo de pagamento | pagou, não pagou em (tempo), falhou |
Regras que valem para todos os blocos
Seção intitulada “Regras que valem para todos os blocos”- Saída sem ligação termina o fluxo. Se uma saída não está ligada a nenhum bloco, o contato que sai por ela chega ao fim da execução. Para alguns blocos isso é permitido; para outros, o construtor exige a ligação para ativar (cada bloco abaixo diz qual).
- Fluxo em rascunho salva sem conferir. O construtor só confere as pendências de cada bloco quando o fluxo está ativo: ao ativar e a cada salvamento depois disso. O aviso é “O fluxo tem um problema que impede a ativação: …” (um problema) ou “O fluxo tem N problemas que impedem a ativação. O primeiro: …” (vários). Enquanto o fluxo está em rascunho, o selo vermelho no bloco já mostra a pendência, mas o salvamento passa.
- Nome do bloco repetido. Quando há dois ou mais blocos do mesmo tipo, as mensagens trazem o número: “Condição 1”, “Condição 2”.
- Ciclos. Um fluxo pode voltar para um bloco anterior, mas só se o caminho de volta passar por um bloco que espera o cliente (Aguardar mensagem, Pergunta, Agendamento, Agente de IA ou Modelo que espera resposta). Sem isso, o construtor recusa: “O fluxo contém um ciclo sem esperar o cliente: coloque um bloco Aguardar mensagem no caminho de volta”.
- Histórico. Cada bloco que roda grava um passo na aba Execuções do fluxo, inclusive o motivo quando algo dá errado.
- Limite de espera. Os tempos de espera de todos os blocos vão de 1 minuto a 30 dias.
Condição
Seção intitulada “Condição”Paleta: Decisão > Condição (“Ramifica o fluxo”). Separa os contatos em caminhos. Cada ramificação é uma regra do tipo “se este campo for assim”; o contato segue pela primeira ramificação que bater.
Um bloco novo já nasce com uma ramificação: campo Etiqueta, operador “tem a etiqueta” e valor vazio.
Campos de cada ramificação
Seção intitulada “Campos de cada ramificação”Cada ramificação aparece como um cartão “Ramificação 1”, “Ramificação 2” etc., com o botão Remover no canto. Os campos, de cima para baixo:
| Campo | O que é |
|---|---|
| Campo | O que será comparado. Veja a lista na próxima seção. |
| Tipo | Só aparece quando o campo aceita mais de um jeito de comparar (campos de variável). Opções: Texto, Número, Data. Trocar o tipo volta o operador para o primeiro da lista e apaga o Até. |
| Operador | A comparação. As opções dependem do tipo (tabela mais abaixo). |
| Valor | O que comparar. Quando o campo tem valores conhecidos (etiquetas, canais, contas, etapas, opções de lista), vira uma lista para escolher. Nos outros casos é uma caixa de texto. Some quando o operador é “está preenchido” ou “está vazio”. |
| Até | Só aparece com o operador “entre”: o fim do intervalo. |
Sugestões que aparecem na caixa de texto do Valor (e do Até): Ex.: ouro para texto, Ex.: 18 para número, Ex.: 2026-01-01 para data e Ex.: vip para etiqueta.
O botão Adicionar ramificação cria outra regra. Logo abaixo, uma nota fixa lembra: “Senão: a saída de quem não bateu em nenhuma ramificação acima. Existe sempre e não se configura.”
O que dá para comparar (lista Campo)
Seção intitulada “O que dá para comparar (lista Campo)”| Opção na lista | Compara com | Tipo | Valores para escolher |
|---|---|---|---|
| Etiqueta | As etiquetas do contato | Etiqueta | As etiquetas cadastradas |
| Canal | O canal da conversa | Texto | WhatsApp, Instagram, Messenger, Telegram, Canal universal |
| Conta | O número (ou o nome) do canal conectado em que a conversa acontece | Texto | As contas conectadas |
| Etapa do negócio | A etapa do negócio aberto mais recente do contato | Texto | Nomes de etapas de todos os funis, sem repetir |
| Status da cobrança | A cobrança que disparou o fluxo | Texto | Em aberto, Vencida, Paga, Cancelada |
| Campo: nome | Um campo personalizado do contato | Número, Data ou Texto, conforme o campo | Opções do campo, para listas; “sim” e “não”, para campo de sim ou não |
| Empresa: nome | Um campo personalizado da empresa | Idem | Idem |
| Negócio: nome | Um campo personalizado do negócio | Idem | Idem |
| Recebido: nome | Um dado que veio no webhook que iniciou o fluxo | Texto, Número ou Data | Você digita |
| Variável: nome | Uma variável criada por uma ação Definir variável do fluxo | Texto, Número ou Data | Você digita |
| Sempre (bate em qualquer caso) | Nada: sempre vale | Sempre | Nenhum |
Observações:
- Status da cobrança só aparece quando o fluxo começa por um gatilho de cobrança (ou se alguma ramificação já usava esse campo). Aceita só os operadores “é” e “não é”.
- Campos personalizados dos tipos Endereço, Arquivo e Usuário não aparecem na lista. Número e valor em dinheiro viram Número, data vira Data e os demais viram Texto.
- As opções Recebido (dados do webhook) e Variável só aparecem se o fluxo realmente usa esses dados. Veja Referência: variáveis.
- Sempre serve como ramificação final quando você quer um caminho explícito em vez do Senão. Como as ramificações são lidas em ordem, coloque-a por último.
Operadores por tipo
Seção intitulada “Operadores por tipo”| Tipo | Operadores |
|---|---|
| Texto | é, não é, contém, começa com, está preenchido, está vazio |
| Número | é, não é, maior que, maior ou igual a, menor que, menor ou igual a, entre, está preenchido, está vazio |
| Data | é, não é, antes de, depois de, entre, está preenchido, está vazio |
| Etiqueta | tem a etiqueta, não tem a etiqueta |
| Sempre | sempre |
| Status da cobrança | é, não é |
Validação
Seção intitulada “Validação”Cada ramificação mostra o problema logo abaixo:
| Mensagem | Quando aparece |
|---|---|
| Selecione o campo | O campo está vazio |
| Campo não pode ser comparado como Tipo | O tipo escolhido não combina com o campo (o nome do campo e do tipo entram na frase) |
| Defina o valor | O operador pede um valor e ele está vazio |
| Defina o fim do intervalo | O operador é “entre” e o Até está vazio |
O bloco tem uma saída por ramificação, na mesma ordem em que você as montou, mais a saída fixa Senão. O nome da saída é a própria regra escrita por extenso: “Etiqueta tem a etiqueta vip”, “Número de compras entre 3 e 10”. No status da cobrança, a saída mostra o rótulo do status (“Paga”). A ramificação Sempre aparece como “Sempre”.
Para ativar o fluxo, todas as saídas precisam estar ligadas, inclusive o Senão. Se alguma estiver solta, a ativação é recusada com A saída "etiqueta" do bloco Condição não está conectada., com o nome do campo no lugar de “etiqueta”. Se não houver uma regra para o resto, ligue o Senão a um bloco de fim (uma Ação com Encerrar execução, por exemplo).
O que acontece na execução
Seção intitulada “O que acontece na execução”- A primeira ramificação que bater vence. As ramificações são avaliadas de cima para baixo e o contato segue só pela primeira que valer. Se nenhuma valer, ele segue pelo Senão.
- Texto diferencia maiúsculas de minúsculas. “é”, “contém” e “começa com” comparam o texto exato: “Vip” não é igual a “vip”. “não é” vale quando nenhum dos valores do campo é igual ao valor da regra.
- Campos de lista (escolha múltipla). A ramificação bate se qualquer item da lista bate. “não é” só vale se nenhum item bate.
- “está preenchido” e “está vazio”. Vazio é campo sem valor, só com espaços ou lista sem itens.
- Número. Use ponto para decimais (
10.5), nunca vírgula: “10,5” não é lido como número. Se o valor do campo ou o da regra não for um número válido, a ramificação não bate e o contato cai no Senão. “entre” inclui as duas pontas. - Data. Escreva no formato
AAAA-MM-DD(ouAAAA-MM-DDTHH:MM, com hora). Uma data inválida faz a ramificação não bater. “entre” inclui as duas pontas. - Etiqueta. Compara o nome da etiqueta com as etiquetas que o contato tem naquele momento, inclusive as que uma ação anterior do mesmo fluxo acabou de adicionar.
- Canal. Para o WhatsApp, o canal é sempre “WhatsApp”, seja a conexão oficial ou não. Sem conversa (um gatilho que não tem conversa), o canal fica vazio e nenhuma regra de canal bate.
- Etapa do negócio. Olha o negócio aberto mais recente do contato. Se o nome da etapa existe em dois funis, a regra vale para os dois. Sem negócio aberto, “é” não bate e “não é” bate.
- Status da cobrança. Lê a cobrança que disparou o fluxo. Sem cobrança, o campo fica vazio.
- Campos personalizados. Leem o valor atual, inclusive o que uma ação anterior do mesmo fluxo gravou. Os campos de sim ou não são comparados como “sim” e “não”. As variáveis (Recebido e Variável) são sempre lidas como texto antes de comparar com o tipo que você escolheu.
Horário e feriados
Seção intitulada “Horário e feriados”Paleta: Decisão > Horário e feriados (“Aberto, fechado ou feriado”). Pergunta se agora está dentro do horário de atendimento e manda o contato por um de três caminhos. Use antes de transferir para uma fila, para não prometer atendimento fora do expediente.
Campos do painel
Seção intitulada “Campos do painel”| Campo | O que é |
|---|---|
| Horário e feriados | Qual horário o bloco consulta. Obrigatório. Cada opção mostra o nome do horário e, ao lado, o fuso. |
| Novo horário | Abre a janela para criar um horário sem sair do fluxo. Ao salvar, o bloco já passa a usá-lo. |
| Editar dias e horas | Abre o horário escolhido para edição. Fica desabilitado enquanto nenhum horário está escolhido. |
Avisos que podem aparecer:
- Amarelo: “O horário comercial que este bloco consultava não existe mais. Escolha outro.”
- Azul: “Nenhum horário comercial cadastrado ainda. Crie um aqui mesmo, em Novo horário.”
A janela Novo horário comercial
Seção intitulada “A janela Novo horário comercial”O título muda para “Editar horário comercial” quando você edita. O subtítulo é “Os dias e as faixas em que o fluxo considera o atendimento aberto”.
| Campo | O que é |
|---|---|
| Nome | Obrigatório. Sugestão: Ex.: Suporte. |
| Fuso horário | Padrão America/Sao_Paulo. As faixas valem nesse fuso, não no de quem está atendendo. |
| Dias e faixas | Uma linha por dia, de domingo a sábado. Cada dia liga e desliga no botão do nome. O horário novo já nasce com segunda a sexta, das 09:00 às 18:00, e sábado e domingo “Fechado o dia inteiro”. |
| Calendários de feriados | Marque os calendários cujos feriados fecham o atendimento. Sem calendário cadastrado, aparece “Nenhum calendário cadastrado ainda. Crie em Configurações, Horário de atendimento.” |
Atalhos nos dias e faixas:
- O botão Seg a sex, 09:00 às 18:00 preenche a semana útil de uma vez.
- Adicionar faixa em (o dia) cria uma segunda faixa no mesmo dia, para atender com pausa de almoço, por exemplo.
- Cada faixa tem dois campos de hora (
09:00e18:00, formato 24 horas) e uma lixeira para remover. - Repetir (o dia) em todos os dias copia as faixas daquele dia para os sete dias.
- No computador, a Prévia da semana mostra uma barra de 24 horas por dia, o total de horas da semana e o fuso.
Validação ao salvar:
| Mensagem | Quando |
|---|---|
| Escreva o nome do horário comercial | O Nome está vazio |
| A hora precisa estar no formato HH:MM | Uma hora escrita fora do padrão |
| O fim precisa vir depois do início | O fim é igual ou anterior ao início. Uma faixa não atravessa a meia-noite: para atender até de madrugada, divida em duas faixas, uma até 23:59 num dia e outra a partir de 00:00 no outro |
O erro vem com o dia na frente, por exemplo “Segunda: O fim precisa vir depois do início”. Depois de salvar, aparecem os avisos “Horário criado” ou “Horário salvo”. Se faltar permissão para gerenciar o horário, a janela diz “Sem permissão para gerenciar o horário comercial.”
O bloco tem três saídas que existem sempre e não se configuram:
| Saída | Quando sai por ela |
|---|---|
| Aberto | Agora está dentro de alguma faixa do dia |
| Fechado | Agora está fora das faixas |
| Feriado | Hoje é feriado de algum dos calendários marcados. Feriado vale mais que o dia da semana |
As três saídas precisam estar ligadas para ativar o fluxo. O construtor não avisa isso antes de você tentar ativar: a recusa vem na ativação, com A saída "Aberto" do bloco Horário comercial não está conectada. (aqui o bloco aparece com o nome antigo, Horário comercial).
Pendência que impede ativar: “Escolha qual horário comercial o bloco consulta”.
O que acontece na execução
Seção intitulada “O que acontece na execução”- O bloco converte a hora de agora para o fuso do horário escolhido e decide nesta ordem: Feriado (data exata ou repetida todo ano, nos calendários marcados), depois Aberto (dentro de uma faixa do dia da semana), senão Fechado.
- A faixa começa incluída e termina excluída: se o expediente vai até 18:00, às 18:00 em ponto o contato já sai por Fechado.
- Se o horário escolhido for apagado depois, o bloco passa a mandar todo mundo por Fechado, sem avisar o contato. A pendência só aparece ao abrir ou ativar o fluxo: “Bloco Horário comercial: o horário comercial que ele consulta não existe mais”.
Paleta: Decisão > Atraso (“Espera um tempo ou até uma data”). Segura o contato por um tempo, ou até uma data (como o vencimento de uma cobrança), e depois segue. Um bloco novo já nasce com 5 minutos.
O campo Modo da espera troca o painel entre Esperar um tempo e Esperar até a data. Ao trocar de modo, os campos mudam e as ligações da saída Data já passou são removidas se você sair do modo data.
Modo Esperar um tempo
Seção intitulada “Modo Esperar um tempo”| Campo | O que é |
|---|---|
| Duração | Um número com os botões de menos e de mais (o mínimo é 1) e a unidade: minutos, horas ou dias. |
| Atalhos | 5 minutos, 15 minutos, 30 minutos, 1 hora, 3 horas, 1 dia. |
Abaixo, a frase-resumo: “O fluxo aguarda 5 minutos antes de seguir.” Valores menores que 1 viram 1, e decimais são cortados.
O limite é 30 dias. A tela não trava a digitação: se você passar disso, o erro aparece no selo do bloco e ao salvar: “A espera não pode passar de 30 dias”. Se a duração ficar abaixo de 1, o erro é “Defina a duração”.
Saída: uma só. No cartão do canvas, o bloco mostra o tempo seguido de “de espera”.
Modo Esperar até a data
Seção intitulada “Modo Esperar até a data”Use para réguas, como “3 dias antes do vencimento, às 9h”. Os campos, na ordem:
| Campo | O que é |
|---|---|
| Data de referência | De onde vem a data. Opções: Vencimento da cobrança (só em fluxo que começa por gatilho de cobrança) e cada campo personalizado do contato do tipo data. Sem nenhuma opção, aparece o aviso azul explicando que o vencimento da cobrança só existe com gatilho de cobrança e que, para usar uma data do contato, é preciso cadastrar um campo do tipo data. |
| Quantidade | Número inteiro, a partir de 0. Padrão 3. Com 0, o fluxo segue no próprio dia. |
| Unidade | dias ou horas (não tem minutos). |
| Quando | antes ou depois da data. Padrão antes. |
| Hora do dia | Horário em que o fluxo segue, no formato 24 horas. Padrão 09:00. |
| Só em horário comercial | Caixa de seleção. Marcada, aparece a lista Horário comercial (padrão “Horário padrão da conta” ou um dos horários cadastrados). Fora do horário, no fim de semana ou em feriado, o passo fica para o próximo dia útil, no primeiro horário aberto. |
| Se a data já passou, pular este passo | Caixa de seleção, marcada por padrão. Marcada, o bloco ganha a saída Data já passou, que deve ser ligada ao passo seguinte para a régua continuar. |
No fim do painel, a frase-resumo mostra o que o bloco vai fazer, por exemplo “O fluxo segue 3 dias antes do vencimento, às 09:00” ou “no dia do vencimento, às 09:00” (quantidade 0). Se houver erro, ele aparece em vermelho no lugar da frase.
Validação:
| Mensagem | Quando |
|---|---|
| Escolha a data de referência | Nenhuma data escolhida |
| Defina a distância da data | A quantidade não é um número inteiro, ou é negativa |
| A distância da data vai em horas ou dias | A unidade ficou em minutos |
| Defina a hora do dia | A hora está fora do formato HH:MM |
| A distância da data não pode passar de 365 dias | O afastamento passa de 365 dias (horas são convertidas em dias) |
Outras pendências:
- Se Vencimento da cobrança estiver escolhido num fluxo que não começa por gatilho de cobrança, o erro é “Bloco Atraso: só funciona em fluxo que começa por um gatilho de cobrança”.
- Se Se a data já passou, pular este passo estiver marcado e a saída Data já passou não estiver ligada, a ativação é recusada com
A saída "Data já passou" do bloco Atraso não está conectada.
O que acontece na execução
Seção intitulada “O que acontece na execução”- Modo tempo. O contato fica parado pelo tempo escolhido e depois segue pela saída.
- Modo data. O bloco pega o dia da data de referência, aplica a distância (“3 dias antes”, por exemplo) e usa a hora do dia que você escolheu. O fuso é o do horário comercial selecionado; sem horário selecionado, é o do horário comercial mais antigo da conta; sem nenhum horário na conta, é
America/Sao_Paulo. - Só em horário comercial. Se o momento cai fora da faixa, em dia fechado ou em feriado, o bloco avança para o próximo momento aberto. Se não encontrar nenhum momento aberto no período que procura, usa o momento original.
- Contato sem a data. Se o campo de data do contato está vazio, o contato não espera: segue na hora. O motivo “sem data de referência para esperar” fica registrado em Execuções.
- Data que já passou. O contato também não espera. Com Se a data já passou, pular este passo marcado, sai pela saída Data já passou. Desmarcado, sai pela saída normal, na hora. O motivo “a data já passou” fica registrado em Execuções.
Aguardar mensagem
Seção intitulada “Aguardar mensagem”Paleta: Conversa > Aguardar mensagem (“Espera o cliente responder”). Não envia nada: o fluxo para aqui e espera a próxima mensagem do cliente. Quando ela chega, o fluxo segue com {{mensagem.texto}} já valendo o que o cliente acabou de mandar. É o bloco certo para voltar a um bloco anterior (um Chamar API, por exemplo) e conversar em repetição. No cartão do canvas, aparece “O fluxo para aqui até o cliente mandar a próxima mensagem.”
Campo do painel
Seção intitulada “Campo do painel”| Campo | O que é |
|---|---|
| Esperar a mensagem por | Um número com a unidade (minutos, horas ou dias) e atalhos: 15 minutos, 30 minutos, 1 hora, 4 horas, 12 horas, 1 dia, 3 dias. Padrão 1 dia. Mínimo 1 minuto, máximo 30 dias. |
Abaixo do campo: “Passado esse tempo, o fluxo segue pela saída Sem resposta.” Os avisos que podem aparecer:
- Amarelo, para esperas acima de 24 horas: a janela de 24 horas do WhatsApp já estará fechada quando o prazo vencer, então o bloco ligado em Sem resposta precisa de um modelo aprovado de reserva, senão a mensagem não chega ao contato.
- Azul, quando o tempo é exatamente 30 dias: “30 dias é o máximo.”
O bloco não tem validação própria: está sempre válido.
| Saída | Quando |
|---|---|
| Recebeu a mensagem | O cliente mandou uma mensagem dentro do prazo |
| Sem resposta em (tempo), por exemplo “Sem resposta em 1 dia” | O prazo acabou sem mensagem |
Nenhuma das duas é obrigatória para ativar. Se Sem resposta estiver solta, o fluxo termina quando o prazo vence.
O que acontece na execução
Seção intitulada “O que acontece na execução”Ao chegar a mensagem, o fluxo segue por Recebeu a mensagem e as variáveis {{mensagem.texto}}, {{mensagem.tipo}}, {{mensagem.transcricao}} e {{mensagem.descricao}} ficam preenchidas. Se o prazo vence, o fluxo segue por Sem resposta. O bloco não tem nova tentativa: espera uma vez só.
Paleta: Automação > Ação (“Executa uma ou mais ações”). É o bloco que faz coisas no sistema: transfere a conversa, etiqueta, cria tarefa, move negócio, chama outro fluxo e mais. Um bloco pode ter várias ações, executadas na ordem da lista.
Como o painel funciona
Seção intitulada “Como o painel funciona”- Cada ação é um cartão “Ação 1”, “Ação 2” etc. Com mais de uma ação, cada cartão tem uma lixeira (Remover ação).
- O campo Tipo é uma lista com busca. Cada opção traz uma frase de apoio.
- Adicionar ação cria outra ação, já no primeiro tipo da lista (Transferir para fila). Não há limite de ações por bloco.
- Um bloco novo já nasce com uma ação Transferir para fila ainda sem fila escolhida.
- No cartão do canvas, o bloco mostra o nome da primeira ação e, se houver mais, “N ações”.
- O bloco tem uma saída só e não tem saída de falha. Se uma ação não puder ser feita, o fluxo para com erro (veja “Quando a ação falha”, mais abaixo).
- Pendência: sem nenhuma ação, o erro é “Adicione uma ação”. O erro de cada ação aparece sob o cartão dela; com várias ações, o selo do bloco traz o prefixo “Ação N: “.
- Responder comentário só funciona nos canais Instagram e Messenger. Se o canal do gatilho for outro, o cartão mostra “Esta ação não é compatível com” o canal e, no canvas, “Não compatível com o canal”. As outras 23 ações valem para todos os canais.
Todas as ações
Seção intitulada “Todas as ações”| Nº | Ação | O que faz |
|---|---|---|
| 1 | Transferir para fila | Manda o atendimento para outra fila |
| 2 | Atribuir responsável | Define quem vai atender |
| 3 | Adicionar nota no atendimento | Escreve uma nota interna, que o cliente não vê |
| 4 | Encerrar atendimento | Fecha o atendimento com um motivo |
| 5 | Avisar alguém da equipe | Manda um aviso no sino para o responsável ou uma pessoa |
| 6 | Adicionar etiqueta | Marca o contato com uma etiqueta |
| 7 | Remover etiqueta | Tira uma etiqueta do contato |
| 8 | Definir campo do contato | Grava um valor num campo da ficha |
| 9 | Definir variável do fluxo | Guarda um valor só durante este fluxo, sem gravar na ficha |
| 10 | Registrar observação no contato | Escreve uma observação na ficha do contato |
| 11 | Criar tarefa | Abre uma tarefa com prazo para a equipe |
| 12 | Criar negócio | Abre um negócio no pipeline |
| 13 | Mover negócio de etapa | Passa o negócio para outra etapa do pipeline |
| 14 | Ganhar ou perder negócio | Marca o negócio aberto como ganho ou perdido |
| 15 | Inscrever na sequência | Coloca o contato numa sequência de mensagens |
| 16 | Remover da sequência | Tira o contato da sequência |
| 17 | Colocar na lista de espera | Põe o contato na fila de um serviço da agenda para quando vagar um horário |
| 18 | Marcar a vaga oferecida | Marca para o contato o horário da lista de espera que foi oferecido a ele |
| 19 | Confirmar o próximo compromisso | Registra que o contato confirmou presença no próximo compromisso dele na agenda |
| 20 | Registrar a nota da avaliação | Grava a nota que o contato deu na pesquisa de satisfação do atendimento |
| 21 | Tirar das mensagens de marketing | Marca que o contato não quer mais receber marketing e o tira das sequências |
| 22 | Encerrar execução | Termina o fluxo neste bloco: o que vier ligado depois não roda e a conversa continua aberta |
| 23 | Iniciar outro fluxo | Encerra este fluxo e coloca o contato em outro, mesmo que ele tenha outro gatilho |
| 24 | Responder comentário | Uma resposta na publicação e outra no Direct |
Campos de cada ação
Seção intitulada “Campos de cada ação”Os campos de texto aceitam variáveis, como {{contato.primeiro_nome}}. Veja Referência: variáveis.
Transferir para fila
Seção intitulada “Transferir para fila”| Campo | O que é |
|---|---|
| Fila | A fila (departamento) que recebe a conversa. Obrigatório. Erro: “Falta escolher (Fila)”. |
| Mensagem de espera (opcional) | Texto enviado ao cliente quando a fila tem distribuição automática e ninguém pode assumir agora. Sugestão: Ex.: Nossos atendentes estão ocupados. Já falamos com você. |
| Resumir a conversa para quem receber | Interruptor, desligado por padrão. Ligado, a IA escreve uma nota interna com o que o cliente já contou e gasta saldo de IA. Desligado, quem recebe precisa ler o histórico. |
Na execução: o sistema procura a fila pelo nome exato, registra na conversa a mensagem de sistema “encaminhou a conversa para” a fila, desliga o robô naquela conversa e, se a fila tem distribuição automática, escolhe um atendente. Se ninguém pode assumir e há Mensagem de espera, ela é enviada. Exige conversa.
Atribuir responsável
Seção intitulada “Atribuir responsável”| Campo | O que é |
|---|---|
| Responsável | Um usuário da equipe (aparece o nome ou o e-mail). Obrigatório. Erro: “Falta escolher (Responsável)”. |
| Resumir a conversa para quem receber | O mesmo interruptor da transferência. |
Na execução: também desliga o robô na conversa.
Adicionar nota no atendimento e Registrar observação no contato
Seção intitulada “Adicionar nota no atendimento e Registrar observação no contato”| Campo | O que é |
|---|---|
| Texto da nota (nota no atendimento) ou Texto da observação (observação no contato) | O texto. Sugestão: Só a equipe vê este texto…. Erro: “Escreva o texto”. |
A nota no atendimento é interna (o cliente não vê) e exige conversa. A observação grava na ficha do contato e funciona mesmo sem conversa.
Encerrar atendimento
Seção intitulada “Encerrar atendimento”| Campo | O que é |
|---|---|
| Motivo de encerramento | Lista dos motivos ativos. Sem nenhum cadastrado: “Nenhum motivo de encerramento cadastrado”. Erro: “Selecione o motivo de encerramento”. |
Exige conversa. Registra “encerrou o atendimento” com o motivo. Se o atendimento já estava resolvido, não faz nada.
Avisar alguém da equipe
Seção intitulada “Avisar alguém da equipe”| Campo | O que é |
|---|---|
| Quem recebe | Responsável pela conversa ou um usuário. Erro: “Escolha quem recebe o aviso”. |
| Texto do aviso | O texto do aviso. Sugestão: Ex.: {{contato.primeiro_nome}} pediu um orçamento. Erro: “Escreva o texto do aviso”. |
Com Responsável pela conversa, o painel avisa: “Sem responsável na conversa nem no negócio aberto, ninguém recebe o aviso.” Na execução, o aviso chega no sino com o título “Aviso da automação”. Se não houver responsável na conversa nem no negócio aberto, ninguém é avisado e o fluxo segue normalmente.
Adicionar etiqueta e Remover etiqueta
Seção intitulada “Adicionar etiqueta e Remover etiqueta”| Campo | O que é |
|---|---|
| Etiqueta | Uma etiqueta cadastrada. Erro: “Falta escolher (Etiqueta)”. |
Na execução, a etiqueta é buscada pelo nome. Se ela foi apagada ou renomeada, nada acontece e o fluxo segue sem erro. Se o contato já tem a etiqueta, nada muda.
Definir campo do contato
Seção intitulada “Definir campo do contato”| Campo | O que é |
|---|---|
| Campo do contato | Um campo personalizado. Sem nenhum: “Nenhum campo criado ainda”. Erro: “Selecione o campo”. |
| Criar campo | Cria um campo na hora. Pede Nome do campo (sugestão Ex.: E-mail) e o tipo, com Criar e usar e Cancelar. Avisos: “Use ao menos uma letra no nome do campo.” e “Já existe um campo com esse nome. Ele será selecionado.” Se existia um campo apagado com esse nome, ele volta com os valores que já tinha. |
| Valor | O valor a gravar. Sugestão: Ex.: gold. Pode usar variáveis e pode ficar vazio. |
Na execução, o valor é gravado na ficha com origem “fluxo”. Se o campo foi removido depois, o fluxo para com erro. O valor também precisa caber no formato do campo (número, data, lista).
Definir variável do fluxo
Seção intitulada “Definir variável do fluxo”| Campo | O que é |
|---|---|
| Nome da variável | Só letras minúsculas, números e underline. Sugestão: Ex.: pedido. Erros: “Escreva o nome da variável” e A variável "X" só pode ter letras minúsculas, números e underline. |
| Valor | O valor. Sugestão: Ex.: {{payload.pedido}}. |
A variável vira {{variavel.nome}}, vale só enquanto este fluxo roda e não grava nada na ficha. Depois, ela aparece na Condição como “Variável: nome”.
Criar tarefa
Seção intitulada “Criar tarefa”| Campo | O que é |
|---|---|
| Título | Obrigatório. Sugestão: Ex.: Ligar para {{contato.primeiro_nome}}. Erro: “Escreva o título da tarefa”. |
| Descrição | Opcional. |
| Tipo de tarefa | Ligação, Retorno, Compromisso ou Interna (padrão). Erro: “Selecione o tipo da tarefa”. |
| Prazo e Unidade | Número a partir de 1 (padrão 1) e a unidade: minutos, horas ou dias (padrão dia). Contado a partir do momento em que a ação roda. Erro: “Defina o prazo da tarefa”. |
| Prioridade | Baixa, Média (padrão), Alta ou Urgente. |
| Responsável | Sem responsável ou um usuário. |
| Setor da tarefa | O setor do responsável (padrão) ou um departamento. |
Sem responsável, o painel avisa: “Sem responsável, ninguém recebe aviso no sino quando a tarefa vencer. Ela só aparece para quem abrir a tela de Tarefas.” A tarefa é ligada à conversa, ao negócio aberto e ao contato. Se o responsável escolhido foi removido depois, a tarefa não é criada e o fluxo segue sem aviso.
Criar negócio e Mover negócio de etapa
Seção intitulada “Criar negócio e Mover negócio de etapa”As duas ações usam o mesmo painel. Sem nenhum pipeline cadastrado, aparece “Crie um pipeline antes de usar esta ação.”
| Campo | O que é |
|---|---|
| Pipeline | O funil. Padrão: o primeiro. Erro: “Selecione o pipeline”. |
| Etapa inicial (criar) ou Etapa do pipeline (mover) | A etapa. Só aparecem etapas abertas (sem as de ganho e perdido). Ao trocar de pipeline, a etapa de entrada é escolhida sozinha. Sem etapas: “Este pipeline não tem etapas ainda.” Erro: “Selecione a etapa”. |
| Título do negócio | Opcional. |
| Valor (R$) | O valor do negócio. Vira somente leitura, com “Soma dos produtos”, se houver produtos. |
| Responsável pelo negócio | Sem responsável ou um usuário. |
| Produtos | Os produtos do negócio. |
| Observação | Opcional. |
Na execução:
- Criar negócio: se o contato já tem um negócio aberto que impede outro cartão naquele pipeline, não cria outro e o fluxo segue sem erro. A etapa de entrada do funil não pode ser a etapa escolhida.
- Mover negócio de etapa: se o contato não tem negócio aberto naquele pipeline, o fluxo para com erro. Se a etapa tem uma regra de entrada que bloqueia, o fluxo também para, com o motivo da regra.
Ganhar ou perder negócio
Seção intitulada “Ganhar ou perder negócio”| Campo | O que é |
|---|---|
| O negócio vira | Ganho (padrão) ou Perdido. Erro: “Escolha entre ganhar ou perder o negócio”. |
| Motivo de perda | Só com Perdido. Só motivos ativos. Sem nenhum: “Cadastre os motivos de perda nas configurações do pipeline.” Erro: “Selecione o motivo de perda”. |
| Observação | Aparece com Perdido. Vira “Observação (obrigatória para este motivo)” quando o motivo exige. Erro: “Este motivo de perda exige uma observação.” |
| Pipeline | Qualquer pipeline ou um específico. |
O painel avisa: “Vale para o negócio aberto do contato. Sem negócio aberto, nada muda.” Na execução, sem negócio aberto o fluxo segue sem erro.
Inscrever na sequência e Remover da sequência
Seção intitulada “Inscrever na sequência e Remover da sequência”| Campo | O que é |
|---|---|
| Sequência | Só sequências ativas ou em rascunho. Placeholder “Selecione uma sequência”; vazio: “Nenhuma sequência disponível”. Erro: “Selecione a sequência”. |
Na execução: contato já inscrito, sequência indisponível ou contato que não estava na sequência (na remoção) não geram erro: nada acontece e o fluxo segue.
Colocar na lista de espera
Seção intitulada “Colocar na lista de espera”| Campo | O que é |
|---|---|
| Serviço | Serviço da agenda. Sem nenhum: “Nenhum serviço cadastrado em Configurações, Agenda”. Erro: “Selecione o serviço”. |
| Quem atende | Qualquer um que faça o serviço ou um profissional. |
Na execução, se a conta não tem a agenda contratada ou o serviço ou profissional não está mais disponível, o fluxo para com erro.
Marcar a vaga oferecida
Seção intitulada “Marcar a vaga oferecida”Sem campos. O painel explica: “Quando o contato disser que quer, marca o horário da lista de espera oferecido a ele que ainda está no prazo. Se a vaga já foi ocupada ou o prazo venceu, a ação não acontece.” Na prática, o fluxo para com erro quando o contato não tem vaga oferecida em aberto, ou quando a vaga já foi ocupada ou o prazo venceu. O motivo aparece em Execuções.
Confirmar o próximo compromisso
Seção intitulada “Confirmar o próximo compromisso”Sem campos. O painel diz: “Marca como confirmado o próximo compromisso do contato na agenda. Sem compromisso marcado para confirmar, a ação não é feita.” Na prática, sem compromisso futuro, ou sem agenda contratada, o fluxo para com erro (“o contato não tem compromisso marcado para confirmar”). Se o compromisso já estava confirmado, nada muda.
Registrar a nota da avaliação
Seção intitulada “Registrar a nota da avaliação”| Campo | O que é |
|---|---|
| Nota de 1 a 5 | De onde vem a nota, normalmente uma variável. Sugestão: Ex.: {{variavel.nota}}. O primeiro número do texto vira a nota, e ela precisa estar entre as opções da pesquisa. Erro: “Escolha de onde vem a nota (1 a 5)”. |
| Comentário (opcional) | Sugestão: Ex.: {{variavel.motivo}}. |
| Pesquisa de satisfação | A pesquisa ativa que tem essa nota (padrão) ou uma pesquisa ativa específica. |
A nota entra no atendimento mais recente da conversa, uma vez só. Na prática, o fluxo para com erro quando o cliente ainda não deu uma nota (nenhum número no texto), quando a nota não está entre as opções da pesquisa ativa, quando não há pedido, negócio ou atendimento a que ligar a nota, ou quando aquela avaliação já foi registrada.
Tirar das mensagens de marketing
Seção intitulada “Tirar das mensagens de marketing”Sem campos. O contato deixa de receber campanhas e mensagens de marketing e sai de todas as sequências em que estava. As mensagens do atendimento continuam chegando.
Encerrar execução
Seção intitulada “Encerrar execução”Sem campos. É o “fim” do fluxo: a execução termina neste bloco, depois das outras ações do mesmo bloco. O que estiver ligado depois não roda, a conversa continua aberta e o contato fica livre para começar outro fluxo. Use no fim de um caminho que não precisa de mais nada, como o Senão de uma Condição.
Iniciar outro fluxo
Seção intitulada “Iniciar outro fluxo”É assim que um fluxo chama outro: não existe um bloco separado.
| Campo | O que é |
|---|---|
| Fluxo de destino | Só aparecem fluxos ativos, e nunca o fluxo atual. Placeholder “Selecione um fluxo”; vazio: “Nenhum outro fluxo ativo”. Erro: “Selecione o fluxo”. |
Na execução, o bloco roda antes as outras ações do mesmo bloco, depois encerra este fluxo e começa o fluxo de destino na hora, pelo gatilho dele, mesmo que o contato já tivesse outro gatilho. O fluxo para com erro se o destino não existe, foi apagado ou não está ativo (“o fluxo de destino não existe ou está inativo”). Há duas travas contra repetição: um fluxo não é chamado duas vezes para o mesmo contato na mesma cadeia (“o fluxo de destino já passou por este contato nesta cadeia”), e uma cadeia tem no máximo 10 fluxos.
Responder comentário
Seção intitulada “Responder comentário”Só em fluxo de comentário no Instagram ou no Messenger.
| Campo | O que é |
|---|---|
| Resposta pública, no comentário da publicação (opcional) | Sugestão: Ex.: Enviei no seu direct! |
| Mensagem privada, no Direct (opcional) | Sugestão: Escreva a mensagem que vai no direct… |
O painel diz que dá para deixar um dos dois em branco, para responder só na publicação ou só no Direct, e acusa o erro “Preencha ao menos um: a resposta ao comentário ou a mensagem do direct” quando os dois estão vazios. Preencha os dois: ao ativar ou salvar um fluxo ativo, o sistema pode recusar o bloco com “Preencha a resposta e o direct”. No cartão do canvas aparecem “Na publicação: …” e “No Direct: …” (ou “Sem resposta na publicação” e “Sem mensagem no Direct”).
Quando a ação falha
Seção intitulada “Quando a ação falha”O bloco Ação não tem saída de falha. Quando uma ação não consegue ser feita (campo apagado, negócio que não existe, agenda não contratada, nota inválida, fluxo de destino inativo e casos parecidos), a execução do fluxo termina com status de falha, e o motivo aparece no passo do histórico em Execuções. As ações seguintes do bloco e os blocos ligados depois não rodam. Já nos casos em que o texto do painel diz “nada acontece” (etiqueta que não existe, sequência em que o contato já está, ganhar ou perder sem negócio aberto, aviso sem responsável), o fluxo segue normalmente.
Para evitar a falha, ponha uma Condição antes da ação (por exemplo, “Etapa do negócio” ou “Etiqueta”) e mande para o caminho certo.
Chamar API
Seção intitulada “Chamar API”Paleta: Automação > Chamar API (“Consulta um sistema de fora”). Faz uma chamada a um sistema externo (ERP, loja, planilha com API) e guarda partes da resposta em variáveis, que você usa nos blocos seguintes como {{variavel.nome}}. O endereço, o método e a credencial ficam numa conexão, cadastrada à parte e reaproveitável em vários fluxos.
Campos do painel
Seção intitulada “Campos do painel”| Campo | O que é |
|---|---|
| Conexão | A chamada pronta que o bloco vai disparar. Obrigatório. Cada opção mostra o nome e, ao lado, o método e o endereço. Erro: “Escolha a conexão que o bloco vai chamar”. |
| Nova conexão | Abre a janela para cadastrar uma conexão sem sair do fluxo. |
| Verificar | Aparece com uma conexão escolhida: faz a chamada de teste e mostra o resultado (veja mais abaixo). |
| Campos da resposta | Linhas do tipo “chave da resposta vira variável”. Cada linha tem dois campos (chave da resposta e numero, o nome da variável), uma lixeira e o botão Adicionar campo. |
| No teste | Só para quem tem a permissão Gerenciar em Fluxos. Veja abaixo. |
| Últimas chamadas | O histórico do que o bloco enviou e recebeu. |
Avisos do campo Conexão:
- “A conexão que este bloco usava não existe mais. Escolha outra.”
- Conexão desligada: “Esta conexão está desligada por falhas seguidas. O bloco sai direto pela saída de falha. Religue depois de arrumar o sistema de destino.” (com o link Abrir a conexão)
- “Não foi possível carregar as conexões. A lista acima pode estar incompleta.”
- Nenhuma conexão: “Nenhuma conexão cadastrada ainda. Cadastre uma para este bloco poder chamar uma API.”
Campos da resposta
Seção intitulada “Campos da resposta”Cada linha pega um pedaço da resposta e guarda numa variável. O painel explica: “Cada campo vira uma variável variavel.nome, que vale só enquanto este fluxo roda.”
- A chave da resposta é o caminho dentro do JSON, separado por ponto:
pedido.id,itens.0.nome(o número escolhe o item da lista). Colchetes (itens[0]) não funcionam. - Para descobrir o caminho certo, use Últimas chamadas: o detalhe de cada chamada mostra os Caminhos da resposta como botões copiáveis.
- O nome da variável só aceita letras minúsculas, números e underline.
Validação por linha:
| Mensagem | Quando |
|---|---|
| Escreva a chave do JSON | A chave da resposta está vazia |
| Escolha a variável de destino | A linha não tem variável |
| Escreva o nome da variável | O nome da variável está vazio |
| A variável “nome” só pode ter letras minúsculas, números e underline | O nome tem caracteres inválidos |
| Há duas chaves apontando para a variável “nome” | Duas linhas gravam na mesma variável |
Com mais de uma linha, o selo do bloco traz o prefixo “Mapeamento N: “.
No teste
Seção intitulada “No teste”Esta seção define o que o botão Testar do construtor faz com este bloco (veja Como testar um fluxo).
| Campo | O que é |
|---|---|
| Chamar de verdade no teste | Interruptor. Ligado, aparece o aviso “A chamada vai de verdade para o seu sistema.” |
| Código | Só com o interruptor desligado: o código HTTP da resposta de exemplo, de 100 a 599. Padrão 200. |
| Editor JSON | Só com o interruptor desligado: o corpo da resposta de exemplo. Padrão {}. Sugestão: { "pedido": "123" }. |
Desligado, o teste usa a resposta de exemplo: as variáveis saem dela, e o fluxo segue por deu certo com código 2xx e por falhou com qualquer outro.
Últimas chamadas
Seção intitulada “Últimas chamadas”Lista as chamadas reais feitas por este bloco. Sem nenhuma: “Nenhuma chamada ainda. Rode o fluxo uma vez para ver aqui o que foi enviado, o que voltou e os caminhos da resposta.” Cada item mostra o código HTTP (ou “não saiu”, se a chamada nem chegou a sair) e o motivo. Ao abrir, você vê o método e o endereço, o que foi Enviado, a Resposta (com o aviso “cortada em 32 KB” quando é grande demais), os Caminhos da resposta e “Virou: variavel.nome = valor”. O link Ver tudo no Registro abre a lista completa. Os cabeçalhos e as credenciais nunca aparecem.
A janela Nova conexão
Seção intitulada “A janela Nova conexão”O título muda para “Editar conexão” ao editar. O subtítulo é “Monte a chamada que o bloco API do fluxo vai disparar”. Se a conexão estiver desligada, uma faixa vermelha avisa “Desligada por falhas seguidas. Enquanto estiver assim, o bloco API sai direto pela saída de falha.” e o botão Religar a reativa.
| Campo | O que é |
|---|---|
| Nome | Obrigatório. Sugestão: Ex.: ERP pedidos. |
| Método | GET (padrão), POST, PUT, PATCH ou DELETE. GET não envia corpo. |
| Endereço | Obrigatório, começando com http:// ou https://. Sugestão: https://erp.exemplo.com/pedidos. Aceita variáveis. |
A janela tem quatro abas:
| Aba | O que tem |
|---|---|
| Parâmetros | Tabela de Chave e Valor (valor aceita variáveis, como {{contato.primeiro_nome}}). Vão para o fim do endereço, já codificados: não escreva o ?. |
| Autenticação | Credencial: Nenhuma, Bearer (token) (campo Token), Basic (usuário e senha) (campos Usuário e Senha) ou API Key (cabeçalho) (campos Nome do cabeçalho, padrão X-Api-Key, e Valor da chave). |
| Cabeçalhos | Tabela de cabeçalhos enviados em toda chamada (por exemplo Authorization e Bearer ...). |
| Corpo | Texto livre, que sai exatamente como escrito. Aceita variáveis, como {{variavel.pedido}}. |
Sobre segredos: a credencial e os cabeçalhos são cifrados e nunca voltam para a tela nem entram no desenho do fluxo. Ao editar uma conexão que já tem credencial, aparece “Credencial guardada e cifrada” e o botão Trocar credencial; para os cabeçalhos, Trocar cabeçalhos (que substitui todos de uma vez). Escolher Nenhuma e salvar apaga a credencial guardada. No computador, a Prévia da requisição mostra a chamada montada.
Validação ao salvar:
| Mensagem | Quando |
|---|---|
| Escreva o nome da conexão | O Nome está vazio |
| Escreva o endereço da conexão | O Endereço está vazio |
| O endereço precisa começar com http:// ou https:// | O endereço está num formato inválido |
| Escreva o token | Bearer sem token |
| Escreva o usuário e a senha | Basic incompleto |
| Escreva o cabeçalho e o valor da chave | API Key incompleta |
Se faltar permissão, a janela diz “Sem permissão para gerenciar conexões HTTP.”. Se a conexão não existe mais: “Essa conexão não existe mais.” Se ela passou a ser usada em algum fluxo: “Esta conexão passou a ser usada em um fluxo. Abra o aviso de novo para ver onde.”
Verificar a conexão
Seção intitulada “Verificar a conexão”O botão Verificar faz uma chamada de teste. O resultado aparece embaixo: “Respondeu 200 em 340 ms” (em verde), ou uma explicação do problema com “o que fazer” e uma lista de “Causas possíveis”. Quando o sistema não consegue nem explicar, aparece “Não foi possível falar com o sistema”. O link Ver no Registro abre o detalhe.
| Saída | Quando |
|---|---|
| deu certo | O sistema respondeu com código 2xx |
| falhou | Qualquer outro código, tempo esgotado, erro de rede, endereço bloqueado ou conexão desligada |
As duas saídas não são obrigatórias para ativar. Se falhou estiver solta, o fluxo termina ali.
O que acontece na execução
Seção intitulada “O que acontece na execução”- Uma tentativa só. Não há nova tentativa automática.
- Tempo limite de 8 segundos. Se o sistema não responder a tempo, o bloco sai por falhou.
- Redirecionamentos não são seguidos. Uma resposta de redirecionamento conta como falha.
- Resposta lida até 100 mil bytes. O que passar disso é ignorado.
- Só endereços públicos. Endereços internos, locais ou de rede privada são bloqueados e contam como falha.
- Em caso de falha, nenhuma variável é gravada. As variáveis mapeadas ficam como estavam. Se o JSON da resposta é inválido, as variáveis ficam vazias e o bloco segue por deu certo, desde que o código fosse 2xx.
- O que vira variável. Números e verdadeiro ou falso viram texto. Um valor que não existe, é nulo, uma lista ou um objeto vira texto vazio.
- Limite de chamadas. Cada conta pode fazer cerca de 10 chamadas por segundo, com rajada de até 20. Acima disso a chamada falha na hora, por falhou.
- Desligamento automático. Depois de 10 falhas seguidas na mesma conexão, ela é desligada: dali em diante o bloco sai direto por falhou, sem tentar. A conta recebe um alerta, e outro quando a conexão volta a funcionar. Qualquer sucesso zera a contagem. Use Religar na conexão depois de arrumar o problema.
- Motivo da falha. Fica no histórico do passo em Execuções. Alguns motivos vêm em português (“a conexão escolhida não existe mais”, “a conexão está desligada por falhas seguidas”) e outros vêm em inglês ou em texto técnico, como “invalid url” ou “blocked host”.
Agente de IA
Seção intitulada “Agente de IA”Paleta: Automação > Agente de IA (“Passa a conversa para um Agente de IA”). Entrega a conversa para um Agente de IA da conta e segue pela saída que corresponde ao resultado (Resolvido, uma por transferência, Humano e Sem resposta em). Campos, saídas, regras de espera e o que impede ativar estão em Referência: blocos de conversa.
Agendamento
Seção intitulada “Agendamento”Paleta: Conversa > Agendamento (“Oferece horários e marca”). Mostra ao cliente alguns horários livres da agenda, deixa ele escolher e marca o compromisso. Só aparece em contas com o módulo Agenda. Os horários oferecidos são os que a agenda devolveu naquele instante; o bloco nunca inventa um.
Campos do painel
Seção intitulada “Campos do painel”| Campo | O que é |
|---|---|
| Serviço | O serviço que o bloco vai marcar. Obrigatório. Cada opção mostra os minutos de duração. A duração e as folgas do serviço decidem os horários oferecidos. Sem serviços: “Nenhum serviço cadastrado em Configurações, Agenda”. Erro: “Escolha o serviço que o bloco vai marcar”. |
| Quem atende | Qualquer um que faça o serviço (padrão) ou um profissional. Em “qualquer um”, o bloco oferece o primeiro horário livre da equipe inteira. |
| Quantos horários oferecer | 2, 3 (padrão), 4, 5, 6, 8 ou 10 horários. |
| Até quantos dias à frente | 7, 14, 30 (padrão) ou 60 dias. As opções acima do limite da conta não aparecem. A agenda procura no máximo esse tempo à frente. |
| Como apresentar | O texto que vem antes dos horários, com variáveis. Sugestão: “Tenho estes horários. Responda com o número do que servir para você:”. |
| Palavra para desistir | Sugestão: nenhum. Quem responder essa palavra, ou tocar em Nenhum serve no WhatsApp oficial, sai pela saída Desistiu. Preenchida, ela também vira o texto dessa opção. |
No WhatsApp oficial, os horários saem como botões (até 2) ou lista, com Nenhum serve como última opção. Nos outros canais, entram numerados logo abaixo do texto de apresentação.
O bloco sempre tem três saídas, sem configuração:
| Saída | Quando |
|---|---|
| Marcado | O cliente escolheu um horário e ele foi reservado |
| Sem horário | Não havia nenhum horário livre no período |
| Desistiu | O cliente respondeu a palavra de desistência |
As três saídas precisam estar ligadas para ativar o fluxo. O construtor não avisa isso antes: a recusa vem ao ativar, com A saída "Marcado" do bloco Agendamento não está conectada. (ou o nome da saída solta).
O cartão do canvas mostra o nome do serviço e “com” o profissional ou “com quem estiver livre”. O Agendamento conta como bloco que espera o cliente para a regra de ciclos.
Cobrança
Seção intitulada “Cobrança”Paleta: Conversa > Cobrança (“Cobra por Pix, boleto ou link”). Cria uma cobrança no Asaas e manda ao contato por um modelo de pagamento aprovado, mesmo com a janela de 24 horas fechada. Só aparece em contas com o módulo Integrações e só funciona em conversas do WhatsApp Business.
Se o Asaas não está pronto, um aviso amarelo no topo explica: “Fluxos cobram só pelo Asaas.” seguido de “A geração de cobranças está desligada na conta.” ou “O Asaas ainda não está conectado.”, com o link Abrir a Central de apps. Sem isso, o bloco não cria a cobrança e o fluxo segue pela saída de falha.
Campos do painel
Seção intitulada “Campos do painel”Na ordem em que aparecem:
| Campo | O que é |
|---|---|
| Modelo de pagamento | Só modelos de pagamento aprovados. Placeholder “Escolha um modelo de pagamento”. Sem nenhum: “Nenhum modelo de pagamento aprovado”, com a orientação de criar um em Modelos, escolhendo o botão de pagamento, e esperar a aprovação da Meta. Mostra a prévia do texto do modelo. Erro: “Escolha o modelo de pagamento que o bloco envia”. |
| Métodos | Modelo de pedido: caixas Pix copia e cola, Boleto e Link de pagamento (padrão só o link; ao menos um fica sempre marcado, com o aviso “Marque ao menos um método.”). Modelo de solicitação de pagamento: mostra só os métodos do modelo, porque cada botão dele vira um jeito de pagar. |
| Variável N | Uma caixa para cada variável do modelo, com variáveis do fluxo. Erro: “Preencha a variável N do modelo”. |
| Valor da cobrança | De onde vem o valor. Valor do negócio (usa o negócio aberto mais recente do contato), Valor fixo (campo Quantia em reais, sugestão Ex.: 149,90; de maior que zero até R$ 1.000.000,00) ou Campo do contato (lê o valor, em reais, de um campo da ficha). Erros: “Informe um valor maior que zero e de até R$ 1.000.000,00”, “Escolha o campo do contato que traz o valor”, “Defina de onde vem o valor da cobrança”. |
| Itens do pedido | Sem itens (padrão) ou Produtos do negócio. Com produtos, o total dos itens passa a ser o valor da cobrança. |
| Descrição | Aparece na cobrança do Asaas. Aceita variáveis. Até 500 caracteres. Erro: “A descrição pode ter até 500 caracteres”. |
| Vencimento em dias | Contado a partir do envio; 0 vence hoje. De 0 a 60. Padrão 3. Erro: “O vencimento é de 0 a 60 dias”. |
| Expiração | Não expira (padrão), No fim do dia do vencimento ou 1, 2, 3, 5, 7, 15, 30 ou 60 dias após o vencimento. Depois do prazo, a cobrança em aberto é cancelada. Erro: “A expiração é de 0 a 60 dias depois do vencimento”. |
| Esperar o pagamento por | O tempo que o fluxo espera o pagamento. De 1 minuto a 30 dias, com atalhos. Padrão 1 dia. Passado o prazo, sai por não pagou. Nota: “Se o pagamento chegar depois, o fluxo não volta.” |
O texto do fim do painel resume as regras: o bloco só funciona em conversas do WhatsApp Business e manda o modelo mesmo com a janela de 24 horas fechada.
| Saída | Quando |
|---|---|
| pagou | O pagamento foi confirmado dentro do prazo de espera |
| não pagou em (tempo) | O prazo de espera acabou sem pagamento |
| falhou | A cobrança não pôde ser criada |
Ligue as saídas que você quer tratar. Sem nenhuma saída ligada, o fluxo não espera o pagamento. Nenhuma delas é obrigatória para ativar.
Se a cobrança não puder ser criada (sem valor, sem CPF ou CNPJ do contato, Asaas recusou, modelo rejeitado) e a saída falhou estiver ligada, o motivo vai para a variável {{variavel.cobranca.erro}} e a conversa recebe uma nota interna.
Pendências que impedem ativar
Seção intitulada “Pendências que impedem ativar”Resumo do que o construtor cobra antes de deixar o fluxo ativo:
| Bloco | Pendência |
|---|---|
| Condição | Campo, valor ou fim do intervalo vazio; todas as saídas (inclusive Senão) ligadas |
| Horário e feriados | Escolher o horário; ligar Aberto, Fechado e Feriado |
| Atraso | Duração de 1 a 30 dias, ou data de referência, hora e distância válidas; ligar Data já passou quando o pulo estiver marcado |
| Aguardar mensagem | Nenhuma |
| Ação | Ao menos uma ação, com todos os campos obrigatórios preenchidos |
| Chamar API | Escolher a conexão; mapeamentos sem erro |
| Agente de IA | Escolher o agente; ligar as saídas dele |
| Agendamento | Escolher o serviço; ligar Marcado, Sem horário e Desistiu |
| Cobrança | Modelo, valor e demais campos válidos |
| Todos | Ter exatamente um gatilho, todo bloco ligado ao caminho do gatilho e nenhum ciclo sem espera do cliente |
Esta página está: