Como criar uma automação

Esse é o ponto de partida — como criar a primeira automação na prática. O processo é simples e visual: você escolhe um gatilho (quando), opcionalmente adiciona condições (filtros) e adiciona ações (o que fazer). O Syncro processa automaticamente quando o gatilho dispara.

Pré-requisitos

• Permissão de admin ou manager.
• Plano com slot de automação disponível (Trial=1, Starter=5, Growth = 15, Scale = 30+).
• Para algumas ações: integração relacionada conectada (WhatsApp pra send_whatsapp_message, Cloud API pra send_template, etc).

Acessar a página

1. Acesse Configurações → Automações no menu lateral.
2. Veja a página Automações com subtítulo "Crie regras para automatizar ações quando eventos ocorrerem no CRM.".
3. Lista de automações existentes com colunas: Nome, Gatilho, Ações, Execuções, Ativo.
4. Se vazio, aparece "Nenhuma automação criada ainda. Clique em Nova Automação para começar.".

Criar nova automação

1. Clique em Nova Automação no canto superior direito.
2. Você cai no formulário visual com sidebar lateral pra escolher gatilho e ações.
3. Preencha o formulário (próximas seções).

Passo 1 — Nome

• Nome (obrigatório, máx 100 caracteres): identificador descritivo da automação. Ex: "Boas-vindas a leads novos", "Aniversário cliente", "Webhook ao fechar venda".
• Apareça na lista de automações + logs de execução.

💡 Dica: nomes descritivos te ajudam a identificar automações depois. Evite nomes genéricos tipo "Automação 1".

Passo 2 — Gatilho (Trigger)

Escolha quando a automação dispara. Há 8+ tipos de gatilho:

• Mensagem recebida — cliente mandou WhatsApp/Instagram/site.
• Nova conversa — primeira mensagem que abre uma conversa nova.
• Lead criado — lead novo cadastrado (manual, importação, formulário, auto-criação).
• Lead movido de etapa — lead mudou de etapa no funil.
• Lead ganho — lead virou venda (etapa is_won).
• Lead perdido — lead virou perda (etapa is_lost).
• Data / Aniversário — cron diário verifica datas (aniversário do lead, X dias após criação, etc).
• Recorrente — semanal ou mensal em horário específico.
• Tarefa criada — tarefa nova no CRM.
• Tarefa próxima do vencimento — alerta antes da tarefa vencer.

Cada gatilho tem configuração específica (ex: lead criado pode filtrar por source ou pipeline_id). Veja Gatilhos disponíveis pra detalhes.

Passo 3 — Condições (opcional)

Adicione filtros pra refinar quando a automação dispara. Sem condições, dispara em toda ocorrência do gatilho.

Cada condição tem 3 partes:

• Campo: o que comparar.
• Operador: como comparar.
• Valor: referência da comparação.

Campos disponíveis:

• message_body — corpo da mensagem (operadores: contains, not_contains, equals, starts_with).
• lead_source — origem do lead (operadores: equals, not_equals).
• lead_tag — tags do lead (operadores: contains, not_contains).
• conversation_tag — tags da conversa (operadores: contains, not_contains).

Exemplos:

• "Só dispara se mensagem contém 'preço'" — filtro por intenção.
• "Só dispara se lead source é 'whatsapp'" — segmenta por canal.
• "Só dispara se conversa tem tag 'vip'" — prioriza VIPs.

Múltiplas condições funcionam como AND (todas precisam bater).

Veja Condições e filtros pra detalhes.

Passo 4 — Ações

Aqui defines o que acontece quando o gatilho + condições passam. Você pode adicionar múltiplas ações em sequência.

Tipos principais:

Ações de tag e categorização

• Adicionar tag ao lead (add_tag_lead)
• Remover tag do lead (remove_tag_lead)
• Adicionar tag à conversa (add_tag_conversation)

Ações de pipeline

• Mover para etapa (move_to_stage)
• Definir origem do lead (set_lead_source)

Ações de atribuição

• Atribuir a usuário (assign_to_user)
• Atribuir agente IA (assign_ai_agent)
• Atribuir fluxo de chatbot (assign_chatbot_flow)
• Transferir pra departamento (transfer_to_department)
• Fechar conversa (close_conversation)

Ações de mensagem

