Version: 2.2.0

• OpenAPI Spec

Joinotify API

A Joinotify Cloud é uma provedora de tecnologia homologada pela Meta que dá acesso à API oficial do WhatsApp (Meta Cloud API) através da nossa infraestrutura — sem Business Manager verificada, sem App Review e sem configurar nada nos painéis da Meta.

Conecte um número em app.joinotify.com e você recebe um token no formato sk_live_xxx, pronto para usar.

Duas superfícies, um token

API simplificada — um endpoint por tipo de mensagem, com o payload reduzido ao essencial. O número de origem sai do próprio token.

API espelhada (/v1) — o contrato da Meta Cloud API byte a byte. Se você já tem código escrito contra o Graph, troque o domínio e o token:

De	Para
https://graph.facebook.com/v21.0/	https://api.joinotify.com/v1/
Bearer <META_TOKEN>	Bearer sk_live_xxx

Seu token do Joinotify substitui completamente o token da Meta — a credencial real nunca é exposta.

Token sempre no header

A documentação da Meta mostra exemplos com ?access_token= na URL. No Joinotify isso não funciona. O token deve ser enviado sempre no header Authorization: Bearer sk_live_xxx.

Limites de uso

Categoria	Rotas	Limite
Envio de mensagens	POST /messages e POST /v1/.../messages	500 req/min
Upload de mídia	POST /v1/.../media	60 req/min
Consultas	todo o resto	60 req/min

Ao estourar, a API responde 429 com Retry-After indicando quantos segundos aguardar.

Códigos que valem para toda a API

• 402 — sem direito de uso. O corpo traz reason: past_due, license_expired, trial_ended, message_limit, canceled. /account e /billing nunca respondem 402: é onde a cobrança se resolve.
• 405 — o caminho existe, mas não com esse método. O header Allow diz quais servem.

Paginação

Toda listagem aceita ?limit= e ?offset= e responde { data, total, limit, offset }. O total é a contagem sem o recorte de página — é com ele que se sabe quando parou de haver próxima.

Endpoints bloqueados

Por segurança, o espelho recusa com 403 qualquer caminho que contenha subscribed_apps, register, deregister, request_code, verify_code, assigned_users, system_users, debug_token, oauth ou uploads, além de POST direto no ID de um número.

Authentication

HTTP: Bearer Auth

Token gerado no painel depois de conectar um número. Formato sk_live_xxx (ou sk_test_xxx). Envie sempre no header Authorization — o token na query string não é aceito.

Security Scheme Type:	http
HTTP Authorization Scheme:	bearer

Contact

Suporte Joinotify: [email protected]

URL: https://joinotify.com