v1.0 · Go + whatsmeow

NeoGo API

WhatsApp API para desenvolvedores

🚀

Primeiros Passos

Crie uma instancia, conecte seu WhatsApp e envie sua primeira mensagem em minutos.

🔒

Autenticacao

Entenda como funcionam as API keys, tokens de instancia e rotacao de credenciais.

📡

Webhooks

Receba eventos em tempo real: mensagens, conexoes, QR codes e mais.

📚

API Reference

Documentacao completa de todos os endpoints com exemplos interativos (Swagger/OpenAPI).

Visao Geral

NeoGo e uma API REST completa para o WhatsApp, construida em Go com o protocolo WhatsApp Web Multi-Device (whatsmeow). Oferece mais de 100 endpoints para mensagens, grupos, contatos, midias, labels, newsletters e mais.

Recursos Principais

Multi-instancia — Gerencie multiplos numeros de WhatsApp simultaneamente
Envio completo — Texto, midia, localizacao, contatos, botoes, listas, carroseis, Pix, stickers, enquetes
Webhooks em tempo real — 13 tipos de eventos via RabbitMQ, Redis, NATS, WebSocket ou HTTP
Failover automatico — Grupos de instancias com health score e fallback
Armazenamento de midia — Upload e download via MinIO (S3-compatible)
Manager UI — Interface web completa para gerenciamento visual
MCP Server — Integracao nativa com agentes de IA
Chatwoot — Integracao bidirecional com o Chatwoot

Endpoints por Dominio

Dominio	Endpoints	Descricao
`/instance`	~20	Criar, conectar, status, QR, proxy, reconectar, logout
`/send`	16	Texto, midia, link, enquete, sticker, localizacao, contato, botao, lista, Pix, carrossel, forward, batch, status
`/message`	8	Reagir, presenca, marcar lido, download midia, deletar, editar
`/chat`	11	Listar, buscar, fixar, arquivar, mutar, historico
`/group`	14	Criar, info, participantes, foto, config, convites
`/user`	14	Info, avatar, contatos, privacidade, bloquear, perfil
`/label`	6	Aplicar/remover labels em chats e mensagens
`/newsletter`	6	Criar, listar, info, inscrever, mensagens
`/community`	5	Criar, adicionar/remover grupos, info
`/call`	2	Rejeitar chamada, historico
`/admin`	~15	Alertas, failover, backfill

Inicio Rapido

# 1. Verificar se o servidor esta rodando
curl http://localhost:4000/server/ok

# 2. Criar uma instancia
curl -X POST http://localhost:4000/instance/create \
  -H "apikey: SUA_CHAVE_GLOBAL" \
  -H "Content-Type: application/json" \
  -d '{"instanceName": "meu-whatsapp"}'

# 3. Obter QR code para conectar
curl http://localhost:4000/instance/qr \
  -H "apikey: TOKEN_DA_INSTANCIA"

Veja o guia completo em Primeiros Passos.