Saltar al contenido
WbizTool

Integraciones

Pipedrive y WhatsApp

Conecta Pipedrive con el número de WhatsApp que vinculaste a WbizTool. Escribe a una persona cuando su negocio pasa a una etapa, y registra como notas en Pipedrive los mensajes de WhatsApp que te envía.

WbizTool no tiene una app de Pipedrive. Conectas los dos con una herramienta que quizá ya usas: las Automations propias de Pipedrive, Zapier, Make, n8n o Pabbly Connect. Esta página explica cada vía paso a paso, con plantillas listas para Make y n8n.

Quién puede hacerlo: cualquiera que tenga una clave API de WbizTool puede enviar mensajes. Registrar los mensajes entrantes necesita el complemento Unibox ($20 al mes o $200 al año según los precios de lista en EE. UU. por cada número de la bandeja, en un plan de pago o de por vida) y un Propietario o un Editor que configure el webhook. En Pipedrive, necesitas los permisos que pida tu vía (consulta Elige una vía).

Lo que puedes hacer#

DirecciónEjemploQué necesita en WbizTool
Pipedrive → WhatsAppUn negocio pasa a Proposal sent: la persona recibe "Hola Emma, tienes la propuesta en tu bandeja de entrada." Se añade una persona nueva: recibe un mensaje de bienvenida.Una clave API y un número de WhatsApp conectado.
WhatsApp → PipedriveUn cliente escribe a tu número de WhatsApp: el mensaje se añade como nota en la persona con ese número de teléfono, y la persona se crea si Pipedrive no la tiene.El complemento Unibox, y el número añadido en Números de la bandeja.

Los mensajes salen desde tu propio número de WhatsApp, así que se aplican las reglas de WhatsApp: escribe a personas que esperan saber de ti, como tus prospectos y tus clientes.

Antes de empezar#

Elige una vía#

VíaPipedrive → WhatsAppWhatsApp → PipedrivePlan y permisos de Pipedrive
Pipedrive AutomationsSí, sin otra herramienta: la acción de webhook de la automatización llama a la API de WbizTool.NoLas Automations y su acción de webhook están en los planes Growth y superiores. Solo los administradores globales crean el webhook automatizado.
ZapierSí, con las acciones de la app de WbizTool.Sí, con el disparador Incoming WhatsApp Message de WbizTool.Cualquier plan con acceso a Zapier.
MakeSí, con el módulo HTTP de Make. Blueprint abajo.Sí, con un webhook de Make. Blueprint abajo.Cualquier plan. Los blueprints usan los webhooks de Pipedrive (todos los planes) y un token de API de Pipedrive.
n8nSí, con el Pipedrive Trigger y el nodo de WbizTool. Flujo de trabajo abajo.Sí, con un nodo Webhook y el nodo Pipedrive. Flujo de trabajo abajo.Cualquier plan. n8n necesita un token de API de Pipedrive.
Pabbly ConnectSí, con su acción de solicitud API (Pabbly).Sí, con su disparador de webhook.Cualquier plan.

Los Webhooks propios de Pipedrive (todos los planes) envían un cuerpo fijo que la API de WbizTool no puede leer, así que no llaman directamente a WbizTool. En su lugar, inician un flujo de Make, n8n o Pabbly, como en la receta de Make.

Números de teléfono#

Los dos lados escriben los números de forma distinta. Ten en cuenta estas reglas al asignar campos:

  • Para enviar, pasa el teléfono de Pipedrive tal cual. La API de envío de mensajes quita los espacios, guiones, puntos, paréntesis y el +. Un número escrito con +, como +44 20 7946 0018, conserva su propio código de país. Un número local, como 020 7946 0018, necesita country_code (aquí 44), o va a un número equivocado o falla.
  • Los mensajes entrantes solo traen dígitos. En el webhook, contact.phone es el número sin +, como 442079460018. Busca en Pipedrive con estos dígitos, y añade un + delante cuando crees una persona.
  • Pipedrive guarda los teléfonos tal como se escribieron. Su búsqueda encuentra a una persona por los dígitos de su número, pero un número guardado sin su código de país puede no encontrarse. Guarda los números con el código de país.
  • Números ocultos y grupos. WhatsApp a veces oculta el número del remitente: entonces contact.phone está vacío y contact.phone_hidden es true. Los chats de grupo tienen contact.is_group en true. Las recetas de abajo omiten los dos.

Pipedrive Automations#

Las Automations de Pipedrive pueden enviar una solicitud de webhook como acción. Apúntala a la API de envío de mensajes de WbizTool y la automatización envía ella misma el mensaje de WhatsApp, sin ninguna otra herramienta.

