INTEGRAÇÕES · RECEITAS DE WORKFLOW

n8n

Conecte eventos da WazGo a workflows e consuma a API com módulos HTTP padrão.

← Todas as integrações · Receitas de configuração com nós padrão; não há node WazGo nem workflow JSON importável publicado.

Use o Webhook Trigger e o HTTP Request padrão do n8n. As receitas abaixo não são um node WazGo nem arquivos de workflow importáveis.

Receber eventos da WazGo

1. No n8n, crie um workflow e adicione o nó Webhook com método POST.
2. Use a Production URL HTTPS do nó e crie um endpoint em Configurações → Desenvolvedores → Webhooks no painel WazGo.
3. Escolha os eventos necessários; um endpoint pode receber mais de um e o campo type permite direcionar o fluxo. Envie webhook.test pelo painel para conferir a chegada.
4. Antes de executar ações, valide a assinatura HMAC usando o body bruto e o timestamp conforme o guia de Webhooks. Se sua configuração não preservar os bytes originais, use um verificador HTTPS sob seu controle antes do n8n.
5. Deduplicate usando id do evento e responda 2xx rapidamente após aceitar o trabalho.

Receitas: campaign.sent → continuar um processo após uma entrega; campaign.failed → abrir alerta ou tarefa; group.synced → atualizar o fluxo que depende da lista de grupos. A WazGo só envia os eventos listados no guia de Webhooks.

Consultar a API com HTTP Request

Crie uma credencial Header Auth no n8n com o header Authorization e o valor Bearer da API Key. Armazene o segredo no cofre de credenciais do n8n; não o escreva em expressões, dados fixados ou workflow exportado. Use scopes mínimos:

• Listar grupos: groups:read.
• Listar campanhas: campaigns:read.
• Consultar uso: usage:read.
• Criar campanha pausada: campaigns:write; acrescente groups:read somente se o mesmo workflow também consultar grupos.

Receita: listar grupos

No HTTP Request, use GET, URL $WAZGO_API_BASE/groups, query opcional limit=50 e credencial Bearer.

Defina WAZGO_API_BASE como o domínio da implantação seguido de /api/public/v1.

curl "$WAZGO_API_BASE"/groups?limit=50 -H "Authorization: Bearer $WAZGO_API_KEY"

Outras receitas de leitura

• Listar campanhas: GET /campaigns com campaigns:read.
• Consultar uso: GET /usage com usage:read.

Receita: criar campanha pausada

Use POST /campaigns. Selecione mídia e grupos já existentes no mesmo workspace. Envie uma Idempotency-Key estável por operação lógica e reutilize a mesma chave em retries. A criação não inicia envios; revise e ative no painel.

curl -X POST "$WAZGO_API_BASE"/campaigns \
  -H "Authorization: Bearer $WAZGO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <CHAVE_ESTAVEL_DA_OPERACAO>" \
  -d '{"name":"Campanha de exemplo","text":"Revise antes de ativar.","mediaId":"<UUID_DE_MIDIA_DO_WORKSPACE>","groupIds":["<UUID_DE_GRUPO_DO_WORKSPACE>"]}'

Documentação oficial do Webhook node · Documentação oficial do HTTP Request node