¡Guau! Emoji of happy man Sandbox completo con todas las funciones para desarrolladores — gratis para siempre! Regístrate ahora
Documentación para desarrolladores · API HTTP

Documentación de WhatsApp API

Todo lo que necesita para enviar y recibir mensajes de WhatsApp, automatizar grupos y crear integraciones utilizando solicitudes HTTP simples.
La API admite mensajes, medios, archivos, estados, grupos, comunidades y canales. Puede recibir chats entrantes, enviar productos, procesar pedidos, validar números y crear automatizaciones personalizadas.

Obtener token de API y comenzar Explorar referencia de la API
Empiece a enviar mensajes de WhatsApp en minutos

Comience en 3 pasos simples

Icon

Crear una cuenta y vincular un número

Cree una cuenta en Whapi.Cloud y vincule su número de WhatsApp mediante un código QR.

Icon

Obtenga su token de API

Copie su token de API desde el panel y autorice sus solicitudes.

Icon

Envíe su primer mensaje

Realice su primera llamada a la API y reciba mensajes a través de webhooks.

Crear cuenta y obtener token de API Leer la guía de inicio
Experiencia centrada en desarrolladores

Pruebe la API con sus herramientas favoritas

Una vez que tenga un token de API, puede explorar y probar todos los endpoints usando Swagger o Postman. Use el token de API como encabezado de autorización Bearer.

Probar en Swagger

/

Pruebe la API con sus <span>herramientas favoritas</span>
Pruebe la API con sus <span>herramientas favoritas</span>
Decorartive bubble
Comience <span>más rápido</span> con proyectos listos <span>en GitHub</span>
Ejemplos de código abierto

Comience más rápido con proyectos listos en GitHub

Explore ejemplos reales y proyectos iniciales creados sobre la API de Whapi.Cloud. Nuestros repositorios de GitHub incluyen bots funcionales, utilidades y scripts de automatización en varios lenguajes, diseñados para ayudarle a comprender la API más rápido y lanzar con confianza.

  • Bot de WhatsApp en Node.js: Un ejemplo listo para producción para crear bots y automatizaciones usando JavaScript.
  • Bots en PHP (2 niveles): Ejemplo para principiantes (configuración mínima, estructura clara) y bot avanzado con lógica más compleja, manejo de mensajes, grupos y webhooks.
  • Bots en Python (2 niveles): Bot inicial simple para experimentos rápidos y una implementación avanzada con funciones extendidas y manejo de eventos.
  • Bot en Java: Implementación de chatbot simple y directa para acelerar el inicio del desarrollo.
  • Verificador de números de WhatsApp: Un ejemplo práctico para comprobar la disponibilidad de números de WhatsApp con control de ritmo y procesamiento por lotes.
Ver repositorios en GitHub
Decorartive bubble
Preguntas operativas comunes

Preguntas frecuentes

Whapi.Cloud se conecta a WhatsApp mediante una sesión de dispositivo vinculado. Tu cuenta de WhatsApp se empareja a un canal a través de un código QR o un código de emparejamiento, de forma similar a WhatsApp Web, pero la conexión se mantiene mediante sockets en el backend. La API actúa como una pasarela segura que envía y recibe eventos (mensajes, estados, actualizaciones de grupos) en tiempo real y los expone a través de endpoints HTTP y webhooks.
No. Una vez que el número está vinculado, tu teléfono no necesita permanecer conectado de forma constante. Sin embargo, WhatsApp puede requerir actividad ocasional en el dispositivo principal para mantener válida la sesión vinculada. En la práctica, abrir WhatsApp en el teléfono una vez cada par de semanas suele ser suficiente.
Sí. Puedes seguir usando WhatsApp con normalidad en tu teléfono y en WhatsApp Web mientras la API está conectada. La API funciona en paralelo como un dispositivo vinculado adicional y no bloquea ni reemplaza tu uso habitual.
En algunos casos, WhatsApp puede invalidar automáticamente las sesiones de dispositivos vinculados. Si esto sucede, el canal requerirá una nueva autorización escaneando un nuevo código QR o utilizando un código de emparejamiento. No se pierde ningún dato y, una vez restablecida la vinculación, la API reanuda su funcionamiento normal de inmediato.
Sí. Aunque la API en sí no impone límites estrictos de envío en los planes de pago, WhatsApp supervisa activamente el comportamiento de las cuentas. El uso seguro depende más de cómo se envían los mensajes que de la API en sí. Un calentamiento gradual, un ritmo razonable, contenido relevante y la interacción de los destinatarios son factores clave. Los patrones de envío agresivos o poco naturales pueden provocar restricciones independientemente de la herramienta utilizada, por lo que los flujos de producción siempre deben incluir retrasos, envío por lotes y un control básico de la tasa.
Los webhooks son callbacks HTTP en tiempo real enviados desde Whapi.Cloud a tu servidor cuando ocurren eventos relevantes. Se activan cuando se reciben mensajes, cambian los estados de entrega o lectura, se producen eventos en grupos o canales, u otras actualizaciones relacionadas con WhatsApp. Esto permite que tu sistema reaccione de forma inmediata sin necesidad de consultar la API, lo que convierte a los webhooks en el mecanismo principal para crear automatizaciones y bots basados en eventos.
Sí. La API está diseñada para admitir operación continua y flujos de trabajo de larga duración, como chatbots, servicios de notificaciones, integraciones con CRM y sistemas de monitorización. Una vez que un número está vinculado y correctamente autorizado, la API puede funcionar de forma indefinida, siempre que WhatsApp no restablezca la sesión de dispositivo vinculado. Para un uso estable e ininterrumpido en entornos de producción, se recomienda un plan de pago.
El uso de la API en sí no incrementa automáticamente el riesgo de bloqueo. Las restricciones se deben principalmente a cómo se utiliza la cuenta de WhatsApp. Comportamientos de envío que parezcan spam, una mala reputación del número, baja interacción de los destinatarios o comentarios negativos pueden provocar limitaciones, con o sin API. Seguir las prácticas recomendadas, como un calentamiento gradual, una velocidad de envío controlada y contenido relevante, reduce significativamente el riesgo.
Whapi.Cloud no almacena de forma permanente el contenido de tus mensajes. Los mensajes se procesan en tiempo real para entregarlos, activar webhooks y generar eventos de entrega. Mientras un canal está activo, los datos de los mensajes pueden mantenerse temporalmente en cachés técnicas de corta duración, estrictamente para fines de procesamiento, enrutamiento y gestión de eventos. Una vez que un canal se desconecta o queda inactivo, no se conserva ningún contenido de mensajes en Whapi.Cloud. La API no está diseñada para funcionar como un sistema de almacenamiento o archivo de mensajes. Cualquier almacenamiento a largo plazo, análisis o historial de mensajes debe implementarse en tu propia infraestructura utilizando webhooks y respuestas de la API.

Endpoints de la API REST de WhatsApp

Los parámetros en las consultas GET se envían en la cadena de consulta. Los parámetros en las solicitudes POST se envían mediante el cuerpo de la solicitud codificado en JSON. Use el token como encabezado de autorización Bearer. ¡Obtenga un token para la WhatsApp API!