All-in-One Messenger Hub
Guía de integración de la API
Conecta tu CRM, sistema de reservas o cualquier aplicación para enviar mensajes de WhatsApp a través de nuestra sencilla API.
Empieza en 5 sencillos pasos
Descarga la app de escritorio
Descarga e instala All-in-One Messenger Hub en tu ordenador con Windows.
Conecta tu WhatsApp
Añade tu cuenta de WhatsApp a la app escaneando el código QR.
Crea una Session API
Ve a la pestaña de WhatsApp y crea una nueva Session API. Vincúlala a tu canal de WhatsApp.
Copia tu clave de API
Copia la clave de API generada. Guárdala bien: es tu autenticación.
Empieza a enviar mensajes
Usa la API desde tu aplicación. Mantén la app de escritorio en ejecución para entregar los mensajes.
Autenticación
Todos los endpoints de la API requieren autenticación mediante tu clave de API. Puedes pasar la clave de cualquiera de estas formas:
| Método | Ejemplo |
|---|---|
| Cabecera X-API-Key (recomendado) | X-API-Key: tu-clave-de-api |
| Parámetro de consulta o cuerpo | key=tu-clave-de-api |
| Parámetro alternativo | api_key=tu-clave-de-api |
Enviar mensaje
Envía un mensaje de WhatsApp a un número de teléfono o a un grupo. Los mensajes se ponen en cola y se entregan cuando la app de escritorio está en ejecución.
POST https://onemessengerhub.com/api/whatsapp-session/sendParámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
key |
string | Sí | Tu clave de API de la app de escritorio |
mobile |
string | Condicional | Número de teléfono con código de país (obligatorio sin group_id) |
group_id |
string | Condicional | ID del grupo de WhatsApp (obligatorio sin mobile). El sufijo @g.us se añade automáticamente. |
message |
string | Sí | Texto del mensaje (máximo 4096 caracteres) |
Solicitud de ejemplo
curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"mobile": "1234567890", "message": "Hello!"}'Solicitud GET simple (navegador o enlace)
https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!Respuesta de éxito (201)
{ "success": true, "message": "Message queued successfully", "data": { "message_id": 123, "recipient": "1234567890", "status": "pending" }}Guardar contacto
Guarda o renombra un contacto en tu WhatsApp. La operación se pone en cola y la procesa la app de escritorio.
POST https://onemessengerhub.com/api/whatsapp-session/save-contactParámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
key |
string | Sí | Tu clave de API de la app de escritorio |
contact_id |
string | Sí | Número de teléfono o ID de WhatsApp del contacto (máximo 50 caracteres). El sufijo @c.us se añade automáticamente. |
name |
string | Sí | Nombre para mostrar del contacto (máximo 255 caracteres) |
Solicitud de ejemplo
curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"contact_id": "1234567890", "name": "John Doe"}'Respuesta de éxito (201)
{ "success": true, "message": "Contact save operation queued", "data": { "operation_id": 456, "contact_id": "[email protected]", "status": "pending" }}Eliminar contacto
Elimina un contacto de tu WhatsApp. La operación se pone en cola y la procesa la app de escritorio.
POST https://onemessengerhub.com/api/whatsapp-session/remove-contactParámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
key |
string | Sí | Tu clave de API de la app de escritorio |
contact_id |
string | Sí | Número de teléfono o ID de WhatsApp del contacto (máximo 50 caracteres). El sufijo @c.us se añade automáticamente. |
Solicitud de ejemplo
curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"contact_id": "1234567890"}'Respuesta de éxito (201)
{ "success": true, "message": "Contact remove operation queued", "data": { "operation_id": 789, "contact_id": "[email protected]", "status": "pending" }}Gestión de errores
La API usa códigos de estado HTTP estándar. Estas son las respuestas de error comunes:
Error de autenticación (401)
{ "success": false, "message": "Invalid or inactive API key"}Error de validación (422)
{ "success": false, "message": "Validation failed", "errors": { "mobile": ["The mobile field is required when group id is not present."], "message": ["The message field is required."] }}Lo que puedes construir
Integración con CRM
Envía mensajes de seguimiento, recordatorios y novedades directamente desde tu sistema CRM.
Confirmaciones de reservas
Envía automáticamente confirmaciones y recordatorios de citas a los clientes.
Notificaciones de pedidos
Avisa a los clientes sobre el estado del pedido, las novedades de envío y la información de entrega.
Sistemas de alertas
Envía alertas y notificaciones importantes a tu equipo o a tus clientes.
Campañas de marketing
Envía mensajes promocionales y novedades a tu lista de contactos.
Flujos de trabajo personalizados
Intégrate con Zapier, Make, n8n o cualquier plataforma de automatización.
Más APIs próximamente
Estamos ampliando nuestra oferta de APIs para cubrir más plataformas y casos de uso.
API de chatbot
Activa respuestas de chatbot y gestiona conversaciones de forma programática.
API de contactos
Accede y gestiona tus contactos de mensajería en todas las plataformas.
Webhooks
Recibe notificaciones en tiempo real cuando se reciben o envían mensajes.