Compartir a través de

Crear webhooks y conectores

  • Artículo

Importante

Los conectores de Microsoft 365 (anteriormente denominados conectores de Office 365) están a punto de desuso y la creación de nuevos conectores de Microsoft 365 pronto se bloqueará. Para obtener más información sobre la programación y cómo la aplicación Flujos de trabajo proporciona una experiencia más flexible y segura, consulte Retirada de conectores de Microsoft 365 en Microsoft Teams.

¿Cómo puede crear un webhook en Teams?

Si ya ha creado conectores de Office 365:

  • Creación de un conector de Power Automate: Power Automate mejora las aplicaciones de flujos de trabajo ampliamente utilizadas en Teams. Es el enfoque escalable y seguro para transmitir datos mediante programación dentro y fuera de Teams. Si adopta este método, puede crear plantillas de flujo de trabajo para publicar alertas desde el producto en canales de Teams. Este enfoque simplifica la adopción por parte del usuario del nuevo método. Para obtener más información, consulte Power Automate para desarrolladores empresariales, ISV y asociados.

  • Actualizar la aplicación de Teams: puede mejorar la aplicación actual de Teams. Por ejemplo, puede permitir que los usuarios configuren mensajes proactivos basados en eventos de desencadenador dentro del sistema. Para obtener más información, consulte cómo los bots pueden publicar en canales a través de mensajes proactivos.

Problemas conocidos

  • La aplicación Flujos de trabajo no puede publicar en canales privados como un bot de flujo. Sin embargo, puede publicar en nombre de un usuario.
  • Los flujos de trabajo solo admiten tarjetas adaptables. No admite el formato de tarjeta de mensaje anterior que usan los conectores de Office 365. Los flujos de trabajo no admiten el uso del formato de tarjeta de mensaje. Para obtener más información, vea cómo convertir el formato de tarjeta de mensaje del conector a tarjeta adaptable.
  • Los flujos de trabajo no ofrecen conectores de terceros, como DataDog y Jenkins.
  • Los flujos de trabajo solo se pueden crear en el entorno predeterminado.

Limitaciones

Los flujos de trabajo solo están vinculados a usuarios específicos (denominados propietarios del flujo de trabajo) y no a un equipo o canal de Teams. Los flujos de trabajo pueden convertirse en flujos huérfanos en ausencia de un propietario si no se asigna ningún copropietario. Para mantener la continuidad en el proceso empresarial automatizado por el flujo, los administradores pueden agregar uno o varios copropietarios y concederles control total sobre el flujo de trabajo. También pueden agregar autenticación para las conexiones, si las hubiera, y habilitar el flujo si se ha deshabilitado. Para obtener más información, consulte Administración de flujos huérfanos.

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.
• Desencadenador HTTP rápido 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 publicar el conector para Grupos de Microsoft 365 aplicación de Teams en 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.

Recursos adicionales

Funcionalidades de la aplicación asignadas a características