API WhatsApp
Envía mensajes de texto y medios, consulta grupos y gestiona la vinculación de la sesión con QR o código de emparejamiento. Producto independiente de la API Consulta: URL base, token y límites propios en api.whatsapp.json.pe.
Qué puedes hacer con la API
Endpoints alineados a la documentación API WhatsApp json.pe. El consumo en créditos puede variar según tu plan activo en el panel.
Vincular sesión (QR)
Obtén el código QR para enlazar tu instancia como dispositivo vinculado.
Detalle:
- GET /instance/qr
- Bearer token
- Flujo documentado en docs.json.pe
Pairing code
Código de emparejamiento cuando no puedes escanear QR (dispositivos vinculados).
Detalle:
- GET /instance/pairing-code
- Alternativa al QR
- Misma autenticación Bearer
Estado de instancia
Comprueba si la sesión está conectada antes de enviar mensajes.
Detalle:
- GET /instance/status
- Estados operativos claros
- Evita envíos fallidos
Enviar texto
Mensajes de texto a número en formato E.164 o JID de grupo.
Detalle:
- POST /send/text
- JSON: number, text
- Content-Type: application/json
Enviar archivo (media)
Imagen, documento, video o audio por URL o Base64.
Detalle:
- POST /send/media
- mediatype, filename, caption opcionales
- Misma base api.whatsapp.json.pe
Listar grupos
Lista grupos de la sesión con participantes y metadatos.
Detalle:
- GET /group/all
- Solo Bearer token
- Útil para bots y operaciones
Planes y suscripción
Dos opciones: prueba gratuita o plan de pago por un dispositivo (una sesión vinculada). Activa el producto en el panel.
* Los precios mostrados no incluyen IGV. Confirma límites del producto WhatsApp en app.json.pe.
Plan Gratis
Para vincular la sesión y probar la API con tu propio número, con límites de uso acotados.
Créditos y cupos de prueba según lo indicado en el panel.
- 1 dispositivo / 1 sesión vinculada
- Token Bearer y documentación en docs.json.pe
- Endpoints de envío según límites del plan gratuito
- Soporte por email
Plan Ilimitado
Una instancia activa: un número vinculado como dispositivo enlazado para producción o mayor volumen.
- Incluye 1 dispositivo (1 sesión WhatsApp vinculada)
- Envío de texto y archivos (media), estado de instancia y grupos
- Misma API en api.whatsapp.json.pe
- Ideal para bot, notificaciones o atención con un solo canal
Integración rápida
Misma idea que la guía oficial: token Bearer, JSON en envíos y endpoints bajo https://api.whatsapp.json.pe
// Estado de instancia
curl --request GET \
--url https://api.whatsapp.json.pe/instance/status \
--header 'Authorization: Bearer <TU_TOKEN>'
// Generar QR para vincular sesión
curl --request GET \
--url https://api.whatsapp.json.pe/instance/qr \
--header 'Authorization: Bearer <TU_TOKEN>'
// Enviar mensaje de texto
curl --request POST \
--url https://api.whatsapp.json.pe/send/text \
--header 'Authorization: Bearer <TU_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"number": "51999888777",
"text": "Hola desde la API WhatsApp json.pe"
}'Preguntas frecuentes
API WhatsApp json.pe — sesión, envíos y buenas prácticas