Para integração
Ligue o WhatsApp ao seu sistema pela API.
Envie mensagens a partir do seu sistema, ERP ou CRM e receba as respostas e as mudanças de conexão no seu webhook. Cada instância tem o próprio token.
Dores
O que trava a integração com o WhatsApp
Avisar o cliente a partir do sistema
Um pedido muda de situação ou um documento fica pronto, e alguém precisa avisar o cliente à mão.
Como a Zigzapy resolve
O seu sistema chama a API e envia o texto ou o documento direto pelo WhatsApp.
Respostas que não voltam ao sistema
O cliente responde no WhatsApp e a resposta fica fora do histórico do seu sistema.
Como a Zigzapy resolve
As mensagens recebidas chegam no seu webhook, para o sistema registrar e agir.
Número desconectado sem ninguém saber
O número desconecta e as mensagens deixam de sair até alguém perceber.
Como a Zigzapy resolve
Consulte o status da conexão pela API e receba os eventos de conexão no webhook.
Credencial de administração no código
Colocar a credencial de administração do serviço no seu sistema dá acesso a tudo, não só ao seu número.
Como a Zigzapy resolve
A integração usa o token da instância, que só opera aquela instância.
Como funciona
Do QR Code ao primeiro evento no seu sistema
Crie e pareie a instância
No painel, crie a instância e escaneie o QR Code com o WhatsApp do número.
Copie o token
Na tela de integração da instância, copie o token dela.
Chame a API e configure o webhook
Envie mensagens pela API e informe a URL do seu sistema para receber os eventos.
Exemplo
Envie uma mensagem e receba os eventos
A API é REST, por instância, autenticada pelo token da instância. Os dois exemplos usam um token fictício.
Enviar um texto
curl -X POST https://zigzapy.app/api/v1/chat/send/text \
-H "token: SEU_TOKEN_DA_INSTANCIA" \
-H "Content-Type: application/json" \
-d '{"Phone":"5511999999999","Body":"Olá! Mensagem enviada pela Zigzapy."}'const response = await fetch("https://zigzapy.app/api/v1/chat/send/text", {
method: "POST",
headers: { token: "SEU_TOKEN_DA_INSTANCIA", "Content-Type": "application/json" },
body: JSON.stringify({ Phone: "5511999999999", Body: "Olá! Mensagem enviada pela Zigzapy." }),
});
console.log(await response.json());import requests
response = requests.post(
"https://zigzapy.app/api/v1/chat/send/text",
headers={"token": "SEU_TOKEN_DA_INSTANCIA"},
json={"Phone": "5511999999999", "Body": "Olá! Mensagem enviada pela Zigzapy."},
)
print(response.json())Configurar o webhook
curl -X POST https://zigzapy.app/api/v1/webhook \
-H "token: SEU_TOKEN_DA_INSTANCIA" \
-H "Content-Type: application/json" \
-d '{"webhookurl":"https://example.com/webhooks/whatsapp","events":["Message","ReadReceipt","Connected","Disconnected","LoggedOut"]}'const response = await fetch("https://zigzapy.app/api/v1/webhook", {
method: "POST",
headers: { token: "SEU_TOKEN_DA_INSTANCIA", "Content-Type": "application/json" },
body: JSON.stringify({
webhookurl: "https://example.com/webhooks/whatsapp",
events: ["Message", "ReadReceipt", "Connected", "Disconnected", "LoggedOut"],
}),
});
console.log(await response.json());import requests
response = requests.post(
"https://zigzapy.app/api/v1/webhook",
headers={"token": "SEU_TOKEN_DA_INSTANCIA"},
json={
"webhookurl": "https://example.com/webhooks/whatsapp",
"events": ["Message", "ReadReceipt", "Connected", "Disconnected", "LoggedOut"],
},
)
print(response.json())Mensagens
Texto, imagem, áudio, vídeo, documento, localização, contato, enquete e lista.
Webhook de eventos
Mensagens recebidas, confirmações de leitura e mudanças de conexão chegam no seu sistema.
Sessão e conexão
QR Code, código de pareamento por telefone, status da conexão e reconexão.
Grupos
Criar grupos, listar, consultar informações e gerenciar participantes.
Perguntas frequentes
Antes de começar
É a API oficial do WhatsApp (Cloud API da Meta)?
Não. A Zigzapy conecta o número como um aparelho vinculado, pelo QR Code, do mesmo jeito que o WhatsApp Web. Não depende de aprovação da Meta nem de modelos de mensagem aprovados.
Quais eventos chegam no webhook?
Os tipos de evento que você assinar ao configurar o webhook da instância, como mensagens recebidas, confirmações de leitura e mudanças de conexão. Para receber todos, assine All.
O número pode ser bloqueado pelo WhatsApp?
Pode. Nenhum serviço de aparelho vinculado consegue garantir que um número não será restringido: o WhatsApp avalia o comportamento da conta, como volume de envios, denúncias e mensagens para quem não conhece o número. Use para conversas que o contato espera receber.
Onde está a documentação da API?
Na página de documentação, aberta a qualquer pessoa, com todos os endpoints disponíveis e exemplos.
Fale conosco
O acesso é por convite. Conte o que o seu sistema precisa fazer e combinamos como começar.