Zé da API - Hub de Apoio

English | Español | Português

Hub oficial de apoio para assinantes do Zé da API — a API de WhatsApp mais completa do Brasil.

Aqui você encontra a especificação OpenAPI, coleção Postman, node n8n, exemplos de código e changelog de todas as versões.

---

Links Rápidos

Recurso	Link
Documentação API	api.zedaapi.com/docs
Dashboard	zedaapi.com
OpenAPI JSON	openapi-latest.json
OpenAPI YAML	openapi-latest.yaml
Postman Collection	zedaapi-latest.postman.json
n8n Community Node	n8n-nodes-zedaapi
Changelog	CHANGELOG.md
Status	status.zedaapi.com

---

Início Rápido

Envie sua primeira mensagem em 30 segundos:

# Substitua pelos seus dados reais
HOST="https://sua-instancia.zedaapi.com"
INSTANCE_ID="sua-instancia"
INSTANCE_TOKEN="seu-token-aqui"

curl -X POST "${HOST}/instances/${INSTANCE_ID}/token/${INSTANCE_TOKEN}/send-text" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "5511999999999",
    "message": "Olá! Mensagem enviada via Zé da API."
  }'

A autenticação é feita via Instance ID e Instance Token diretamente na URL. Consulte o dashboard para obter seus dados.

---

Postman Collection

Importe a coleção completa no Postman para testar todas as rotas da API:

1. Baixe o arquivo zedaapi-latest.postman.json
2. No Postman, clique em Import e selecione o arquivo
3. Configure as variáveis da coleção:
   • baseUrl: URL do servidor (ex: https://sua-instancia.zedaapi.com)
   • instanceId: ID da sua instância
   • instanceToken: Token da sua instância

A coleção inclui todas as rotas organizadas por categoria: System, Instance, Messages, Webhooks, Contacts, Groups, Media e mais.

---

OpenAPI Spec

A especificação OpenAPI 3.1 está disponível em dois formatos:

• JSON: openapi/openapi-latest.json
• YAML: openapi/openapi-latest.yaml

Você pode importar em qualquer ferramenta compatível com OpenAPI (Swagger UI, Insomnia, Stoplight, etc).

Versões anteriores ficam disponíveis no formato openapi-vX.Y.Z.json.

---

n8n Community Node

Integre o Zé da API diretamente nos seus workflows n8n com o node oficial:

n8n-nodes-zedaapi — Envie mensagens, gerencie grupos, comunidades, newsletters, configure webhooks e mais, tudo direto do n8n.

Instalação no n8n

1. Vá em Settings > Community Nodes
2. Clique em Install a community node
3. Digite n8n-nodes-zedaapi e instale

O node suporta todas as operações da API: envio de mensagens (texto, imagem, documento, áudio, vídeo), gerenciamento de instâncias, webhooks, grupos, comunidades e newsletters.

---

Exemplos de Código

cURL

Scripts shell prontos para usar:

Script	Descrição
send-text.sh	Enviar mensagem de texto
send-image.sh	Enviar imagem
send-document.sh	Enviar documento
instance-connect.sh	Conectar instância (QR Code)
webhook-setup.sh	Configurar webhook

Node.js (TypeScript)

Exemplos usando fetch nativo (sem dependências externas):

Arquivo	Descrição
send-text.ts	Enviar mensagem de texto
send-image.ts	Enviar imagem
webhook-listener.ts	Servidor de webhook

cd examples/nodejs
npm install
npx tsx send-text.ts

Python

Exemplos usando requests:

Arquivo	Descrição
send_text.py	Enviar mensagem de texto
send_image.py	Enviar imagem
webhook_listener.py	Servidor de webhook (Flask)

cd examples/python
pip install -r requirements.txt
python send_text.py

---

Changelog

Todas as alterações e novas versões estão documentadas no CHANGELOG.md.

Versão atual: v3.12.1

---

Suporte

Encontrou um problema ou tem uma sugestão? Abra uma issue:

• Reportar Bug
• Solicitar Feature
• Tirar Dúvida

Para suporte prioritário, entre em contato pelo dashboard ou WhatsApp.

---

Links Úteis

• Site Oficial
• Documentação Interativa
• Dashboard de Gerenciamento
• Status da Plataforma
• Node n8n

---

Feito com dedicação por Setup Automatizado