• Enviar mensagem WhatsApp (send_whatsapp_message) — texto + mídia opcional.
• Enviar template HSM (send_whatsapp_template) — Cloud API only.
• Enviar mensagem com botões (send_whatsapp_buttons) — Cloud API only.
• Enviar lista interativa (send_whatsapp_list).
• Enviar mensagem em grupo (send_whatsapp_group_message) — QR Code only.
• Agendar mensagem WhatsApp (schedule_whatsapp_message).
• Notificação WhatsApp (send_whatsapp_notification) — pra você ou equipe.

Ações de tarefas e dados

• Criar tarefa (create_task)
• Adicionar nota (add_note)
• Definir UTMs (set_utm_params)
• Inscrever em sequência (enroll_sequence)

Ações avançadas

• Extrair dados com IA (ai_extract_fields) — IA lê conversa e preenche campos.
• Enviar webhook (send_webhook) — HTTP POST pra sistema externo.

Veja Ações de mensagem/mover/tarefa, Extrair dados IA e Enviar webhook pra detalhes de cada.

Salvar a automação

1. Após preencher tudo, clique em Salvar no rodapé.
2. Validações:

• Nome obrigatório (máx 100 chars).
• Gatilho obrigatório (deve ser válido).
• Pelo menos 1 ação.

3. Se OK, aparece Automação criada! e você é redirecionado pra lista.
4. A automação aparece com toggle Ativo ✅ por default.

Ativar / desativar

Cada automação tem toggle ao lado:

• Ativo ✅ — processa eventos novos.
• Inativo ⛔ — pausa processamento (configuração preservada).

Use desativar pra pausar campanha sem deletar.

Editar automação

1. Na lista, clique em Editar ao lado.
2. Formulário abre com configuração atual.
3. Ajuste e salve.

⚠️ Atenção: editar não afeta execuções passadas. Mudanças valem pra novos disparos.

Excluir automação

1. Clique em Excluir ao lado.
2. Confirmação: "Excluir esta automação?".
3. Confirme.
4. Automação é apagada (configuração + estatísticas — run_count zera).

⚠️ Atenção: deletar é irreversível. Considere desativar se quer pausar.

Templates de automação prontos

O Syncro tem biblioteca de templates com automações pré-configuradas pra começar rápido:

1. Na página de automações, clique em Templates ou Biblioteca (depende da versão).
2. Veja categorias de templates por nicho.
3. Clique Instalar no template desejado.
4. Automação é criada com nome + gatilho + ações pré-definidos.
5. Você ajusta o que quer.

Templates comuns:

• "Boas-vindas WhatsApp" — manda mensagem ao receber primeira conversa.
• "Aniversário lead" — manda mensagem no aniversário.
• "Seguir-up venda perdida" — entra em sequência após lead virar perdido.

Combinações comuns

Boas-vindas a lead novo

• Gatilho: Lead criado.
• Condições: source = 'whatsapp'.
• Ações: add_tag_lead "novo-mes" → assign_ai_agent (Camila) → send_whatsapp_message.

Lead VIP fechou venda

• Gatilho: Lead ganho.
• Condições: lead_tag contém "vip".
• Ações: send_whatsapp_message (mensagem celebração) → enroll_sequence "Onboarding VIP" → send_webhook (sistema externo).

Aniversário cliente

• Gatilho: Data / Aniversário (campo birthday, repeat_yearly=true).
• Ações: send_whatsapp_template "feliz_aniversario" (Cloud API).

Capturar dados de lead via IA

• Gatilho: Mensagem recebida.
• Condições: lead_source = 'whatsapp'.
• Ações: ai_extract_fields (extrai email, empresa, valor potencial).

Limites de plano

Acima do limite: erro "Limite atingido". Faça upgrade.

Boas práticas

1. Comece simples

1 gatilho + 1-2 ações. Adicione complexidade só quando precisa.

2. Use nomes descritivos

"Boas-vindas WA novos leads B2B" > "Automação 1".

3. Teste antes de ativar pra todos

Crie automação inativa, faça evento manual, verifique se executou como esperado, só depois ative.

4. Use condições pra evitar spam

Sem filtros, automações podem disparar em todos os eventos — mensagem irrelevante pode ser enviada. Sempre considere se precisa de condição.

5. Monitore o run_count

Após algumas semanas, veja quantas vezes cada automação rodou. Se run_count=0, talvez ela nunca dispara (gatilho/condições errados). Veja Histórico de execuções.

Próximos passos

• Pra entender cada gatilho em detalhe, veja Gatilhos disponíveis.
• Pra ações específicas, veja artigos respectivos.

Artigos relacionados

• Gatilhos disponíveis
• Ações de mensagem, mover, tarefa
• Condições e filtros
• Histórico de execuções