La integración de Custom Webhook con IA conecta Custom Webhook con MessageMind para que un agente de IA lea el contexto en tiempo real y responda en todos los canales que usan tus clientes. El disparador Custom Webhook inicia una campaña cada vez que otra herramienta que usas envía los datos de un contacto a una URL que te da MessageMind. No lo encontrarás en la página Integrations: lo eliges como disparador al crear una campaña en la sección Campaigns del Workspace.

¿Qué es la integración de Custom Webhook con IA?

El disparador Custom Webhook inicia una campaña cada vez que otra herramienta que usas envía los datos de un contacto a una URL que te da MessageMind. No lo encontrarás en la página Integrations: lo eliges como disparador al crear una campaña en la sección Campaigns del Workspace. Con cada solicitud, MessageMind busca el contacto por número de teléfono o email (o lo crea) e inicia la campaña para esa persona. Un objetivo Custom Webhook tiene su propia URL y lleva a quien ya está en la campaña al paso que sigue al objetivo.

Puedes ver todas las integraciones disponibles en la página de integraciones de MessageMind, y los detalles técnicos de esta en la documentación de MessageMind sobre Custom Webhook. Si prefieres verla en acción primero, reserva una demostración y te mostramos en vivo cómo funciona.

Qué puede hacer la integración de Custom Webhook

La integración de Custom Webhook con IA incluye de serie estas funciones:

  • Iniciar una campaña desde cualquier herramienta que pueda enviar una solicitud a una URL con el encabezado que elijas, por ejemplo Zapier, Make o tu propio código.
  • Buscar el contacto por número de teléfono o email, o crear un contacto nuevo si no hay coincidencia.
  • Completar el campo de empresa del contacto con companyName si su ficha todavía no lo tiene.
  • Guardar los valores adicionales que envías como campos personalizados del contacto. Puedes usarlos como variables, por ejemplo {{order_id}}, en los mensajes y en las condiciones.
  • Llevar a quien ya está en la campaña directamente al paso posterior a un objetivo Custom Webhook cuando tu herramienta llama a la URL de ese objetivo.
  • Reutilizar valores de una solicitud al objetivo, como un número de pedido, en los pasos que siguen al objetivo.

Datos que lee y escribe

La integración de Custom Webhook con IA usa un conjunto limitado de campos. Esto es exactamente lo que pasa entre los dos sistemas:

DirecciónQué incluye
Lecturaname, phone, email y companyName de cada solicitud enviada a la URL del disparador.
LecturaLos valores de campos personalizados que tu herramienta envía dentro de customFields.
LecturaEn la URL de un objetivo, el teléfono o el email que identifica al contacto, más los campos que indiques en «Variables from this webhook». Todo lo demás de una solicitud al objetivo se ignora.

Cómo configurar la integración de Custom Webhook con IA

La configuración lleva unos minutos si tu cuenta ya está activa. Los pasos:

  • Haz clic en Workspace en la barra superior y luego en Campaigns en el menú de la izquierda.
  • Haz clic en «Create campaign», escribe un nombre en «Campaign name», deja seleccionado «Create an Automation» y haz clic en Create. La campaña nueva se abre en el editor.
  • Haz clic en «Add a Trigger». En la ventana «Choose a trigger», haz clic en «Custom Webhook» debajo de Webhook. Se abre la ventana «Configure trigger».
  • Haz clic en Copy junto a «Webhook URL» y pega la URL en tu otra herramienta como dirección de envío.
  • Configura tu herramienta para que envíe una solicitud POST con el tipo de contenido application/json.
  • De vuelta en MessageMind, haz clic en Copy junto a «Secret token».

La guía paso a paso, con cada botón y cada campo, está en la documentación de MessageMind sobre Custom Webhook.

Limitaciones que debes conocer

La integración de Custom Webhook tiene, a propósito, un alcance limitado. Esto es lo que conviene saber antes de contar con ella:

  • La URL solo acepta solicitudes mientras la campaña está en Published, así que no puedes probarla desde tu herramienta con una campaña en Draft. Usa tus propios datos de contacto para la primera prueba.
  • Se rechaza una solicitud si no tiene nombre, o si no tiene ni número de teléfono ni dirección de email. A las solicitudes al objetivo les basta con el teléfono o el email.
  • Los números de teléfono tienen que ser válidos. Envíalos con + y el código de país, como en el ejemplo. Un número sin código de país se interpreta como un número del país de tu cuenta.
  • Los datos van en un solo sentido. Tu herramienta recibe una respuesta breve que indica si la solicitud se aceptó, y MessageMind no le envía nada más.
  • La URL de un objetivo solo funciona en campañas que empiezan con el disparador Custom Webhook.

Precios y planes disponibles

La integración de Custom Webhook con IA está disponible en los planes de pago de MessageMind. La página de precios de MessageMind indica qué plan necesitas y qué incluye cada uno. No hay ningún cargo extra por integración: la conexión forma parte de tu cuenta.

Preguntas frecuentes

¿Qué es la integración de Custom Webhook con IA?

Es la conexión nativa entre Custom Webhook y MessageMind. Tras la conexión, el agente de IA puede leer el contexto de Custom Webhook en tiempo real durante una conversación y usarlo (por ejemplo, para responder a una pregunta sobre existencias, agendar una cita o actualizar un contacto) en WhatsApp, Instagram, SMS, email y chat web.

¿Cómo conecto Custom Webhook con MessageMind?

Abre la página de la integración de Custom Webhook en tu panel de MessageMind y sigue los pasos de conexión. La guía completa paso a paso, con el nombre de cada campo y capturas de pantalla, está en la documentación de MessageMind sobre Custom Webhook.

¿Cómo funciona la autenticación de la integración de Custom Webhook?

Con cada solicitud, tu herramienta envía el «Secret token» de la campaña en un encabezado llamado X-Webhook-Token. No hay inicio de sesión ni vínculo entre la cuenta de MessageMind y la otra herramienta. Las credenciales se guardan cifradas y solo se usan en el servidor, así que nunca llegan al navegador ni a terceros.

¿MessageMind inicia de verdad una campaña desde cualquier herramienta que pueda enviar una solicitud a una URL con el encabezado que elijas?

Puedes iniciar una campaña desde cualquier herramienta que pueda enviar una solicitud a una URL con el encabezado que elijas, por ejemplo Zapier, Make o tu propio código.

Tu herramienta recibe la respuesta «Invalid webhook token.»: ¿qué hacer?

Comprueba que la campaña esté en Published y guardada, que el encabezado se llame X-Webhook-Token y que su valor sea el «Secret token» actual. Si haces clic en Regenerate, solo funciona el token nuevo. Para una URL de objetivo, la campaña también debe empezar con el disparador Custom Webhook.