Integraciones
Integración con Zapier
La app de Wbiztool en Zapier conecta tu número de WhatsApp con las demás apps que usas. Inicia un Zap cuando llega un mensaje de WhatsApp, o envía un mensaje de WhatsApp cuando ocurre algo en otra app.
Antes de empezar#
- Una cuenta de Wbiztool con un número de WhatsApp conectado en la configuración de WhatsApp.
- Tu Client ID y tu API key de Configuración → Claves API.
- Para el disparador de nuevos mensajes: el complemento Unibox en tu plan. Consulta Requisitos del disparador.
Conectar tu cuenta#
Agrega Wbiztool a un Zap
En Zapier, crea un Zap y busca Wbiztool como app de disparador (trigger) o de acción (action).
Inicia sesión
Cuando Zapier te pida conectar una cuenta, ingresa las credenciales que solicita, tu API key y tu Client ID, que encontrarás en Configuración → Claves API.
La API key determina qué espacio de trabajo usa Zapier. Si perteneces a más de un espacio de trabajo, usa una clave creada en el espacio de trabajo que quieres conectar.
Disparador de nuevo mensaje de WhatsApp#
Este disparador inicia tu Zap cada vez que se recibe un mensaje en tu número de WhatsApp. Úsalo para agregar chats nuevos a un CRM, publicar mensajes en un canal del equipo o registrar conversaciones en una hoja de cálculo.
Requisitos del disparador#
- Complemento Unibox. Sin él, activar el Zap falla con
Unibox add-on subscription required. Cómpralo en Facturación y Planes: $20/mes o $200/año por número de WhatsApp usado en Unibox. - Un número de WhatsApp conectado. El disparador se vincula a uno de tus números conectados.
Datos del disparador#
Los mensajes reales tienen este aspecto:
{
"event": "message_received",
"timestamp": "2026-09-16T10:31:12.482913+00:00",
"webhook_id": 42,
"whatsapp_client_id": "678",
"whatsapp_phone": "919812345678",
"message": {
"id": "[email protected]_3EB0C1A2B3D4E5F60718",
"type": "chat",
"content": "Hi, is my order #4821 out for delivery?",
"from": "919876543210",
"from_name": "Aman",
"to": "919812345678",
"timestamp": "2026-09-16T10:29:58+00:00",
"whatsapp_timestamp": 1789554598,
"direction": "incoming",
"status": "pending",
"is_forwarded": false,
"forwarding_score": 0
},
"contact": {
"whatsapp_id": "[email protected]",
"phone": "919876543210",
"name": "Aman",
"is_group": false,
"is_business": false
},
"organisation": {
"id": "5021",
"name": "Acme Stores"
}
}
El ejemplo que carga Zapier mientras configuras el disparador tiene los mismos campos message y contact (excepto message.forwarding_score), pero no incluye webhook_id, whatsapp_client_id, whatsapp_phone ni organisation. Esos campos solo aparecen para asignarlos después de que llegue un mensaje real. El ejemplo también usa valores ficticios: números de teléfono con +, whatsapp_timestamp en milisegundos y status con valor delivered.
| Campo | Descripción |
|---|---|
event | message_received para los mensajes entrantes, message_sent para los mensajes enviados desde tu número. |
message.type | chat para texto. Los mensajes multimedia usan tipos como image, video, audio, ptt (nota de voz), document y sticker. |
message.content | El texto. En los mensajes multimedia, una etiqueta corta como "📸 Image". |
message.direction | incoming o outgoing. |
message.from / message.to | from es siempre el contacto y to tu número, incluso en los mensajes salientes. Usa message.direction para distinguirlos. |
contact.is_group | true cuando el mensaje viene de un grupo. Los mensajes de grupo también incluyen group.name. |
En los mensajes reales, los números de teléfono no llevan +, message.whatsapp_timestamp está en segundos y message.status suele ser pending. Algunos mensajes incluyen campos adicionales: message.media (nombre, tipo y tamaño del archivo) en los archivos multimedia, message.quoted_message_id en las respuestas y group en los mensajes de grupo. Consulta Oyentes de webhook para ver más ejemplos.
Ejemplo: registrar los mensajes entrantes en Google Sheets#
- Disparador: Wbiztool, New WhatsApp Message (nuevo mensaje de WhatsApp).
- Filter by Zapier (filtro de Zapier): continúa solo si
message.directioncoincide exactamente conincoming. - Acción: Google Sheets, Create Spreadsheet Row (crear fila en la hoja de cálculo). Asigna
contact.phonea una columna Phone,contact.namea una columna Name ymessage.contenta una columna Message.
Enviar mensajes de WhatsApp desde un Zap#
Para enviar un mensaje, agrega Wbiztool como acción y elige una de las acciones que aparecen en la página de Wbiztool en Zapier. Asigna el número de teléfono del destinatario y el texto del mensaje a partir de los pasos anteriores.
También puedes llamar directamente a la API con Webhooks by Zapier:
| Ajuste | Valor |
|---|---|
| Action event (evento de acción) | POST |
| URL | https://wbiztool.com/api/v1/send_msg/ |
| Payload type (tipo de payload) | json o form |
| Data (datos) | client_id, api_key, whatsapp_client, country_code, phone, msg |
Consulta Enviar mensajes de WhatsApp desde cualquier herramienta de automatización para saber qué significa cada campo, y Enviar mensaje para ver todas las opciones.
Solución de problemas#
| Problema | Qué revisar |
|---|---|
Invalid API key | La clave se eliminó o se escribió mal. Crea una nueva en Configuración → Claves API y vuelve a conectar. |
Unibox add-on subscription required | Compra el complemento Unibox en Facturación y Planes y vuelve a activar el Zap. |
No available WhatsApp clients | No se indicó ningún número en el disparador y todos los números conectados ya tienen un oyente de Unibox, o no hay ningún número conectado. Esto incluye el oyente que Wbiztool creó la primera vez que activaste este Zap: desactivar un Zap no lo elimina, así que volver a activarlo (por ejemplo, después de editar el Zap) puede fallar. Elimina un oyente que ya no necesites, como ese, en los oyentes de Unibox o conecta otro número en la configuración de WhatsApp. |
Invalid WhatsApp client | El número indicado en el disparador no está conectado en este momento. Vuelve a conectarlo en la configuración de WhatsApp. |
| El Zap está activado pero no se dispara | Tu número de WhatsApp debe seguir conectado para que se detecten los mensajes nuevos. Revisa el oyente en los oyentes de Unibox. |
Zapier muestra un error al desactivar el Zap, como Listener not found o un error del servidor | Es un problema conocido. Revisa el oyente en los oyentes de Unibox para ver si se eliminó su URL de webhook. |
