Documentación de WhAPI
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.
Autenticación
Todas las solicitudes de API deben autenticarse mediante una API Key enviada en los encabezados HTTP.
| Header | Valor | Descripción |
|---|---|---|
| X-API-Key | string | Tu clave privada (sk_live_...) Requerido |
| Content-Type | string | application/json |
Gestión de Sesiones
Para empezar a enviar mensajes, primero debe crear una sesión y vincular su dispositivo WhatsApp escaneando el código QR.
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| sessionId | string | Un identificador único para la conexión. Requerido |
Enviar Mensaje de Texto
Envía un mensaje de texto plano a un número individual o a un ID de grupo.
| Parámetro | Tipo | Descripción |
|---|---|---|
| to | string | Número con código de país (ej: 591700...) Requerido |
| body | string | El contenido del mensaje. Requerido |
Enviar Multimedia
Envía archivos, imágenes, videos o audios mediante una URL o base64.
| Parámetro | Tipo | Descripción |
|---|---|---|
| to | string | Número del destinatario. Requerido |
| mediaUrl | string | URL pública del archivo. Requerido |
| caption | string | Texto que acompaña al archivo. |
Enviar Encuesta
Crea una encuesta interactiva en el chat de WhatsApp.
| Parámetro | Tipo | Descripción |
|---|---|---|
| to | string | Número del destinatario. Requerido |
| name | string | Pregunta de la encuesta. Requerido |
| options | array | Lista de opciones (strings). Requerido |
¿Necesitas ayuda técnica?
Nuestro equipo de ingeniería está listo para ayudarte con tu integración.
Preguntas Frecuentes
¿La API es oficial?
WhAPI no es un producto de Meta, pero actúa como un proveedor de servicios que emula WhatsApp Web usando la librería Baileys. Esto permite automatizar cualquier número sin los costos o restricciones de la API Cloud oficial.
¿Pueden bloquear mi número?
Sí, cualquier automatización conlleva riesgo de baneo si se envía SPAM. Recomendamos enviar mensajes únicamente a usuarios que esperan ser contactados (Opt-in) y mantener frecuencias de envío razonables.