Configure uma automação de WhatsApp na WACRM e leia o registro de execuções

Uma automação na WACRM é uma regra: quando algo acontece — um pedido novo, um pedido marcado como concluído, um carrinho abandonado, uma mensagem recebida ou um lembrete de reserva — ela roda uma ou mais ações sobre o contato de que trata esse evento. Este tutorial percorre a tela real de Automações, os 5 gatilhos e as 4 ações que existem hoje, como ativar ou desativar uma regra, como ler o registro de execuções, e o mesmo pela API.

O que você precisa antes de começar

• Uma conta WACRM Workspace com pelo menos um projeto.
• Para os gatilhos Novo pedido, Pedido concluído e Carrinho abandonado: uma loja conectada — eles disparam a partir de atividade real da loja, não de uma demonstração. Se o seu plano inclui uma conexão de loja não está detalhado além de “Store connector (early access)” no plano Advanced; confira seu plano em Settings se não tiver certeza.
• Para a ação Enviar um modelo: pelo menos um modelo aprovado, porque a ação só deixa escolher entre modelos aprovados.
• Só para os passos de API: curl (ou qualquer cliente HTTP que consiga definir um cabeçalho), e uma chave de API em Developer / API & MCP.

Crie uma automação na Workspace

1. Abra Automações na Workspace.
2. Clique em Nova automação.
3. Preencha um Nome e escolha um Gatilho. Se você escolher Lembrete de reserva, aparece um campo Momento do lembrete — escolha 24 horas antes ou 2 horas antes; a regra só roda para esse momento, nunca para o outro.
4. Em Ações, clique em Adicionar ação para cada ação que você quer que essa regra rode quando disparar. Escolha um Tipo de ação e preencha os campos desse tipo (veja a tabela abaixo). Deixar Ações vazio ainda salva a regra — ela dispara e fica registrada no registro de execuções, só que não faz nada.
5. Clique em Criar automação.

Os 5 gatilhos

Novo pedido e Pedido concluído geralmente dão suporte a confirmações de pedido e envios de atualização de status, o tipo de mensagem que o WhatsApp classifica como conversa de Utilidade, não Marketing.

As 4 ações

Uma ação sem contato para trabalhar (nenhum contato resolvido a partir do evento que disparou) é ignorada, não falha — Adicionar uma etiqueta e Criar um chamado precisam de um. Propor uma ação do agente também é ignorada enquanto a IA do workspace está pausada. Enviar um modelo confere contato, pausa de IA, consentimento e o status de aprovação do modelo, nessa ordem, antes de enviar qualquer coisa — o mesmo status Approved que o próprio fluxo de criação de modelos da Meta no WhatsApp Manager exige antes de um modelo poder ser usado. Veja “Leia o registro de execuções” abaixo para como cada um desses casos aparece quando uma regra não envia nada.

Ative ou desative uma regra

Cada linha da lista de automações tem um interruptor Ativada, mostrado como Ativado ou Desativado. Mudá-lo salva na hora; se falhar, o interruptor volta ao estado anterior e aparece um erro em linha — nada muda em silêncio. Desativar uma regra faz com que ela pare de disparar com eventos novos; não mexe nas execuções que ela já registrou.

Para remover uma regra por completo, use a ação Excluir da linha. Uma caixa de confirmação pede para você confirmar: “<nome>” será removida permanentemente. Esta ação não pode ser desfeita.

Leia o registro de execuções

Cada linha tem uma coluna Últimas execuções com um interruptor Ver últimas execuções. Abri-lo (só quando você clica — a tabela nunca busca as execuções de todas as regras só por carregar a página) traz as 5 execuções mais recentes da regra e mostra o status de cada uma:

Uma execução Ignorada ou Falhou também mostra um motivo, em linguagem simples: Sem contato neste evento, Contato não encontrado, Etiqueta não encontrada, A IA está pausada para este workspace, O contato não deu consentimento, Modelo não encontrado, Modelo não aprovado, O envio falhou, Tipo de ação desconhecido, ou Erro ao executar esta ação. Uma ação Enviar um modelo cujo envio falha por qualquer motivo — não só um consentimento negado — é sempre registrada como Falhou com motivo O envio falhou, nunca Ignorada, então um problema real de entrega nunca aparece igual a uma omissão esperada por “o contato não deu consentimento”.

Uma execução que trava

Uma execução é reivindicada no momento em que o gatilho dispara e finalizada quando todas as ações já rodaram. Se o processo morre no meio do caminho — uma queda, um reinício — a execução fica Pendente e não é tentada de novo na hora. Uma checagem programada (hoje, a cada 15 minutos) procura execuções pendentes com mais de 15 minutos e as retoma de onde pararam: nenhuma ação já registrada naquela execução roda de novo, então um modelo que já foi enviado nunca é enviado uma segunda vez — a mesma garantia de nova tentativa idempotente em que uma execução retomada se apoia. Uma execução recebe até 3 tentativas no total; depois de esgotá-las ela é marcada como Falhou, com um motivo que o registro de execuções ainda não tem traduzido — você vai ver o valor sem tradução requeue_exhausted em vez de uma frase.

O mesmo pela API

Automações também são um recurso da Core API, em /v1/crm-projects/{project}/automations. Leituras usam o escopo agent:propose, escritas usam agent:approve — marque os dois em Restrict what this key can do (advanced) → WhatsApp CRM scopes ao criar uma chave em Developer / API & MCP (agent:approve precisa de uma Secret key).

Crie uma regra com uma ação

curl -s -X POST "https://api.wacrm.ai/v1/crm-projects/your-project-uuid/automations" \
  -H "Authorization: Bearer sk_live_your_scoped_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Etiquetar pedidos novos",
    "trigger": "order_created",
    "enabled": true,
    "config": { "actions": [{ "type": "add_label", "label_id": "your-label-uuid" }] }
  }'

{
  "data": {
    "id": "0e2b1c9a-...-automation-uuid",
    "name": "Etiquetar pedidos novos",
    "trigger": "order_created",
    "config": { "actions": [{ "type": "add_label", "label_id": "your-label-uuid" }] },
    "enabled": true,
    "created_at": "2026-11-08T09:00:00+00:00",
    "updated_at": "2026-11-08T09:00:00+00:00"
  }
}

Um trigger não reconhecido responde 422 invalid_trigger; um config que não bate com o que esse gatilho (ou esse tipo de ação) exige responde 422 invalid_config — por exemplo, booking_reminder sem um kind de 24h/ 2h, ou uma ação add_label cujo label_id não é uma etiqueta do seu próprio projeto.

Liste as execuções de uma regra

curl -s "https://api.wacrm.ai/v1/crm-projects/your-project-uuid/automations/your-automation-uuid/runs?limit=5" \
  -H "Authorization: Bearer sk_live_your_scoped_key"

{
  "data": [
    { "event_key": "order:9f2a...", "status": "ok", "reason": null },
    { "event_key": "order:7c10...", "status": "skipped", "reason": "no_contact" }
  ]
}

As mais novas primeiro, com os mesmos campos que o próprio painel de Últimas execuções lê, limit de 1 a 100 (padrão 20). Um id de projeto que sua chave não possui, ou um id de automação de outro projeto, ambos respondem 404 not_found — nunca 403, então você não consegue distinguir os dois casos pela resposta. Uma chave sem o escopo necessário responde 403 insufficient_scope.

O que funciona hoje e o que ainda não

Pronto para colocar isso em prática? Solicite acesso antecipado para ter um Workspace, ou deixe a equipe da WACRM configurar o seu projeto com o Quick Setup.