ZapConnect / Dashboard / Home
Minhas Instâncias
Carregando dados...
Upgrade de Plano
Histórico de Faturas
Guia de Integração API
v2.1.0 Stable🚀 Começando a Integrar
Para cada requisição, você precisará da Base URL e da API Key da sua instância específica.
...
apikey: SUA_KEY_DA_INSTANCIA
💬 Envio de Mensagens
1. Texto Simples
// POST /message/sendText/{instancia}
{
"number": "5511999999999",
"text": "Olá! Esta é uma mensagem automática.",
"linkPreview": true
}
2. Imagem com Legenda
// POST /message/sendMedia/{instancia}
{
"number": "5511999999999",
"mediatype": "image",
"media": "https://sua-url.com/foto.jpg",
"caption": "Confira nossa nova oferta! 🏷️"
}
3. Envio de Documentos (PDF/Docx)
// POST /message/sendMedia/{instancia}
{
"number": "5511999999999",
"mediatype": "document",
"media": "https://sua-url.com/contrato.pdf",
"fileName": "Contrato_Assinado.pdf"
}
🪝 Recebimento (Webhooks)
Configure uma URL no seu servidor para receber eventos em tempo real quando uma mensagem for recebida ou o status da conexão mudar.
EXEMPLO DE PAYLOAD RECEBIDO:
{
"event": "messages.upsert",
"instance": "vendas_01",
"data": {
"from": "5511988887777",
"pushName": "Cliente",
"message": "Qual o valor do produto?",
"timestamp": 1715000000
}
}
💻 Exemplo em Node.js (Axios)
const axios = require('axios');
const sendMsg = async () => {
const url = 'BASE_URL/message/sendText/SUA_INSTANCIA';
const headers = { 'apikey': 'SUA_API_KEY' };
const data = {
number: "5511999999999",
text: "Olá mundo! 🚀"
};
const response = await axios.post(url, data, { headers });
console.log(response.data);
};