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) |
🔵 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 | 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 WhatsApp com botões | 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 |
| 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) |
| 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 |
| Disparar outra automação | inicia outra automação para o mesmo lead (encadeamento) | Automação a disparar |
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.
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 |
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) |
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.