v1.0.0
Public API
🚀 ZapBulk API
API profissional para WhatsApp – múltiplas instâncias, webhooks, grupos, integrações.
Base URL
https://next-cloud-whatsapp-server.y7nagi.easypanel.host📦 Instâncias
POST
Criar nova instância/instance/create
Inicia o processo de criação de uma nova instância para conexão.
POST
Resposta
// Resposta esperada (200 OK)
{
"success": true,
"message": "Instância criada com sucesso",
"instance": {
"instanceId": "minha_instancia",
"token": "abc123token"
}
}GET
Listar todas instâncias/instance/list
Retorna uma lista de todas as instâncias criadas e seus estados básicos.
GET
Resposta
// Resposta esperada (200 OK)
{
"success": true,
"instances": [
{
"instanceId": "instancia_1",
"status": "connected"
},
{
"instanceId": "instancia_2",
"status": "disconnected"
}
]
}GET
Status da instância/instance/status
Verifica o status atual de conexão de uma instância específica.
GET
Resposta
// Resposta esperada (200 OK)
{
"success": true,
"status": "open",
"connected": true
}instance=ID
token=TOKEN
GET
Obter QR Code/instance/qr
Retorna o QR Code em formato base64 ou texto para pareamento.
GET
Resposta
// Resposta esperada (200 OK)
{
"success": true,
"qr": "data:image/png;base64,iVBORw0KG..."
}instance=ID
token=TOKEN
PUT
Reiniciar instância/instance/restart
Reinicia o processo da instância caso ocorra alguma instabilidade.
PUT
Resposta
// Resposta esperada (200 OK)
{
"success": true,
"message": "Instância reiniciada"
}💬 Mensagens
POST
Enviar Texto/message/send
Envia uma mensagem de texto simples para um número.
POST
Resposta
// Resposta esperada (200 OK)
{
"success": true,
"message": "Mensagem enviada",
"messageId": "ABC123456789"
}POST
Imagem / Vídeo/message/send-media
Envia mídia através de uma URL pública.
POST
Resposta
// Resposta esperada (200 OK)
{
"success": true,
"message": "Arquivo de mídia enviado"
}POST
Enquete/message/send-poll
Cria uma enquete interativa no chat.
POST
Resposta
// Resposta esperada (200 OK)
{
"success": true,
"message": "Enquete enviada"
}🔗 Webhooks
POST
Configurar Webhook/webhook/set
Define a URL que receberá as notificações de eventos (mensagens, status, etc).
POST
Resposta
// Resposta esperada (200 OK)
{
"success": true,
"message": "Webhook configurado com sucesso"
}GET
Consultar Webhook/webhook/find
GET
Resposta
// Resposta esperada (200 OK)
{
"success": true,
"webhook": {
"url": "https://seu-site.com/webhook",
"enabled": true
}
}instanceId=ID
🤖 Integrações
A API possui endpoints nativos para integrar com as ferramentas mais populares do mercado:
Typebot
OpenAI
Dify
n8n
Flowise
Chatwoot
WebSocket
RabbitMQ
Exemplo Typebot:
curl -X POST https://next-cloud-whatsapp-server.y7nagi.easypanel.host/typebot/create \
-H "admintoken: SEU_ADMIN_TOKEN" \
-d '{"name":"meu_typebot"}'