Saltar al contenido
Wbiztool

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#

Conectar tu cuenta#

  1. Agrega Wbiztool a un Zap

    En Zapier, crea un Zap y busca Wbiztool como app de disparador (trigger) o de acción (action).

  2. 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.

CampoDescripción
eventmessage_received para los mensajes entrantes, message_sent para los mensajes enviados desde tu número.
message.typechat para texto. Los mensajes multimedia usan tipos como image, video, audio, ptt (nota de voz), document y sticker.
message.contentEl texto. En los mensajes multimedia, una etiqueta corta como "📸 Image".
message.directionincoming o outgoing.
message.from / message.tofrom es siempre el contacto y to tu número, incluso en los mensajes salientes. Usa message.direction para distinguirlos.
contact.is_grouptrue 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#

  1. Disparador: Wbiztool, New WhatsApp Message (nuevo mensaje de WhatsApp).
  2. Filter by Zapier (filtro de Zapier): continúa solo si message.direction coincide exactamente con incoming.
  3. Acción: Google Sheets, Create Spreadsheet Row (crear fila en la hoja de cálculo). Asigna contact.phone a una columna Phone, contact.name a una columna Name y message.content a 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:

AjusteValor
Action event (evento de acción)POST
URLhttps://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#

ProblemaQué revisar
Invalid API keyLa clave se eliminó o se escribió mal. Crea una nueva en Configuración → Claves API y vuelve a conectar.
Unibox add-on subscription requiredCompra el complemento Unibox en Facturación y Planes y vuelve a activar el Zap.
No available WhatsApp clientsNo 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 clientEl 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 disparaTu 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 servidorEs un problema conocido. Revisa el oyente en los oyentes de Unibox para ver si se eliminó su URL de webhook.