WPPAPI
Desenvolvedores

Documentação da API

Gateway público estilo Z-API. Auth por token na URL ou headerClient-Token.

Testar 3 dias grátisAbrir painel

Endpoints principais

Base: https://api.wpp-api.com

GET/instances/{id}/token/{token}/statusStatus da sessão
GET/instances/{id}/token/{token}/qr-codeQR para parear
GET/instances/{id}/token/{token}/mePerfil conectado
POST/instances/{id}/token/{token}/send-textEnviar texto
POST/instances/{id}/token/{token}/send-imageEnviar imagem
POST/instances/{id}/token/{token}/send-fileEnviar arquivo
POST/instances/{id}/token/{token}/send-voiceEnviar áudio
POST/instances/{id}/token/{token}/send-videoEnviar vídeo
GET/instances/{id}/token/{token}/check-numberValidar número
GET/instances/{id}/token/{token}/chatsListar chats
GET/instances/{id}/token/{token}/groupsListar grupos

Também: location, contact, reply, reaction, typing, seen, sticker, poll, list, status/stories, edit e pin.

SDK JavaScript

Cliente mínimo para browser e Node com fetch.

import { WppApiClient } from '@wppapi/sdk'

const client = new WppApiClient({
  baseUrl: 'https://api.wpp-api.com',
  instanceId: 'inst_xxx',
  token: process.env.WPPAPI_TOKEN,
})

await client.sendText('5511999999999', 'Olá da WPPAPI 👋')
const status = await client.status()
console.log(status)

cURL em um comando

Ou use o header Client-Token com token _ na URL.

curl -X POST \
  "https://api.wpp-api.com/instances/{id}/token/{token}/send-text" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5511999999999","message":"Olá!"}'

Agentes de IA (MCP)

O pacote @iproute/wppapi-mcp expõe sua instância como servidor MCP: Claude Code, Claude Desktop e qualquer agente compatível passam a enviar e ler mensagens pelo seu WhatsApp — e podem te chamar no WhatsApp para pedir decisões (human-in-the-loop).

claude mcp add whatsapp \
  --env WPPAPI_BASE_URL=https://api.wpp-api.com \
  --env WPPAPI_INSTANCE_ID=sua-instancia \
  --env WPPAPI_TOKEN=sua-api-key \
  -- npx -y @iproute/wppapi-mcp

A aba IA / Agentes no detalhe da instância gera a credencial e os snippets prontos. Documentação completa: docs/mcp.md.

Webhooks

Multi-URL por evento, assinatura HMAC, retry com dead-letter queue, filtros por tipo de mensagem e histórico de deliveries no painel.

  • message / message.any
  • presence
  • groups.v2
  • HMAC + retry + DLQ
  • notifySentByMe
  • Filtros por tipo

Postman + Swagger no painel

Coleção Postman pronta e tag public-api no Swagger. Crie a conta e explore com token real.

Criar conta e obter token