Publicar solicitudes externas a los equipos con webhooks entrantes

¿Qué son los webhooks entrantes en Teams?

Los webhooks entrantes son un tipo especial de conector en Microsoft teams que proporcionan una forma sencilla para que una aplicación externa comparta contenido en los canales de equipo y que, a menudo, se usan como herramientas de seguimiento y notificación. Teams proporciona una dirección URL única a la que se envía una carga JSON con el mensaje que se desea publicar, normalmente en un formato de tarjeta. Las tarjetas son contenedores de interfaz de usuario (UI) que contienen contenido y acciones relacionadas con un solo tema y son una forma de presentar datos de mensajes de forma coherente. Teams usa las tarjetas en tres capacidades:

  • Bots
  • Extensiones de mensajería
  • Conectores

Características de la clave de webhook entrante

Característica Descripción
Configuración con ámbito Los webhooks entrantes están en el ámbito y configurados en el nivel de canal (por ejemplo, los webhooks de salida tienen ámbito y se configuran en el nivel de equipo).
Proteger las definiciones de recursos Los mensajes tienen el formato de cargas JSON. Esta estructura de mensajería declarativa evita la inyección de código malintencionado ya que no hay ejecución de código en el cliente.
Compatibilidad con la mensajería accionable Si opta por enviar mensajes a través de tarjetas, debe usar el formato de tarjeta de mensaje accionable . Las tarjetas de mensajes que requieren acción se admiten en todos los grupos de Office 365, incluido Microsoft Teams. Estos son vínculos a la referencia de tarjeta de mensaje heredada y la animación de tarjeta de mensaje.
Compatibilidad con mensajería HTTPS independiente Las tarjetas son una buena forma de presentar la información de forma clara y coherente. Cualquier herramienta o marco que pueda enviar solicitudes HTTPS POST puede enviar mensajes a Microsoft Teams a través de un webhook entrante.
Compatibilidad con Markdown Todos los campos de texto en tarjetas de mensajería accionables admiten el Markdown básico. No use marcado HTML en las tarjetas. El código HTML se pasa por alto y se trata como texto sin formato.

Nota

Los bots de Microsoft Teams, las extensiones de mensajería y el marco de bot admiten tarjetas adaptables, un marco de plataforma multitarjeta abierta. Los conectores de Microsoft Teams no admiten tarjetas adaptables en este momento. Sin embargo, es posible crear un flujo que envíe tarjetas adaptables a un canal de Teams.

Agregar un webhook entrante a un canal de Teams

Importante

Si lospermisos => de miembro de configuración => del equipopermiten a los miembros crear, actualizar y quitar conectores está seleccionado, cualquier miembro del equipo puede Agregar, modificar o eliminar un conector.

  1. Navegue hasta el canal donde quiera agregar el webhook y seleccione más opciones (•••) de la barra de navegación superior.
  2. Elija conectores en el menú desplegable y busque el webhook entrante.
  3. Seleccione el botón configurar , especifique un nombre y, opcionalmente, cargue un avatar de imagen para el webhook.
  4. La ventana del cuadro de diálogo presentará una dirección URL única que se asignará al canal. Asegúrese de copiar y guardar la dirección URL, ya que tendrá que proporcionarla al servicio externo.
  5. Seleccione el botón listo . El webhook estará disponible en el canal del equipo.

Quitar un webhook entrante de un canal de Teams

  1. Navegue hasta el canal en el que se ha agregado el webhook y seleccione (•••) más opciones de la barra de navegación superior.
  2. Elija conectores en el menú desplegable.
  3. En la parte izquierda, en administrar, elija configurada.
  4. Seleccione el número configurado para ver una lista de los conectores actuales.
  5. Seleccione administrar junto al conector que desea eliminar.
  6. Seleccione el botón quitar y aparecerá el cuadro de diálogo quitar configuración .
  7. Opcionalmente, complete los campos del cuadro de diálogo y las casillas de verificación antes de seleccionar el botón quitar . El webhook se eliminará del canal del equipo.

Reparto

Tiene tres opciones para distribuir el webhook entrante:

  • Configure un webhook entrante directamente para el equipo.
  • Agregar una página de configuración y envolver el webhook de entrada en un conector de O365
  • Empaquetar y publicar el conector como parte del envío de AppSource .

Más información