Crear webhooks y conectores

  • Artículo

Los webhooks y conectores ayudan a conectar los servicios web a canales y equipos en Microsoft Teams. Los webhooks son una devolución de llamada HTTP definida por el usuario que notifica a los usuarios cualquier acción que se haya realizado en el canal de Teams. Es una manera de que una aplicación obtenga datos en tiempo real. Los conectores permiten a los usuarios suscribirse para recibir notificaciones y mensajes de los servicios web. Exponen un punto de conexión HTTPS para que el servicio publique mensajes en forma de tarjetas.

Importante

Webhooks salientes

Los webhooks ayudan a Teams a integrarse con aplicaciones externas. Con los webhooks salientes, puede enviar mensajes de texto desde un canal a un servicio web. Después de configurar los webhooks salientes, los usuarios pueden @mention enviar un webhook saliente y enviar un mensaje a un servicio web. El servicio responde en 10 segundos al mensaje con un texto o una tarjeta.

Nota:

Los webhooks salientes se configuran por equipo y no se pueden incluir como parte de una aplicación de Teams normal.

Conectores

Los conectores permiten a los usuarios suscribirse para recibir notificaciones y mensajes de los servicios web. Exponen el punto de conexión HTTPS para que el servicio publique mensajes en canales de Teams, normalmente en forma de tarjetas.

Webhooks entrantes

Los webhooks entrantes ayudan a publicar mensajes de aplicaciones en Teams. Si los webhooks entrantes están habilitados para un equipo en cualquier canal, expone el punto de conexión HTTPS, que acepta JSON con el formato correcto e inserta los mensajes en ese canal. Por ejemplo, puede crear un webhook entrante en el canal de DevOps, configurar la compilación e implementar y supervisar servicios simultáneamente para enviar alertas.

Bot de notificación o webhook entrante

Antes de empezar a aprender a crear webhooks entrantes, es posible que también quiera saber que puede crear un bot de notificación mediante el kit de herramientas de Teams. Los bots de notificación pueden habilitar una experiencia más personalizable para satisfacer diferentes escenarios empresariales.

Obtenga más información sobre las diferencias entre un bot de notificación y un webhook entrante para que pueda elegir las soluciones adecuadas para sus escenarios:

  Bot de notificación Webhook entrante
¿Qué es? Una aplicación de Teams Una característica de Teams
Instalación necesaria Sí No
Escenarios adecuados • Recibir notificaciones y mensajes periódicamente, por ejemplo, recibir notificaciones diarias de tareas del equipo.
• Recibir notificaciones y mensajes basados en eventos reales. Por ejemplo, una vez que los compañeros de equipo cargan archivos, recibe notificaciones.		 Comunicarse con aplicaciones externas y recibir notificaciones y mensajes de otras aplicaciones.
Configuración del ámbito • Canal de Teams
• Chat en grupo
• Chat personal		 Canal de Teams
Proceso de mensaje Un bot de notificación funciona como una aplicación de Teams. Puede definir la lógica de negocios para procesar datos y mostrar datos en un formato personalizado. Webhook es una característica de Teams en lugar de una aplicación de Teams, por lo que solo recibe y muestra datos sin procesamiento.
Recuperación del contexto de Teams El bot de notificación puede recuperar el contexto de Teams, como el canal o la información del usuario, los mensajes, etc. No
Enviar tarjeta adaptable Sí Sí
Enviar un mensaje de bienvenida Sí No
Desencadenador admitido Se admiten todos los desencadenadores. Si usa Teams Toolkit, puede obtener rápidamente un proyecto de plantilla con los siguientes desencadenadores:
• Desencadenador de tiempo hospedado en funciones de Azure.
• Restify HTTP trigger hospedado en Azure App Service.
• Desencadenador HTTP hospedado en Azure Functions.		 Se admiten todos los desencadenadores.
Herramientas de compilación • Introducción al kit de herramientas de Teams para Visual Studio Code
•Introducción al kit de herramientas de Teams para Visual Studio
• CLI del kit de herramientas de Teams
• SDK de TeamsFx		 No se requiere ninguna herramienta.
Recurso en la nube necesario Azure Bot Framework No se requieren recursos.
Tutorial Crear un bot de notificaciones con JavaScript Ejemplo de notificación de webhook entrante

Conectores para Grupos de Microsoft 365

Los conectores para Grupos de Microsoft 365 permiten crear una página de configuración personalizada para el webhook entrante y empaquetarlos como parte de una aplicación de Teams. Los mensajes se envían principalmente mediante tarjetas de conector para Grupos de Microsoft 365 y pueden agregarles un conjunto limitado de acciones de tarjeta. Por ejemplo, un conector meteorológico que permite a los usuarios seleccionar una ubicación y cualquier hora del día para recibir actualizaciones sobre el clima de mañana. Se configuran en el nivel de canal, pero se instalan en el nivel de equipo.

Nota:

Puede distribuir el conector para Grupos de Microsoft 365 aplicación de Teams a nuestra AppStore.

Crear y enviar mensajes

Los mensajes que requieren acción permiten a los usuarios tomar medidas sin salir de su cliente de correo electrónico, lo que aumenta la involucración del usuario. Con Microsoft 365 y webhooks entrantes, puede enviar mensajes publicando una carga JSON en la dirección URL del webhook.

Paso siguiente

Crear webhooks salientes

Consulte también