Descargo de responsabilidad: Este artículo se generó mediante traducción automática.

Canal de notificación de webhook

Prev Next

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 de Document360 le permiten enviar notificaciones a otras aplicaciones, manteniendo a su equipo actualizado sobre los cambios en el portal, el sitio o el widget de Knowledge Base.

Por ejemplo, su equipo de soporte utiliza una herramienta de comunicación como Slack. Al configurar un Webhook, puede notificar instantáneamente al equipo cuando se actualiza un artículo, lo que garantiza que todos tengan la información más reciente sin necesidad de buscar actualizaciones manualmente.


Configuración de un canal de notificación de webhook

Para configurar un canal de notificación de webhook en Document360, siga los pasos que se indican a continuación:

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

  2. En el panel de navegación izquierdo, vaya a Portal de la base de conocimientos > Notificaciones.

    De forma predeterminada, se seleccionará la pestaña Canales de notificación .

  3. Haga clic en Nuevo canal.

  4. En el panel Canales disponibles , seleccione Webhook y haga clic en Siguiente.

    Aparecerá el panel de configuración del canal .

  5. En el campo Nombre descriptivo , escriba un nombre único para el canal de Webhook.

  6. En el menú desplegable Método de solicitud , seleccione POST o PUT, según cómo desee enviar los datos.

  7. En el campo URL del webhook , introduzca la URL de la aplicación a la que desea enviar notificaciones.

  8. Elija el formato de mensaje deseado en el menú desplegable Solicitar contenido .

  9. Si se necesitan encabezados adicionales, haga clic en Agregar nuevo () en Encabezados predeterminados y agréguelos.

  10. Opcionalmente, introduzca la clave de autorización si la aplicación receptora requiere autenticación.

  11. Haga clic en Guardar.

NOTA

Para obtener más información, consulte Request header.

Una vez guardado, se crea un nuevo canal de notificación de webhook con el nombre especificado. Ahora, vaya a la pestaña Notification mapping para asignar configuraciones con su aplicación de Webhook en función de sus requisitos.


Preguntas más frecuentes

¿Qué información se incluye en una notificación de Webhook?

Cuando se activa un webhook, Document360 envía una carga JSON estructurada a la dirección URL configurada. La carga útil contiene detalles del evento, el usuario que realizó la acción y metadatos sobre el artículo o proyecto.

¿Puede mostrarme un ejemplo de carga útil?

Sí. A continuación se muestra una carga útil de muestra 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 activó el Webhook (por ejemplo, Artículo publicado).

  • Usuario / Correo electrónico del usuario: El miembro del equipo que realizó la acción.

  • Iniciado sesión (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 de idioma: El idioma del artículo.

  • ID de versión del proyecto: identificador de la versión de la base de conocimientos.

¿Las cargas útiles difieren para otros eventos (por ejemplo, artículo actualizado, eliminado)?

Sí, la estructura de la carga sigue siendo similar, pero el campo Evento cambia en función de la acción, por ejemplo, Artículo actualizado o Artículo eliminado. No solo el campo de evento, sino también otros campos, como los detalles del usuario, los detalles del artículo y la versión del proyecto, también 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"
}