Webhooks¶
Producto: OpenConnect | Módulo: Usuarios y Plan | Última actualización: 2026-08-12
Introducción¶
Un webhook es un aviso automático: en vez de que su sistema (un ERP, un POS, un panel a medida) le pregunte a OpenConnect "¿hay algo nuevo?" cada cierto tiempo, es OpenConnect quien le avisa apenas ocurre. Por ejemplo, apenas un pedido de un marketplace cambia de estado o se emite un documento tributario, OpenConnect puede enviar ese evento a una URL de su sistema al instante, en vez de que su ERP tenga que sondear la plataforma esperando la novedad.
La pantalla Webhooks es la bitácora de esos avisos: qué entró, qué salió, y si llegó bien.
Acceder¶
Desde Sistema → Webhooks
Qué muestra la tabla¶
Cada fila es un intento de aviso, en cualquiera de las dos direcciones:
| Columna | Qué es |
|---|---|
| Fecha | Cuándo ocurrió el intento |
| Dirección | Incoming (le llegó un aviso a OpenConnect) o Outgoing (OpenConnect avisó hacia afuera) |
| Evento | El tipo de suceso: por ejemplo, la llegada de una notificación de un marketplace, o un cambio de estado de una orden |
| Origen → Destino | De dónde vino y hacia dónde fue |
| Estado | El código de respuesta HTTP del intento |
| Resultado | OK o Error |
Un ejemplo concreto de cada dirección:
- Entrante (
Incoming): MercadoLibre le notifica a OpenConnect que hay una orden nueva o que cambió una publicación. Estos avisos son los que hacen que sus pedidos y su catálogo se mantengan al día sin que nadie tenga que ir a revisar manualmente. - Saliente (
Outgoing): OpenConnect avisa a su propio sistema — por ejemplo cuando llega una orden nueva, cuando una orden cambia de estado, o cuando se emite o se rechaza un documento tributario — para que ese sistema reaccione sin tener que consultar a OpenConnect cada cierto tiempo.
Use los filtros Dirección y Resultado para acotar la lista, por ejemplo para ver solo los avisos salientes que fallaron.
Notas Importantes¶
ℹ️ Nota: Esta pantalla es una bitácora de lectura: muestra el historial de avisos, pero no incluye hoy un formulario para configurar la URL de destino ni el secreto con el que se firman los avisos salientes de su comercio. Si necesita activar o cambiar el destino de sus webhooks salientes, contacte a soporte.
⚠️ Advertencia: Si ve avisos salientes en
Errorde forma repetida, revise primero que el sistema que los recibe esté disponible y respondiendo. Un aviso que falla no bloquea la operación en OpenConnect: el pedido o el documento igual queda registrado normalmente, pero su sistema externo no se entera hasta que el problema se resuelva.
Preguntas Frecuentes de esta Sección¶
¿Un webhook fallido hace que se pierda la información? No. El webhook es solo el aviso; el dato (la orden, el documento) ya quedó guardado en OpenConnect independientemente de si el aviso llegó o no a su sistema.
¿Puedo ver el contenido completo de cada aviso, no solo el resultado? La tabla de esta pantalla muestra el resumen de cada intento. Para el detalle completo del contenido enviado, contacte a soporte.
¿Los eventos de todos los marketplaces aparecen acá? Los eventos entrantes dependen de qué marketplace los envíe activamente. MercadoLibre es el que hoy notifica a OpenConnect de esta forma.
¿Necesita ayuda adicional? Contacte a soporte: soporte@openx.cl