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. Para obtener más información, consulte creación de webhooks salientes.

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.

Nota:

Los conectores no pueden actualizar mensajes ni enviar mensajes como respuestas a los mensajes existentes.

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. Para obtener más información, consulte creación de webhooks entrantes.

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 teams Toolkit o enviar notificaciones de fuente de actividad mediante Microsoft Graph API. Los bots de notificación y las notificaciones de fuente de actividad pueden permitir una experiencia más personalizable para satisfacer diferentes escenarios empresariales. Para obtener más información, consulte Planeamiento de enviar notificaciones de aplicaciones.

  API de notificación Bot de notificación Webhook entrante
¿Qué es? UNA API web RESTful Una aplicación de Teams Una característica de Teams
Instalación necesaria Sí Sí No
Escenarios adecuados • Notificar a los usuarios sobre información urgente o crítica.
• Mostrar contenido enriquecido que requiere la acción del usuario en el panel principal de Teams.
• Recibir notificación del sistema operativo con sonido.
• Texto de vista previa localizada en la actividad.		 • 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 • Un único usuario
• Una lista de usuarios
• Usuarios en un chat
• Usuarios de un equipo		 • Canal de Teams
• Chat en grupo
• Chat personal		 Canal de Teams
Proceso de mensaje Una aplicación de Teams realiza una llamada a la API REST para desencadenar una notificación en Actividad en Teams. La llamada API pasa el vínculo profundo para cargar contenido en el panel principal. 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 La aplicación puede usar las API de Graph para trabajar con datos de Microsoft 365. El bot de notificación puede recuperar el contexto de Teams, como la información del canal o el usuario y los mensajes. No
Enviar tarjeta adaptable No Sí Sí
Enviar un mensaje de bienvenida Sí Sí No
Desencadenador admitido Se admiten todos los desencadenadores. 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 Inicio rápido: Microsoft Graph • 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 Microsoft Entra aplicación Azure Bot Framework No se requieren recursos.
Tutorial • Envío de notificaciones de fuente de actividad a usuarios de Microsoft Teams
• Enviar notificación de fuente de actividad		 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. Para obtener más información, consulte Creación de conectores para Grupos de Microsoft 365.

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. Para obtener más información, consulte Creación y envío de mensajes.

Consulte también

Funcionalidades de la aplicación asignadas a características