Los Webhooks permiten que Mercately notifique en tiempo real a un sistema externo cuando ocurre un evento determinado, evitando la necesidad de realizar consultas manuales constantemente.
1. Acceder al módulo de Webhooks
Para crear un nuevo Webhook:
Ingresa a tu cuenta de Mercately.
Dirígete a:
Automatizaciones → Webhooks
3. Haz clic en Crear Webhook.
2. Configurar el Webhook
Completa la información requerida para establecer la conexión entre Mercately y tu sistema externo.
Nombre: Define un nombre que permita identificar fácilmente la función del Webhook.
Ejemplos:
CRM Producción
ERP Principal
Integración Ecommerce
Target URL: Corresponde a la dirección donde Mercately enviará los eventos.
Esta URL debe cumplir con los siguientes requisitos:
✅ Utilizar protocolo HTTPS.
✅ Permitir solicitudes HTTP POST.
Ejemplo:
https://midominio.com/webhook/clientes
Autenticación: La autenticación permite validar que las solicitudes enviadas por Mercately provienen de una fuente autorizada.
Selecciona el método de autenticación requerido por tu sistema receptor.
Las opciones disponibles son:
Ninguna: No se enviará información adicional de autenticación.
API Key: Permite autenticar mediante una clave única.
OAuth2 (Refresh Token): Utiliza un flujo de autenticación basado en tokens.
Una vez seleccionado el método, completa la información solicitada.
Estado del Webhook
Permite controlar si el Webhook se encuentra activo o desactivado.
Activo: Mercately enviará automáticamente los eventos configurados.
Inactivo: Mercately dejará de enviar notificaciones hasta que sea activado nuevamente.
3. Configurar el tipo de evento
En la sección Tipo de evento, selecciona la información que deseas recibir desde Mercately.
Eventos de Clientes
Cliente creado : Envía una notificación automáticamente cuando se registra un nuevo cliente dentro de Mercately.
Cliente actualizado: Envía una notificación cuando la información de un cliente existente sea modificada.
Puedes seleccionar uno o ambos eventos según las necesidades de tu integración.
Evento | Descripción |
Cliente creado | Envía información cuando se registra un nuevo cliente. |
Cliente actualizado | Envía información cuando cambia la información de un cliente existente. |
4. Configurar Headers del Webhook
Los Headers permiten enviar información adicional junto con cada solicitud realizada por Mercately.
Generalmente se utilizan para incluir datos de autenticación o información necesaria para que el sistema receptor pueda validar la solicitud.
Para agregarlos:
Haz clic en Editar Header.
Haz clic en agregar Header
Ingresa el nombre y valor correspondiente.
Cada Header está compuesto por:
Nombre (Key): Identificador del encabezado.
Valor (Value): Información que será enviada.
Ejemplo:
Header | Valor |
Authorization | Bearer tu_token_de_acceso |
X-API-Key | abc123456789 |
Si tu integración no requiere Headers personalizados, puedes dejar esta sección sin configurar
5. Personalizar el cuerpo del Webhook (JSON)
La opción Editar JSON permite definir la estructura de información que Mercately enviará al Target URL cuando ocurra un evento.
Puedes crear un formato personalizado utilizando variables dinámicas.
Estas variables serán reemplazadas automáticamente por los datos reales del cliente antes de enviar la información.
¿Cómo funciona?
Dentro del editor JSON:
Define la estructura que necesita tu sistema externo.
Selecciona las variables disponibles.
Mercately reemplazará cada variable con la información correspondiente al momento de enviar el evento.
Campos disponibles
Para los Webhooks de Clientes puedes utilizar información como:
Nombres.
Apellidos.
Teléfono.
Email.
Identificación.
Dirección.
También puedes utilizar el buscador para encontrar rápidamente la variable requerida (como por ejemplo campos personalizados del cliente ).
6. Guardar el Webhook
Antes de guardar, verifica que la configuración sea correcta:
✅ Nombre del Webhook.
✅ Target URL.
✅ Método de autenticación (si aplica).
✅ Eventos seleccionados.
✅ Headers configurados.
✅ Estructura JSON personalizada.
Finalmente, haz clic en Guardar Webhook.
A partir de este momento, Mercately enviará automáticamente la información al sistema externo cada vez que ocurra uno de los eventos seleccionados.
Recomendaciones para una integración correcta
Para garantizar una comunicación segura y estable:
Utiliza siempre URLs con certificado HTTPS.
Implementa métodos de autenticación cuando sea necesario.
Envía únicamente la información requerida por tu sistema.
Verifica que tu endpoint responda correctamente con un código HTTP 200 OK.
Realiza pruebas en ambientes de desarrollo antes de activar una integración en producción.
¿Necesitas ayuda?
Si tienes dudas sobre la configuración o integración de Webhooks, nuestro equipo de soporte está disponible para ayudarte.
💬 Chat en vivo: Desde tu plataforma Mercately.
📧 Correo: [email protected]