Catálogo de blocos¶
Referência de todos os blocos disponíveis no construtor e suas configurações.
🟢 Gatilhos — quando o fluxo começa¶
| Gatilho | Dispara quando… | Configurações |
|---|---|---|
| Lead entrou na etapa | o lead é movido para uma etapa do funil | Etapa; Atraso (horas) |
| Antes do agendamento | faltam X horas para a consulta | Etapa (opcional); Horas antes (padrão, ex: 40); Horas antes p/ consulta na segunda (ex: 93 — cobre o fim de semana) |
| Lead inativo | o lead fica X horas sem atualização | Etapa (opcional); Horas de inatividade |
| Status do agendamento mudou | o agendamento muda de status (ex: confirmado, não compareceu) | Novo status; Atraso (horas) |
| Mensagem recebida | o paciente envia uma mensagem no WhatsApp | Etapa (opcional); Contém a palavra (opcional) |
| Em dia e hora | chegam os dias da semana e o horário escolhidos (fuso de Brasília) | Dias da semana; Horário; Etapa (opcional: com etapa, age em cada lead aberto dela; sem etapa, dispara uma vez, só para tarefa/aviso) |
| Só quando chamada (sub-fluxo) | outra automação a inicia pela ação Disparar outra automação (nunca dispara sozinha) | — |
Onde a saudação automática dispara
A automação de boas-vindas costuma usar o gatilho Lead entrou na etapa apontando para a etapa de entrada do WhatsApp (veja Funis). Lead criado em outra etapa não passa por ela. Se a saudação "não chegou", confira em que etapa o lead nasceu.
🔵 Ações — o que o fluxo faz¶
| Ação | O que faz | Configurações |
|---|---|---|
| Enviar WhatsApp | envia mensagem (texto livre ou template aprovado pela Meta) | Usar template (sim/não); Template ou Mensagem |
| Enviar lista WhatsApp (legado) | envia uma mensagem com lista de opções selecionáveis (ex: escolher especialidade) | Mensagem; Texto do botão; Opções (título + descrição) |
| Enviar botões WhatsApp (legado) | envia uma mensagem com até 3 botões de resposta rápida | Mensagem; Botões (até 3, só título ≤20 caracteres) |
| Mover de etapa | move o lead para outra etapa do funil | Etapa destino |
| Fechar como perdido | encerra o lead como perdido com motivo e move para a coluna de perdidos | Motivo da perda (obrigatório); Observação |
| Criar tarefa | cria uma tarefa para a equipe | Título; Descrição; Tipo; Atribuir a (usuário); Prazo (horas) |
| Atribuir responsável | define o dono do lead (um usuário do workspace) | Responsável (usuário) |
| Adicionar tag | marca o lead com uma tag (cria a tag no workspace se ainda não existir) | Tag |
| Definir campo | grava um valor num campo do lead/contato | Campo (lista permitida); Valor — vira lista quando o campo é enumerado (prioridade/status), senão texto com variáveis |
| Notificar equipe | envia uma notificação interna | Mensagem |
| Transferir para atendimento humano | silencia o assistente e põe a conversa na fila Aguardando atendimento | — |
| Devolver para a Kora (remarcação) | reativa o assistente em modo remarcação e envia o convite. Use no ramo NÃO da confirmação | — |
| Disparar outra automação | inicia outra automação para o mesmo lead (encadeamento) | Automação a disparar |
| Coletar dados do paciente | pergunta nome completo, data de nascimento e CPF pelo WhatsApp, valida e grava no cadastro. Pula o que já é conhecido e reengaja se o paciente silenciar | Pular dados já conhecidos; É para outra pessoa; textos das perguntas (opcionais) |
| Agendar consulta (agenda real) | oferece a disponibilidade real do profissional numa lista tocável, agenda no motor da Agenda e preenche a data no lead. Reengaja no silêncio | Profissional; Tipo de atendimento; Quantos horários oferecer; mensagens (opcionais) |
| Encerrar conversa | encerra a conversa na caixa de entrada e desliga o assistente. Não fecha o lead nem muda de etapa | — |
Template com variável precisa do de-para preenchido
No Enviar WhatsApp com template, cada variável do modelo precisa estar mapeada para um campo do CRM em Configurações → Modelos. Variável sem campo mapeado (ou com o campo vazio no lead) bloqueia o envio: melhor não enviar do que mandar uma mensagem pela metade ao paciente. Se a automação "não enviou", confira o de-para do modelo e se o lead tem o dado preenchido.
Como sei se a mensagem saiu?
Quando o WhatsApp recusa um envio (o caso mais comum: conversa fora da janela de 24h e mensagem sem template), a mensagem aparece na conversa com um ícone vermelho e o motivo no tooltip. A falha nunca passa em silêncio. Veja Comunicações.
Perda sempre tem motivo
Use Fechar como perdido, não Mover de etapa para a coluna de perdidos. Mover só troca a coluna: o lead aparece entre os perdidos no quadro mas continua valendo como negócio em aberto e sem motivo — e a taxa de perda dos relatórios passa a mentir. A ação Fechar como perdido faz o mesmo que a pessoa fazendo à mão: grava o motivo, a observação e a data de fechamento.
Se a automação não conseguir fechar (o funil está sem coluna de perdidos, ou o motivo configurado foi apagado), a equipe é avisada — a falha não passa em silêncio. Se o lead já estava fechado, nada acontece e isso não é tratado como erro.
Atribuir tarefas/leads a um usuário específico
Em Criar tarefa, o campo Atribuir a define quem fica responsável (em branco = 1º admin/atendente). Para mudar o dono do lead, use a ação Atribuir responsável.
Criar tarefa também toca o sino
Toda tarefa criada por automação gera uma notificação (sino, no topo da tela) para todos os administradores e atendentes — não só para quem ficou responsável. Clicar nela abre o lead. É o que evita a tarefa passar despercebida: o badge do menu Tarefas só fica vermelho quando há tarefa vencida, e o prazo padrão é de 2 horas.
O aviso mostra de quem é a tarefa (nome ou telefone do paciente) e usa a
Descrição como texto — por isso vale escrever ali o que precisa ser feito.
Título e descrição aceitam variáveis ({{contact.name}} e afins), que chegam
já preenchidas na tarefa e na notificação.
Disparar outra automação (encadeamento)
Coloque a ação Disparar outra automação ao final (ou em qualquer ponto) de um fluxo para iniciar outro. Há uma proteção automática contra laços infinitos (limite de encadeamento).
⚠️ A automação alvo só dispara se estiver ativa e se o lead estiver aberto (não ganho/perdido). O seletor marca as automações (inativas) — se a sua não disparou, confira se ela está ativa na lista de automações.
Botões vs. lista
Use botões (até 3) para escolhas curtas (ex.: Sim/Não/Remarcar) e lista (até 10) para opções mais longas (ex.: especialidades). Em ambos, o paciente toca e o título escolhido vira texto — ramifique depois com Opção escolhida (mesmos títulos) ou Resposta do paciente.
🙋 Pergunta com botões / 🗂️ Pergunta com lista — envia, aguarda e ramifica num bloco só¶
Os blocos "Pergunta com botões" (até 3 botões) e "Pergunta com lista" (até 10 opções, cada uma com título + descrição) fazem tudo de uma vez (estilo Salesbot do Kommo): enviam a mensagem + as opções, aguardam a resposta do paciente e ramificam por opção — sem precisar encadear "enviar + aguardar + decidir". Ambos têm as mesmas saídas (uma por opção + Outra resposta + Sem resposta + Falha ao enviar) e sinônimos por opção. (Abaixo, "botões" vale para os dois.)
| Configuração | O que é |
|---|---|
| Mensagem | texto enviado (aceita variáveis {{...}}) |
| Botões (máx. 3) | cada botão tem um título (vira uma saída do bloco) + sinônimos (palavras que contam como aquele botão se o paciente digitar em vez de clicar) |
| Tempo limite | opcional; sem resposta nesse prazo, segue pela saída Sem resposta |
Saídas do bloco: uma por botão + Outra resposta (respondeu algo fora dos botões) + Sem resposta (estourou o tempo limite) + Falha ao enviar (o WhatsApp recusou o envio).
Quando a resposta não casa nenhum botão
Se o paciente responder algo que não casa título nem sinônimo: se você cabeou a saída Outra resposta, o fluxo segue por ela; se não cabeou, a automação não consome a mensagem e a Kora assume o atendimento (não fica muda).
🟡 Decisões — ramificam o fluxo¶
| Decisão | Como decide | Ramos |
|---|---|---|
| Resposta do paciente | interpreta a resposta no WhatsApp | SIM / NÃO / REMARCAR / OUTRO |
| Opção escolhida | ramifica conforme a opção da lista que o paciente selecionou | uma saída por opção + OUTRO |
| Mensagem do cliente | compara a última mensagem do paciente (contém / igual / diferente) | SIM / NÃO |
| Horário de atendimento | está dentro ou fora do expediente do workspace? | DENTRO / FORA |
| Condição (campo do CRM) | compara um campo do lead/contato | SIM / NÃO |
| Já foi atendido? | um atendente humano já respondeu a este paciente? | SIM / NÃO |
Lista de opções + ramificação
Use Enviar lista WhatsApp para oferecer opções (ex.: especialidades), depois Aguardar resposta e uma decisão Opção escolhida com os mesmos títulos — cada opção vira um caminho no fluxo.
Como a 'Resposta do paciente' interpreta a mensagem
A decisão entende variações naturais (e até pequenos erros de digitação):
- "sim", "confirmo", "ok", "1" → SIM
- "não", "cancela", "2" → NÃO
- "remarcar", "outro horário", "3" → REMARCAR
- qualquer outra coisa → OUTRO
🟣 Esperas — pausam o fluxo¶
| Espera | O que faz | Configurações |
|---|---|---|
| Aguardar resposta | pausa até o paciente responder. 2 saídas: Respondeu e Sem resposta (se houver tempo limite) | Tempo limite + unidade (opcional) |
| Esperar tempo | pausa por um período | Quantidade + unidade (segundos/min/horas/dias); opção só dias úteis |
| Pausar até o expediente | segura o fluxo até a próxima janela do Horário de atendimento | — (usa a config do workspace) |
Há ainda o bloco Fim do fluxo, que encerra a automação naquele ponto. Ele é opcional (um caminho sem próximo bloco também termina), mas deixa explícito no canvas que o caminho acabou ali.
Granularidade do tempo (~30s)
As automações rodam num ciclo de ~30 segundos. Esperas em minutos/horas/dias são precisas; segundos servem para pequenas pausas, mas arredondam para cima (uma espera de 5s pode levar até ~30s para continuar).
Seleção em área (mover/excluir vários blocos)
No canvas, arraste numa área vazia para selecionar vários blocos de uma vez — daí dá para movê-los juntos ou apagá-los com Del/Backspace. Para navegar pelo canvas use o scroll ou arraste com o botão direito do mouse.
Copiar, exportar e importar automações
Na lista de automações, cada item tem Duplicar (cria uma cópia inativa) e
Exportar (baixa um .json). O botão Importar no topo recria uma automação
a partir de um .json exportado (também inativa, para você revisar antes de ligar).
Saída \"Sem resposta\" (paciente não respondeu)
No Aguardar resposta, preencha um tempo limite. Se o paciente não responder nesse prazo, o fluxo segue pela saída Sem resposta (ex.: notificar a equipe, reenviar, mover de etapa). Sem tempo limite, o bloco só tem a saída Respondeu.
🕗 Horário de atendimento (expediente)¶
Defina uma vez em Automações → Expediente (dias + faixas + fuso). Tudo que depende de horário usa essa fonte única — sem reconfigurar em cada fluxo:
- a decisão "Horário de atendimento" (ramos DENTRO / FORA);
- o bloco "Pausar até o expediente";
- a opção "só dias úteis" do Esperar tempo.