Ações são o que a automação faz quando o gatilho dispara. O Syncro tem dezenas de ações — desde enviar mensagem WhatsApp até criar tarefa, atribuir vendedor, mover lead de etapa, inscrever em sequência. Esse artigo cobre as principais ações organizadas por categoria.
Pra ações mais avançadas (extract_lead_data, send_webhook), veja artigos dedicados: Extrair dados com IA e Enviar webhook.
Adicionar uma ação na automação
- No formulário de automação, sidebar mostra categorias de ações.
- Clique na ação desejada.
- Ação aparece no canvas central.
- Configure os parâmetros específicos.
- Clique em Adicionar outra ação pra empilhar mais.
Múltiplas ações são executadas em ordem automaticamente.
Ações de tag
Adicionar tag ao lead (add_tag_lead)
Config:
- Tags: array de strings (ex:
["vip", "novo"]).
Comportamento: tags são adicionadas ao lead via trait HasTags (cria se não existir, sem duplicar).
Exemplo:
- Gatilho: lead criado.
- Ação: add_tag_lead
["novo-mes", "campanha-Y"].
Remover tag do lead (remove_tag_lead)
Config: tags: ["string"].
Comportamento: remove tags específicas. Se lead não tinha, ignora silenciosamente.
Adicionar tag à conversa (add_tag_conversation)
Config: tags: ["string"].
Comportamento: igual ao add_tag_lead, mas aplicado na conversa (WhatsappConversation/InstagramConversation/WebsiteConversation).
💡 Dica: tag em conversa é diferente de tag em lead. Tag de conversa qualifica a interação atual (ex: "reclamação", "proposta-enviada"), tag de lead qualifica a pessoa (ex: "vip", "b2b").
Ações de pipeline
Mover para etapa (move_to_stage)
Config:
- Etapa de destino (
stage_id): ID da etapa.
Comportamento:
- Atualiza
lead.stage_id. - Cria
LeadEvent('stage_changed')na timeline. - Cria tarefas obrigatórias da nova etapa (se houver).
- Pode disparar outras automações com gatilho
lead_stage_changed. - Idempotente: se lead já está nessa etapa, não faz nada.
Exemplo:
- Gatilho: lead_won.
- Ação: move_to_stage (etapa "Cliente ativo" do funil de pós-venda).
Definir origem do lead (set_lead_source)
Config:
- Origem: string (
manual,facebook,google,instagram,whatsapp,site,indicacao,outro).
Comportamento: atualiza lead.source.
Caso de uso: corrigir origem mal-classificada via automação (ex: lead chegou marcado como "manual" mas veio de campanha Facebook).
Ações de atribuição
Atribuir a usuário (assign_to_user)
Config:
- User ID: ID do usuário do tenant.
Comportamento:
- Atualiza
lead.assigned_to. - Atualiza
conversation.assigned_user_id(se há conversa). - Notifica o usuário atribuído via sino + email.
Atribuir agente IA (assign_ai_agent)
Config:
- AI Agent ID.
Comportamento: atribui agente IA pra atender automaticamente conversas vinculadas. Veja Agentes IA.
Atribuir fluxo de chatbot (assign_chatbot_flow)
Config: chatbot_flow_id.
Comportamento: atribui chatbot tradicional (não LLM) à conversa. Veja Criar fluxo de chatbot.
Transferir pra departamento (transfer_to_department)
Config: department_id.
Comportamento: muda conversation.department_id + dispara atribuição automática conforme estratégia do departamento (round-robin / least-busy).
Fechar conversa (close_conversation)
Config: nenhum.
Comportamento: marca conversation.status = 'closed'. Útil pra encerrar conversas após lead ganho ou timeout.
Ações de mensagem WhatsApp
Enviar mensagem WhatsApp (send_whatsapp_message)
Config:
- Mensagem (
message): texto. Suporta interpolação{{lead.name}}, etc. - Instância (
instance_id): qual número enviar. Se não definir, usa padrão. - Mídia (
media_path,media_mime): imagem/áudio/vídeo opcional. - Template fallback (
fallback_template_id): se Cloud API + janela 24h fechada, usa esse template.
Funciona em: QR Code + Cloud API.
Exemplo:
Mensagem: "Olá {{lead.name}}! Recebemos seu cadastro. Em breve nossa equipe entra em contato."
⚠️ Atenção: pra Cloud API com janela fechada, defina template fallback pra não perder mensagem.
Enviar template HSM (send_whatsapp_template)
Config:
- Template ID (status APPROVED).
- Instância.
- Mapeamento de variáveis:
{1: "lead.name", 2: "lead.company"}.
Funciona em: Cloud API only.
Exemplo: template feliz_aniversario com variáveis {{1}} (nome) e {{2}} (empresa).
💡 Dica: use templates pra mensagens fora da janela 24h ou comunicação formal padronizada.
Enviar com botões interativos (send_whatsapp_buttons)
Config:
- Mensagem (
message). - Botões (
buttons): array de até 3, cada um comid(payload) etitle(texto exibido). - Footer (opcional).
Funciona em: Cloud API only.
Exemplo:
Mensagem: "Quer saber mais sobre nossos planos?"
Botões: [
{id: "plano_basico", title: "Plano Básico"},
{id: "plano_pro", title: "Plano Growth"},
{id: "falar_humano", title: "Falar com humano"}
]
Cliente clica → o id vira mensagem inbound + processada normalmente.
Enviar lista interativa (send_whatsapp_list)
Config:
- Mensagem.
- Linhas (
rows): até 10 opções comidetitle. - Título + Texto do botão.
Funciona em: QR Code + Cloud API (algumas versões).
Enviar mensagem em grupo (send_whatsapp_group_message)
Config:
- Instância (QR Code only).
- Group ID (formato
[email protected]). - Mensagem.
Funciona em: QR Code only (Cloud API não expõe grupos).
Agendar mensagem WhatsApp (schedule_whatsapp_message)
Config:
- Mensagem.
- Atraso (
delay_value+delay_unit): ex: 2 horas, 3 dias. - Instância.
Comportamento: agenda mensagem pra enviar N horas/dias depois que a automação disparou.
Caso de uso: lead chegou? → agenda follow-up de 24h depois.
Notificação WhatsApp interna (send_whatsapp_notification)
Config:
- De qual instância (
from_instance_id). - Pra quem (
to_type):user(usuário do tenant) ouphone(número específico). - User ID ou Phone.
- Mensagem.
Comportamento: envia mensagem interna pra equipe (não pro cliente). Útil pra alertas: "⚠️ Lead VIP fechou venda — Pedro!".
Ações de tarefas e dados
Criar tarefa (create_task)
Config:
- Assunto (
subject): obrigatório. - Descrição (
description): opcional. - Tipo (
task_type): call/email/task/visit/whatsapp/meeting. - Prioridade (
priority): low/medium/high. - Vencimento (
due_date_offset): dias após criação. 0 = hoje, 1 = amanhã. - Atribuído (
assigned_to): user_id (opcional).
Exemplo:
Subject: "Ligar pra qualificar {{lead.name}}"
Type: call
Priority: high
Due: 0 (hoje)
Assigned to: 5 (Pedro)
Veja Criar tarefa.
Adicionar nota (add_note)
Config:
- Texto da nota (
body): suporta interpolação.
Exemplo:
Body: "Lead criado via automação. Origem: {{lead.source}}. Tags iniciais: {{lead.tags}}."
Definir UTMs (set_utm_params)
Config: cada um opcional:
utm_source,utm_medium,utm_campaign,utm_term,utm_content.
Comportamento: atualiza UTMs do lead. Útil pra corrigir tracking ou enriquecer leads que vieram sem UTM.
Inscrever em sequência (enroll_sequence)
Config: sequence_id.
Comportamento: inscreve o lead na sequência de nurturing especificada (idempotente — se já inscrito ativo, ignora; se inscrito antes mas saiu, reativa).
Veja Inscrever leads.
Interpolação de variáveis
Em qualquer campo de texto das ações (mensagens, notas, headers de webhook), você pode usar variáveis:
Lead
{{lead.name}}— nome{{lead.email}}— email{{lead.phone}}— telefone{{lead.company}}— empresa{{lead.value}}— valor (R$ formatado){{lead.source}}— origem{{lead.birthday}}— aniversário formatado
Pipeline
{{pipeline}}— nome do funil{{stage}}— nome da etapa atual
Sistema
{{birthday}}— para gatilho de aniversário{{contact_name}}— nome no chat{{task.subject}}— assunto da tarefa (em automações de task_*)
Custom
{{custom:nome_do_campo}}— campo personalizado
💡 Dica: variáveis ausentes são substituídas por string vazia. Cuide pra não ter mensagens com vazios estranhos: "Olá ! Como vai?" (sem nome).
Ordem de execução das ações
Ações são executadas em ordem da lista. Se uma falha:
- Erro na ação é registrado em
LeadEventcom tipoevent_type='automation_error'. - Próximas ações continuam sendo executadas (não interrompe).
- Por isso você pode ter, ex: "manda mensagem (falhou) → cria tarefa (sucesso)".
Limites e cuidados
Mídia em send_whatsapp_message
- Tamanho máximo: 25 MB para upload (max_filesize do servidor).
- Formatos: imagens, áudio, vídeo, documento.
Loops infinitos
Cuidado pra não criar loops:
- ❌ Automação A: lead_stage_changed → move_to_stage etapa Y.
- ❌ Automação B: lead_stage_changed → move_to_stage etapa X.
Cada uma dispara a outra eternamente. Sistema tem proteção (max iterations), mas evite ao configurar.
Custos
- Mensagens WhatsApp livres: gratuitas (texto puro QR Code).
- Templates HSM: cobra Meta por categoria.
- Tokens IA (extract_data): consome quota do plano.
Próximos passos
- Pra entender extração com IA, veja Extrair dados com IA.
- Pra integrar com sistemas externos, veja Enviar webhook.