Planes que admiten esta función: Professional Business Enterprise
Un Webhook es un método para enviar automáticamente datos en tiempo real de una aplicación a otra cuando ocurren eventos específicos. Los webhooks en Document360 te permiten enviar notificaciones a otras aplicaciones, manteniendo a tu equipo informado sobre cambios en el portal de la base de conocimientos, el sitio o el widget.
Por ejemplo, tu equipo de soporte utiliza una herramienta de comunicación como Slack. Al configurar un Webhook, puedes notificar instantáneamente al equipo cuando se actualiza un artículo, asegurando que todos tengan la información más reciente sin necesidad de comprobar manualmente las actualizaciones.
Configuración de un canal de notificaciones en Webhook
Para configurar un canal de notificaciones de Webhook en Document360, sigue los pasos siguientes:
Navega a Configuración () > Portal de la base de conocimientos en la barra de navegación izquierda del portal de la base de conocimiento.
En el panel de navegación izquierdo, navega a Notificaciones.
Por defecto, la pestaña de Canales de Notificaciones estará seleccionada.
Haz clic en Nuevo canal.
En el panel de Canales disponibles , selecciona Webhook y haz clic en Siguiente.
Aparecerá el panel de configuración de Canal .
En el campo de nombres de Friendly , introduce un nombre único para tu canal de Webhook.
En el desplegable de Solicitar método , selecciona POST o PUT, dependiendo de cómo quieras enviar los datos.
En el campo URL de Webhook , introduce la URL de la aplicación a la que quieres enviar notificaciones.
Elige el formato de mensaje deseado en el desplegable Solicitar contenido .
Si se necesitan cabeceras adicionales, haz clic en Añadir nuevas () en Cabeceras por defecto y añádelas.
Opcionalmente, introduce la clave de Autorización si la aplicación receptora requiere autenticación.
Haz clic en Guardar.
NOTA
Para más información, consulte el encabezado de Solicitar.
Una vez que guardas, se crea un nuevo canal de notificaciones de Webhook con el nombre especificado. Ahora, navega a la pestaña de Mapeo de Notificaciones para mapear configuraciones con tu aplicación Webhook según tus necesidades.
Preguntas más frecuentes
¿Qué información incluye una notificación de Webhook?
Cuando se activa un Webhook, Document360 envía una carga útil JSON estructurada a la URL configurada. La carga útil contiene detalles del evento, el usuario que realizó la acción y metadatos sobre el artículo o proyecto.
¿Puedes mostrarme un ejemplo de carga útil?
Sí. A continuación se muestra una carga útil de ejemplo para el evento "Artículo publicado ":
{
"Knowledge base name": "Document360 2.0",
"Event": "Article published",
"User": "Matt sterling",
"User email": "matt.sterling@document360.co",
"Logged on (UTC)": "09/12/2025 06:01:04",
"Article name": "Webhook notification test",
"Article id": "e1444f0x-0xx0-000x-xxx0-0x3f2bc3713c",
"Article URL": "https://Document3602.0/document360.io/docs/en/webhook-notification-test",
"Language": "English",
"Project version id": "55144000-0xxx-000x-0000-0x2346b3bms3",
"Language code": "en"
}Los campos de la carga útil son:
Nombre de la base de conocimiento: El nombre del proyecto de la base de conocimiento.
Evento: El tipo de acción que desencadenó el Webhook (por ejemplo, artículo publicado).
Usuario / Correo electrónico de usuario: El miembro del equipo que realizó la acción.
Conectado (UTC): Fecha y hora de la acción, en UTC.
Nombre del artículo / ID del artículo / URL del artículo: Detalles y enlace al artículo afectado.
Idioma / Código del idioma: El idioma del artículo.
ID de la versión del proyecto: Identificador para la versión de la base de conocimiento.
¿Las cargas útiles varían para otros eventos (por ejemplo, artículo actualizado o eliminado)?
Sí, la estructura de la carga útil sigue siendo similar, pero el campo Evento cambia según la acción—por ejemplo, Artículo actualizado o Artículo eliminado. No solo el campo del evento, sino otros campos como detalles de usuario, detalles del artículo y versión del proyecto pueden variar. Por ejemplo:
{
"Knowledge base name": "Document360 2.0",
"Event": "Extension token deleted",
"User": "Matt sterling",
"User email": "matt.sterling@document360.co",
"Logged on (UTC)": "09/12/2025 06:47:10",
"Extension": "MAKE"
}{
"Knowledge base name": "Document360 2.0",
"Event": "Widget setting created",
"User": "Matt sterling",
"User email": "matt.sterling@document360.co",
"Logged on (UTC)": "09/12/2025 06:47:36",
"Widget setting name": "Knowledge base widget"
}{
"Knowledge base name": "Document360 2.0",
"Event": "Drive folder added",
"User": "Matt sterling",
"User email": "matt.sterling@document360.co",
"Logged on (UTC)": "09/12/2025 06:48:08",
"Folder name": "Media"
}