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/ordenes
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 Ordenes
Orden creado : Envía una notificación automáticamente cuando se registra una nueva orden dentro de Mercately.
Orden actualizada: Envía una notificación cuando la información de una orden existente es modificada.
Puedes seleccionar uno o ambos eventos según las necesidades de tu integración.
Evento | Descripción |
Orden Creada | Envía información cuando se registra una nueva Orden. |
Orden Actualizada | Envía información cuando cambia la información de un orden 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 de la orden 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 Ordenes puedes utilizar información como:
Campos disponibles
Campo | Variable | Descripción |
Número de orden |
| Número identificador de la orden dentro de Mercately. |
Estado |
| Estado actual de la orden. |
Subtotal |
| Valor correspondiente a los productos antes de impuestos y otros cargos. |
Impuesto |
| Valor total de impuestos aplicados a la orden. |
Total |
| Valor final de la orden incluyendo impuestos y cargos adicionales. |
Fecha de creación |
| Fecha y hora en la que fue creada la orden. |
Notas |
| Información adicional registrada en la orden. |
Nombre del agente |
| Nombre del usuario o agente asociado a la orden. |
Email del agente |
| Correo electrónico del agente asociado. |
Método de envío |
| Método seleccionado para la entrega del pedido. |
Valor del envío |
| Costo asociado al envío de la orden. |
Dirección |
| Dirección registrada para la entrega. |
Ciudad |
| Ciudad asociada a la dirección de envío. |
Estado (Provincia) |
| Provincia o estado registrado en la dirección. |
Código postal |
| Código postal asociado a la dirección. |
También puedes utilizar el buscador para encontrar rápidamente la variable requerida (como por ejemplo descripcion de los productos , cantidad , nombre , variantes).
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]