Canal de notificaciones de Webhook

Un canal de notificaciones webhook en Document360 es un método automatizado para enviar datos de eventos en tiempo real desde tu base de conocimientos a una aplicación externa cada vez que ocurre una acción específica. Los webhooks eliminan la necesidad de monitorización manual enviando cargas estructuradas JSON directamente a una URL de tu elección — como un canal de Slack, una integración personalizada o una plataforma de automatización. Puedes configurar varios canales de webhook y asignar cada uno a eventos específicos de la base de conocimiento a través de la configuración de mapeo de notificaciones .

Cuándo usar los canales de notificación de webhook

Utiliza notificaciones de webhook cuando quieras automatizar cómo responde tu equipo o sistemas externos a los cambios en la base de conocimiento.

• Alertas de equipo: Notifique a un equipo de soporte o documentación en Slack o Microsoft Teams en el momento en que un artículo se publique, actualice o elimine, sin que nadie tenga que consultar el portal manualmente.
• Invalidación de caché: Detecta eventos de eliminación de artículos (que incluyen slugs para todos los idiomas) y elimina automáticamente las entradas correspondientes de tu caché de contenido.
• Automatización de flujos de trabajo: Activa procesos posteriores en herramientas como Make o Zapier cuando ocurren eventos específicos, como la publicación de un nuevo artículo o la eliminación de un token de extensión.
• Auditoría y cumplimiento: Transmitir la actividad de la base de conocimiento a un servicio de registro para mantener un seguimiento de auditoría en tiempo real de quién cambió qué y cuándo.

Antes de que empieces

• Ten lista la URL del webhook de destino: este es el punto final proporcionado por la aplicación receptora (por ejemplo, una URL entrante de Slack, un webhook de escenario Make o tu propio endpoint de servidor).
• Si la aplicación receptora requiere autenticación, obtenga la clave de autorización antes de comenzar.

Cómo configurar un canal de notificaciones de webhook

1. Navega a Configuración () > portal de la base de conocimientos en la barra de navegación izquierda.

2. En el panel de navegación izquierdo, selecciona Notificaciones.
   La pestaña de canales de notificaciones está seleccionada por defecto.

3. Haz clic en Nuevo canal.

4. En el panel de Canales disponibles , selecciona Webhook y haz clic en Siguiente.

   

   Aparece el panel de configuración de Canal .

5. En el campo de nombres de Friendly , introduce un nombre único para este canal de webhook.

6. En el desplegable de Solicitud de método , selecciona POST o PUT según lo que espere la solicitud receptora.

7. En el campo URL de Webhook , introduzca la URL de destino donde deben enviarse las notificaciones.

8. En el desplegable Solicitar contenido , elige el formato del mensaje para la carga útil.

9. Si la aplicación receptora requiere cabeceras HTTP adicionales, haz clic en Añadir nuevo () en Cabeceras por defecto y añade cada cabecera como un par clave-valor.

10. Si se requiere autenticación, introduzca la clave de Autorización en el campo correspondiente.

11. Haz clic en Guardar.

El canal de webhook se crea y se lista en Canales de notificaciones. Para activarlo, ve a la pestaña de Mapeo de Notificaciones y asigna el canal a los eventos que quieres seguir.

Mejores prácticas

• Utiliza nombres descriptivos amigables que identifiquen tanto el destino como el alcance del evento — por ejemplo, Slack-ArticlePublish o Make-AllEvents — para que los canales sean fáciles de distinguir al mapear notificaciones.
• Escala cada canal a un conjunto específico de eventos en lugar de enrutarlos todos a través de un único webhook. Esto facilita gestionar fallos y volver a intentar tipos específicos de eventos de forma independiente.
• Asegura tu endpoint con una clave de autorización siempre que la aplicación receptora lo permita, para evitar que cargas útiles no autorizadas lleguen a tus sistemas.
• Utiliza el campo Slugs en los eventos de eliminación para identificar y purgar inmediatamente las entradas correctas de caché en todos los idiomas cuando se elimina un artículo, evitando contenido obsoleto.

Preguntas frecuentes

{
  "Knowledge base name": "Document360 2.0",
  "Event": "Article settings saved",
  "User": "Matt Sterling",
  "User email": "matt.sterling@document360.co",
  "Logged on (UTC)": "09/12/2025 06:15:00",
  "Article name": "Getting Started",
  "Article id": "e1444f0x-0xx0-000x-xxx0-0x3f2bc3713c",
  "Language": "English",
  "Language code": "en",
  "Project version id": "55144000-0xxx-000x-0000-0x2346b3bms3",
  "Project version name": "1.0"
}

{
  "Knowledge base name": "My Knowledge Base",
  "Event": "Article deleted",
  "User": "John Doe",
  "User email": "johndoe@example.com",
  "Logged on (UTC)": "02/13/2026 10:57:16",
  "Article name": "Getting Started Guides",
  "Article id": "24a4e58a-9d64-453c-8f00-4159eb94b82e",
  "Language": "English",
  "Project version id": "0644e0fe-2ae1-4d16-a993-98b81524d5c4",
  "Language code": "en",
  "Slugs": [
    { "language": "en", "slug": "getting-started" },
    { "language": "fr", "slug": "demarrer" },
    { "language": "de", "slug": "erste-schritte" }
  ]
}

{
  "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"
}