Crear webhooks y conectores
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
Los webhooks y los conectores solo están disponibles en el entorno de Government Community Cloud (GCC), pero no están disponibles en entornos de GCC-High y del Departamento de Defensa (DOD).
Solo el tipo de conector de webhook entrante está disponible en GCC-High entorno y los administradores de inquilinos deben cargar manualmente para mostrar la aplicación en la página de conectores.
Puede elegir crear una aplicación de Teams del bot de notificación que no sea Webhooks entrantes. Se realizan de forma similar, pero el bot de notificación tiene más funcionalidades. Para obtener más información, consulte build notification bot with JavaScript or Incoming Webhook notification sample (Ejemplo de notificación de notificación de webhook entrante o JavaScript). Para empezar, descargue y explore El kit de herramientas de Teams. Para obtener más información, vea Documentos del kit de herramientas de Teams.
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
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de