📄 Documentação da API

Bem-vindo à documentação do ProvedorZAP. Nossa API permite enviar mensagens WhatsApp de forma simples e segura, com suporte a múltiplos clientes e integração com os principais ERPs para provedores de internet.

🔐 Autenticação

Todas as requisições (exceto MK-Auth) exigem o header x-api-key com sua API Key.

x-api-key: zap_sua_api_key_aqui

▶️ Iniciar Sessão

{ "message": "Comando de inicializacao de sessao enviado." }

📊 Status da Sessão

{ "status": "PENDING_QR", "qrCode": "data:image/png;base64,..." }

{ "status": "CONNECTED", "qrCode": null }

🔄 Resetar Sessão

{ "message": "Reset enviado. Aguarde o novo QR Code." }

💬 Enviar Mensagem de Texto

{ "success": true, "messageId": "ID_DA_MENSAGEM" }

{ "success": false, "error": "Descricao do erro" }

⚙️ Envio MK-Auth (com Fila Anti-Banimento)

{ "success": true, "message": "Mensagem adicionada a fila de envio.", "queuePosition": 1 }

👥 Listar Grupos

[
  { "id": "120363XXXXXXXXXX@g.us", "name": "Nome do Grupo" },
  { "id": "120363YYYYYYYYYY@g.us", "name": "Outro Grupo" }
]

🐘 Exemplo em PHP

// Enviar mensagem via PHP
$url = 'https://provedorzap.com.br/api/message/send';
$data = [
    'number'  => '5511999998888',
    'message' => 'Sua fatura vence amanha. Acesse o portal para pagar.'
];
$options = [
    'http' => [
        'method'  => 'POST',
        'header'  => "Content-Type: application/json\r\nx-api-key: zap_sua_api_key\r\n",
        'content' => json_encode($data)
    ]
];
$result = json_decode(file_get_contents($url, false, stream_context_create($options)));
if ($result->success) echo "Mensagem enviada!";

🟨 Exemplo em JavaScript

// Enviar mensagem via fetch
const response = await fetch('https://provedorzap.com.br/api/message/send', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'x-api-key': 'zap_sua_api_key'
    },
    body: JSON.stringify({
        number: '5511999998888',
        message: 'Sua fatura vence amanha!'
    })
});
const data = await response.json();
console.log(data);

🐍 Exemplo em Python

import requests

response = requests.post(
    'https://provedorzap.com.br/api/message/send',
    headers={
        'x-api-key': 'zap_sua_api_key',
        'Content-Type': 'application/json'
    },
    json={
        'number': '5511999998888',
        'message': 'Sua fatura vence amanha!'
    }
)
print(response.json())

🔧 Configuração MK-Auth

No painel do MK-Auth, configure o envio de WhatsApp com os seguintes dados:

❓ FAQ

O QR Code não aparece, o que fazer?

Aguarde até 30 segundos após clicar em "Acessar Painel". Se não aparecer, clique em Reconectar para gerar um novo QR Code.

Meu número foi banido, o que fazer?

Use sempre o endpoint /send-message para envios em massa — ele possui fila anti-banimento com delays automáticos. Evite usar o endpoint direto /api/message/send para grandes volumes.

Posso enviar para grupos?

Sim! Use o endpoint /api/groups para obter o ID do grupo (termina em @g.us) e envie normalmente pelo /api/message/send.

Funciona para números do Paraguai?

Sim! Envie o número com DDI 595XXXXXXXX. O sistema trata automaticamente a formatação correta.

O que acontece com mensagens fora do horário comercial?

Mensagens enviadas via /send-message fora do horário das 8h às 18h são salvas automaticamente e reenviadas no próximo dia útil.

Preciso de suporte?

Entre em contato pelo WhatsApp: clique aqui