En Pipedrive: un plan Growth o superior. Solo los administradores globales pueden crear el webhook automatizado; para crear la automatización hacen falta permisos para usar las Automations.

  1. Crea el webhook automatizado

    En Pipedrive, abre el menú de la cuenta y ve a Tools and apps → Webhooks. Haz clic en + Webhooks y elige Automated webhook. Llámalo "WbizTool" e introduce https://wbiztool.com/api/v1/ como URL del endpoint. La URL debe terminar en /, porque la automatización añade la ruta. Deja vacía la autenticación: las credenciales de WbizTool van en el cuerpo.

  2. Crea la automatización

    Abre el menú de la cuenta, arriba a la derecha, ve a Tools and apps → Automations y haz clic en + Automation. Selecciona Event trigger, elige deal como elemento y pon Updated como evento disparador. Selecciona la etapa del negocio como campo cuyos cambios se vigilan y haz clic en Apply trigger. Luego añade una condición con el nombre de la etapa del negocio, para que la automatización solo se ejecute cuando un negocio pase a esa etapa.

    Para un mensaje de bienvenida, elige en su lugar person como elemento y el evento Added.

  3. Añade la acción de webhook

    Añade la acción webhook y elige el webhook "WbizTool". Pon el método en POST y añade la ruta send_msg/.

  4. Rellena el cuerpo

    Elige el cuerpo Key-value y añade los campos de abajo. Usa el botón de campos para insertar el teléfono y el nombre de la persona.

    ClaveValor
    client_idTu Client ID.
    api_keyTu clave API.
    whatsapp_clientEl WhatsApp Client ID del número desde el que se envía.
    phoneEl teléfono de la persona de contacto, desde el botón de campos.
    country_codeSolo si tus números de Pipedrive son locales, sin código de país: el prefijo, como 44.
    msgTu mensaje, como Hi [person's first name], your proposal is in your inbox. Reply here if you have questions.

    También puedes elegir Raw y escribir los mismos campos como JSON. Con Key-value no tienes que preocuparte por las comillas en los nombres.

  5. Pruébalo

    Guarda la automatización, actívala y mueve un negocio de prueba a la etapa. Abre Automations → History y la ejecución: muestra el cuerpo que se envió. WbizTool responde "status": 1 cuando el mensaje se pone en cola; un error se responde con HTTP 400 y un message, como Invalid phone number.

Zapier#

Usa la app de WbizTool en Zapier con la app de Pipedrive en Zapier.

Un negocio cambia de etapa: envía un mensaje de WhatsApp#

  1. Disparador: Pipedrive Updated Deal Stage

    Elige Pipedrive y el disparador Updated Deal Stage (etapa del negocio actualizada). Para un mensaje de bienvenida, usa en su lugar New Person.

  2. Filtro: solo tu etapa

    Añade Filter by Zapier y continúa solo cuando la etapa del negocio sea la que quieres. El disparador se ejecuta con cada cambio de etapa.

  3. Busca el teléfono de la persona

    Si los datos del disparador no tienen el teléfono de la persona del negocio, añade la búsqueda Get Person de Pipedrive con el ID de la persona del negocio.

  4. Acción: WbizTool Send Text-Only WhatsApp Message

    Elige tu número de envío en WhatsApp Number. Asigna el teléfono de la persona a Phone Number, rellena Country Code solo si tus números de Pipedrive son locales y escribe el Message con el nombre de la persona.

  5. Prueba y publica

    Un paso correcto significa que el mensaje se puso en cola. Si WbizTool no puede aceptarlo, el paso falla con el motivo, como WbizTool: Invalid phone number.

Llega un mensaje de WhatsApp: añade una nota en Pipedrive#

Necesita el complemento Unibox. Consulta Requisitos del disparador.

  1. Disparador: WbizTool Incoming WhatsApp Message

    Elige el número en WhatsApp Number. Cuando publicas el Zap, WbizTool añade el número a la bandeja y envía sus mensajes recibidos a Zapier.

  2. Filtro: personas, no grupos

    Añade Filter by Zapier: continúa solo cuando Is Group sea false y Contact Phone Hidden sea false.

  3. Busca o crea la persona

    Añade Find or Create Person de Pipedrive: busca personas por un campo (elige el campo de teléfono, con Contact Phone) y crea una persona cuando no encuentra ninguna. Para una persona nueva, pon el nombre en Contact Name y el teléfono en + seguido de Contact Phone.

  4. Crea la nota

    Añade Create Note de Pipedrive. Vincúlala a la persona del paso anterior y escribe el contenido, por ejemplo: WhatsApp from Contact Name: Message Content, con Message Time si quieres la hora.

Make#

No hay app de WbizTool en Make. Los dos blueprints usan los módulos propios Webhooks, HTTP y JSON de Make: el módulo HTTP llama a la API de WbizTool y a la API de Pipedrive.

BlueprintQué hace
pipedrive-deal-stage-to-whatsapp.blueprint.jsonWebhook de Pipedrive (un negocio cambió) → filtro por tu etapa → obtiene la persona del negocio → le envía un mensaje de WhatsApp.
whatsapp-to-pipedrive-note.blueprint.jsonWebhook de mensajes entrantes de WbizTool → busca la persona por teléfono → añade una nota, o antes crea la persona.

Los blueprints se basan en los módulos genéricos de Make, así que funcionan en cualquier plan de Make y no necesitan una conexión de Pipedrive en Make.

Necesitas tu token de API de Pipedrive (en Pipedrive, Settings → Personal preferences → API) y la dirección de tu empresa en Pipedrive, como yourcompany.pipedrive.com.

Un negocio cambia de etapa: envía un mensaje de WhatsApp#

  1. Importa el blueprint

    Crea un escenario en Make, haz clic en los tres puntos de la barra inferior, elige Import Blueprint y selecciona el archivo.

  2. Crea el webhook

    Abre el primer módulo (Webhooks → Custom webhook), haz clic en Add, guarda y copia la dirección que muestra Make.

  3. Rellena los marcadores de posición

    • En el filtro que sigue al webhook, sustituye YOUR_STAGE_ID por el ID de tu etapa. Para encontrarlo, mueve una vez un negocio de prueba a la etapa y lee data.stage_id en la salida del webhook.
    • En el módulo Get the person, sustituye YOUR_COMPANY y YOUR_PIPEDRIVE_API_TOKEN.
    • En el módulo Send WhatsApp, sustituye YOUR_WBIZTOOL_API_KEY en la cabecera Authorization, YOUR_WHATSAPP_CLIENT_ID en el cuerpo y el texto del mensaje.
  4. Apunta el webhook de Pipedrive a Make

    En Pipedrive, ve a Settings → Tools and apps → Webhooks y crea un webhook: acción del evento change (updated en versiones anteriores), objeto del evento deal y la dirección de Make como URL del endpoint.

  5. Actívalo

    Activa el escenario y mueve un negocio de prueba a la etapa. La salida del módulo HTTP muestra la respuesta de WbizTool: "status": 1 significa que el mensaje se puso en cola.

Para crearlo en su lugar con los módulos de Pipedrive de Make, usa Watch New Events (o un Custom webhook como arriba), Get a Person y el módulo HTTP con la misma solicitud que el módulo Send WhatsApp del blueprint. Los módulos de Pipedrive de Make devuelven la persona de un negocio solo como ID, así que necesitas Get a Person para obtener el teléfono.

Llega un mensaje de WhatsApp: añade una nota en Pipedrive#

  1. Importa el blueprint

    Importa whatsapp-to-pipedrive-note.blueprint.json en un escenario nuevo.

  2. Crea el webhook

    Abre Webhooks → Custom webhook, haz clic en Add, guarda y copia la dirección.

  3. Rellena los marcadores de posición

    Sustituye YOUR_COMPANY y YOUR_PIPEDRIVE_API_TOKEN en los cuatro módulos HTTP de Pipedrive (buscar, crear la persona y las dos notas).

  4. Añade la dirección en WbizTool

    En Números de la bandeja, añade tu número a la bandeja, o abre Configuración del webhook en su tarjeta. Pega la dirección de Make en URL del webhook, deja marcado solo Mensajes recibidos y guarda.

  5. Actívalo y pruébalo

    Activa el escenario y envía un mensaje a tu número de WhatsApp desde otro teléfono. En uno o dos minutos aparece la nota en la persona en Pipedrive.

El blueprint omite los chats de grupo, los números ocultos y los mensajes enviados. Para crearlo en su lugar con los módulos de Pipedrive de Make, usa Search Persons en el campo de teléfono, un router, Create a Person y Create a Note.

n8n#

Usa los nodos Pipedrive Trigger y Pipedrive de n8n con el nodo de la comunidad de WbizTool (n8n-nodes-wbiztool). Primero instala el nodo de la comunidad.

Flujo de trabajoQué hace
pipedrive-deal-stage-to-whatsapp.n8n.jsonPipedrive Trigger (un negocio cambió) → If el negocio pasó a tu etapa → Get de la persona en Pipedrive → WbizTool Send Message.
whatsapp-to-pipedrive-note.n8n.jsonWebhook (el mensaje entrante de WbizTool) → If es el mensaje de una persona → Search de la persona por teléfono en Pipedrive → Create de una nota, creando antes la persona si no se encuentra ninguna.
  1. Importa el flujo de trabajo

    En n8n, crea un flujo de trabajo, abre el menú ⋯ y elige Import from File. También puedes pegar el contenido del archivo en el lienzo.

  2. Añade las credenciales

    Abre cada nodo de Pipedrive y crea una credencial Pipedrive API con tu token de API de Pipedrive (Settings → Personal preferences → API en Pipedrive). Abre el nodo WbizTool Send Message y elige tu credencial WbizTool API (Client ID, clave API y el WhatsApp Client ID desde el que se envía).

  3. Define tu etapa y tu mensaje

    En el primer flujo de trabajo, sustituye YOUR_STAGE_ID en el nodo If por el ID de tu etapa (mueve un negocio de prueba a la etapa y lee data.stage_id en la salida del disparador), y edita el Message Text. Deja Country Code vacío cuando tus números de Pipedrive incluyan el código de país.

  4. Activa

    Activa el flujo de trabajo. El Pipedrive Trigger crea su webhook en Pipedrive por sí solo.

    Para el segundo flujo de trabajo, copia la Production URL del nodo Webhook y pégala en URL del webhook en Números de la bandeja, con solo Mensajes recibidos marcado.

Los nodos de Pipedrive de estos archivos son la versión 2 del nodo Pipedrive de n8n. Si tu n8n es más antiguo y los muestra como desconocidos, actualiza n8n o sustitúyelos por el nodo Pipedrive de tu versión, con la misma configuración.

Pabbly Connect#

No hay app de WbizTool en Pabbly Connect: usa sus módulos generales.

  • Pipedrive → WhatsApp: inicia el flujo de trabajo con el disparador de Pipedrive de Pabbly, o con su disparador de webhook alimentado por un webhook de Pipedrive. Después añade API (Pabbly) con Execute API Request a https://wbiztool.com/api/v1/send_msg/, configurado como en Pabbly Connect, y asigna el teléfono y el nombre de la persona.
  • WhatsApp → Pipedrive: empieza con el disparador de webhook de Pabbly, pega su dirección en URL del webhook en Números de la bandeja y envía un mensaje de prueba a tu número para que Pabbly vea los campos. Después añade los pasos de Pipedrive de Pabbly: busca la persona por contact.phone, créala si hace falta y añade una nota con message.content.

Lo que llega desde WhatsApp#

Cada mensaje entrante es una solicitud JSON. Los campos que usan las recetas:

CampoEjemploÚsalo para
eventmessage_receivedOmite message_sent si también marcaste Mensajes enviados.
contact.phone12125550120La búsqueda en Pipedrive, y el teléfono de la persona nueva (con +).
contact.nameEmma ThompsonEl nombre de la persona nueva. Puede estar vacío: usa entonces el teléfono.
contact.is_group, contact.phone_hiddenfalseOmitir los chats de grupo y los números ocultos.
message.contentCan I add a gift note to it?La nota. Las fotos y los archivos llegan como una etiqueta, como 📸 Image.
message.timestamp2026-10-15T10:30:04+00:00Cuándo se envió, en UTC.

Todos los campos, la firma y los reintentos están en Números de la bandeja y webhooks de mensajes entrantes.

Solución de problemas#

ProblemaQué revisar
Auth Error: invalid api keyLa clave se eliminó o se escribió mal, o no pertenece al espacio de trabajo del Client ID. En Make y n8n, revisa la cabecera Authorization: Bearer o la credencial.
Invalid phone numberEl campo de teléfono estaba vacío o contenía otra cosa, como un nombre. Comprueba que la persona tenga un teléfono en Pipedrive y que hayas asignado el campo de teléfono.
El mensaje fue a un número equivocadoPipedrive tiene el número sin su código de país. Guárdalo con el código, como +44 20 7946 0018, o envía country_code.
Invalid JSON format: …Se rompió un cuerpo JSON en bruto, a menudo por unas comillas o un salto de línea en un campo asignado. En Pipedrive Automations usa el cuerpo Key-value; en Make conserva los módulos JSON del blueprint.
La ejecución de la automatización dice "Maximum retry limit reached"WbizTool respondió con un error. Abre la ejecución en Automations → History y lee el cuerpo que se envió.
No llega ningún webhook de WbizToolEl número debe mostrar Sincronizando en Números de la bandeja, con Mensajes recibidos marcado, con el complemento Unibox. Make, n8n y Pabbly deben responder 2xx en 8 segundos: activa el escenario o el flujo de trabajo. Los mensajes se envían en uno o dos minutos.
Tu servidor o tu firewall rechaza el webhook de WbizToolPermite las solicitudes con el User-Agent WbizTool-Webhooks/1. Algunos hostings bloquean clientes desconocidos con 403.
Se añade una nota pero no se encuentra a la persona, así que se crea una persona duplicadaEl número de la persona en Pipedrive está guardado de otra forma, como sin el código de país. Guárdalo con el código y luego fusiona las dos personas en Pipedrive.
No pasa nada con un mensaje de grupoEs a propósito: las recetas omiten los chats de grupo y los números ocultos, que no tienen un teléfono con el que buscar.

Relacionado#