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 mensajes entrantes: el complemento Unibox en tu plan. Consulta Requisitos del disparador.

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 tu Client ID y tu API key de 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. Si el Client ID o la API key son incorrectos, Zapier muestra el error al conectar, por ejemplo Auth Error: invalid api key.

Disparador de mensaje entrante de WhatsApp#

Este disparador inicia tu Zap cada vez que alguien envía un mensaje a uno de tus números 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.

1. Elige el disparador

   Elige WbizTool como app e Incoming WhatsApp Message (mensaje entrante de WhatsApp) como evento del disparador.

2. Elige un número de WhatsApp

   En WhatsApp Number (número de WhatsApp), elige el número conectado cuyos mensajes entrantes deben iniciar el Zap. La lista muestra los números de teléfono conectados en tu espacio de trabajo.

3. Prueba el disparador

   Haz clic en Test trigger (probar disparador). Zapier carga los últimos mensajes recibidos en ese número, para que puedas asignar campos reales en los pasos siguientes. Si el número todavía no tiene mensajes, Zapier muestra un mensaje de ejemplo.

4. Activa el Zap

   Publica el Zap. WbizTool se conecta a Zapier automáticamente. No necesitas agregar una URL de webhook en ningún lugar de WbizTool.

Requisitos del disparador#

• Complemento Unibox. El disparador añade tu número a la bandeja Unibox (un número de bandeja). Sin el complemento, 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 bandeja libre. Si el número todavía no está en la bandeja, ocupa uno de los números de bandeja que permite tu complemento. Un número que ya está en la bandeja no ocupa otro.
• Rol Owner o Editor. La API key debe pertenecer a un Owner (Administrador) o Editor del espacio de trabajo.
• Un número de WhatsApp conectado. El número debe seguir conectado para que se detecten los mensajes nuevos.

Cómo funciona el disparador con tus números de bandeja#

• Solo los mensajes entrantes inician el Zap. Los mensajes enviados desde tu número no.
• Solo se envían los mensajes recibidos después de activar el Zap. Los mensajes anteriores no se reenvían.
• Si el número ya está en la bandeja con tu propia URL de webhook, el webhook de Zapier ocupa su lugar mientras el Zap está activado. Cuando desactivas el Zap, se restauran tu URL de webhook, tu secreto y tu configuración de eventos.
• Si eliminas un Zap sin desactivarlo antes, WbizTool deja de enviarle mensajes en cuanto Zapier informa que el Zap ya no existe.
• En Números de la bandeja, el webhook del número muestra una insignia Zapier. Si usas Detener o Quitar en el número allí, el Zap sigue activado en Zapier pero no recibe mensajes, y la página te avisa antes. Para detener el Zap, desactívalo en Zapier. Para que los mensajes vuelvan a llegar después de eliminar el oyente, desactiva el Zap y vuelve a activarlo en Zapier.

Consulta Webhooks de mensajes entrantes para saber cómo funcionan los números de bandeja y los webhooks.

Datos del disparador#

Cada ejecución del Zap recibe un mensaje, como este:

{
  "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",
    "lid": null,
    "phone_hidden": false,
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

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.

Ejemplo: registrar los mensajes entrantes en Google Sheets#

1. Disparador: WbizTool, Incoming WhatsApp Message.
2. 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#

Agrega WbizTool como acción y elige uno de estos eventos de acción:

En cada acción, elige el número que envía en WhatsApp Number. Ingresa el número de teléfono del destinatario con el código de país, como 919876543210, o pon el código de país en el campo opcional Country Code (código de país), como 91. Send WhatsApp Message on Group no tiene teléfono ni código de país; en su lugar pide el Group Name (nombre del grupo).

Cuando WbizTool no puede aceptar un mensaje, el paso falla y Zapier muestra el motivo, por ejemplo WbizTool: Invalid phone number o WbizTool: Not enough credits. Un paso correcto significa que el mensaje se puso en cola. Después, WbizTool lo envía desde tu número conectado.

También puedes llamar directamente a la API con Webhooks by Zapier:

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#