Integração com WhatsApp: CRM, n8n, Make e o seu sistema

Integrar WhatsApp: 3 caminhos

Não existe um jeito único de integrar o WhatsApp a um sistema. O caminho certo depende de quem vai montar e de onde os dados já vivem.

Passo a passo em 3 chamadas

A base de qualquer integração com WhatsApp são três chamadas: criar a instância, enviar uma mensagem e receber as respostas por webhook. Os exemplos abaixo seguem a referência da API.

1. 1. Criar a instância

   Uma instância é um número de WhatsApp conectado. Depois de criar, conecte o número lendo o QR code (endpoint instance-connect, na referência).

   POST https://api.zapzapapi.com/api/v1/instances
   Headers:
     x-api-key: SUA_API_KEY
     x-api-secret: SEU_API_SECRET
     Content-Type: application/json
   Body:
   { "name": "minha-instancia" }
   
   Resposta:
   { "instance": { "id": "uuid", "name": "minha-instancia", "status": "PENDING" } }

2. 2. Enviar uma mensagem

   Com a instância conectada, envie texto informando o número com código do país.

   POST https://api.zapzapapi.com/api/v1/{instanceId}/send/text
   Headers:
     x-api-key: SUA_API_KEY
     x-api-secret: SEU_API_SECRET
     Content-Type: application/json
   Body:
   { "number": "5511999999999", "text": "Olá! Seu pedido foi confirmado." }
   
   Resposta:
   { "messageId": "ABCDEF123456", "status": "sent" }

3. 3. Receber as respostas por webhook

   Cadastre a URL do seu sistema e escolha os eventos que quer receber. Todos os eventos vêm desativados por padrão: ligue só os que for tratar.

   POST https://api.zapzapapi.com/api/v1/{instanceId}/webhook
   Headers:
     x-api-key: SUA_API_KEY
     x-api-secret: SEU_API_SECRET
     Content-Type: application/json
   Body:
   { "url": "https://seu-sistema.com/webhook", "events": ["messages", "connection", "messages_update"] }

Os valores acima são ilustrativos. Os campos completos de cada endpoint estão na referência da API. Ver a documentação

Webhook, iPaaS ou conector: o que muda

Agentes de IA

Se o seu fluxo tem um agente de IA que precisa falar por WhatsApp, a página de agentes explica o que já funciona (API, nó n8n, templates) e o que ainda não existe.

WhatsApp para agentes de IA