Enviando WhatsApp pelo n8n com a Shiftz (passo a passo)

Para enviar mensagens de WhatsApp pelo n8n com a Shiftz, você usa um nó HTTP Request apontando para a base URL da Shiftz (https://api.shiftz.com.br/v2) com sua apikey no header. Se o seu fluxo já usa a Evolution API, ele funciona trocando só a URL — a Shiftz é drop-in compatível com a v2, então não precisa de nó customizado nem de reescrever nada.

Este tutorial mostra o passo a passo no n8n, sem manter servidor de WhatsApp.

Antes de começar

• Uma instância da Shiftz conectada (estado open).
• Sua apikey shz_<prefixo>.<segredo>.
• Um fluxo no n8n onde você quer disparar a mensagem.

Passo 1 — Adicione um nó HTTP Request

No n8n, adicione o nó HTTP Request e configure:

• Method: POST
• URL: https://api.shiftz.com.br/v2/message/sendText/SUA_INSTANCIA
• Authentication: nenhum (vamos usar header)

Passo 2 — Header de autenticação

Adicione um header:

apikey: shz_xxx.yyy

Passo 3 — Corpo da requisição (JSON)

No corpo, envie o número e o texto. No n8n você pode usar expressões pra puxar dados do passo anterior:

{
  "number": "5511999998888",
  "text": "Olá! Seu pedido foi confirmado."
}

Passo 4 — Receba respostas (opcional)

Para reagir a mensagens recebidas, configure um webhook na instância apontando pro seu nó Webhook do n8n. A Shiftz entrega eventos assinados com HMAC-SHA256 e faz retry por até 24h, então você não perde evento por uma instabilidade momentânea.

Funciona com Make e Typebot também

A mesma lógica vale pra Make, Typebot ou qualquer ferramenta no-code que faça uma chamada HTTP: aponte pra base URL da Shiftz e mande a apikey no header. Não há contrato novo pra aprender.

O que costuma quebrar

• Instância fora do open. Se o número não estiver conectado, o envio retorna 409. Confira o estado antes de disparar o fluxo.
• Número sem WhatsApp. Retorna 422. Vale validar a lista de números antes de enviar em massa.
• Header errado. A autenticação é pelo header apikey, não por Bearer (o Bearer é só pro MCP).

Próximo passo

Crie sua conta grátis, conecte um número e cole a URL no seu nó HTTP do n8n. Em minutos o seu fluxo no-code está mandando WhatsApp.