Version: 2.2.0

• OpenAPI Spec

Joinotify API

Joinotify Cloud es un proveedor de tecnología homologado por Meta que te da acceso a la API oficial de WhatsApp (Meta Cloud API) a través de nuestra infraestructura — sin Business Manager verificado, sin App Review y sin configurar nada en los paneles de Meta.

Conecta un número en app.joinotify.com y recibirás un token con el formato sk_live_xxx, listo para usar.

Dos superficies, un token

API simplificada — un endpoint por tipo de mensaje, con el payload reducido a lo esencial. El número de origen se resuelve a partir de tu token.

API espejada (/v1) — el contrato de la Meta Cloud API, byte a byte. Si ya tienes código escrito contra el Graph, cambia el dominio y el token:

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

Tu token de Joinotify sustituye por completo al token de Meta — la credencial real nunca queda expuesta.

El token siempre en la cabecera

La documentación de Meta muestra ejemplos con ?access_token= en la URL. En Joinotify eso no funciona. El token debe enviarse siempre en la cabecera Authorization: Bearer sk_live_xxx.

Límites de uso

Categoría	Rutas	Límite
Envío de mensajes	POST /messages y POST /v1/.../messages	500 req/min
Subida de medios	POST /v1/.../media	60 req/min
Consultas	todo lo demás	60 req/min

Al superarlo, la API responde 429 con una cabecera Retry-After que indica cuántos segundos esperar.

Códigos que valen para toda la API

• 402 — sin derecho de uso. El cuerpo trae reason: past_due, license_expired, trial_ended, message_limit, canceled. /account y /billing nunca responden 402: es donde se resuelve el cobro.
• 405 — la ruta existe, pero no con ese método. La cabecera Allow indica cuáles sirven.

Paginación

Todo listado acepta ?limit= y ?offset= y responde { data, total, limit, offset }. El total es el recuento sin el recorte de página: así se sabe cuándo ya no hay siguiente.

Endpoints bloqueados

Por seguridad, el espejo rechaza con 403 cualquier ruta que contenga subscribed_apps, register, deregister, request_code, verify_code, assigned_users, system_users, debug_token, oauth o uploads, además de un POST directo sobre el ID de un número.

Authentication

HTTP: Bearer Auth

Token generado en el panel después de conectar un número. Formato sk_live_xxx (o sk_test_xxx). Envíalo siempre en la cabecera Authorization — un token en la query string no se acepta.

Security Scheme Type:	http
HTTP Authorization Scheme:	bearer

Contact

Soporte Joinotify: [email protected]

URL: https://joinotify.com