Crear webhooks entrantes con flujos de trabajo para Microsoft Teams

Se aplica a
Teams Microsoft Teams

Un webhook entrante permite a las aplicaciones externas compartir contenido en chats y canales en Microsoft Teams. Los webhooks se usan como herramientas para realizar un seguimiento y notificar. Puede publicar en un canal o chat cuando se recibe una solicitud de webhook.

Configurar un flujo de trabajo entrante de webhook a partir de una plantilla

Seleccione Más opcionesIcono más opciones de Microsoft Teams junto al canal o chat para el que desea crear un flujo de trabajo y, a continuación, seleccione Logotipo de flujo de trabajo de flujos de trabajo.  

Dependiendo de si desea que el webhook publique en un chat o canal, elija la plantilla de webhook que mejor se adapte a sus necesidades. Cada plantilla tiene un tipo de autenticación diferente.

Plantillas de webhook de chat

  • Enviar alertas de webhook a un chat
  • Enviar alertas de webhook de personas específicas a un chat
  • Enviar alertas de webhook de personas de una organización a un chat

Plantillas de webhook de canal

  • Enviar alertas de webhook a un canal
  • Enviar alertas de webhook de personas específicas a un canal
  • Enviar alertas de webhook de personas de una organización a un canal

Aplicación Flujos de trabajo en vista de canal

Nota

La plantilla de webhook Publicar en un chat cuando se recibe una solicitud de webhook puede no estar disponible en función del tipo de organización. Para obtener más ayuda, póngase en contacto con su administrador de TI.

Una vez abierto el flujo de trabajo, puede cambiar su nombre.

También tendrá que autenticarse con su cuenta para que sus flujos de trabajo se publiquen en el canal o el chat. Si desea elegir una cuenta diferente con la que autenticarse, seleccione Cambiar cuentaIcono de más opciones de Microsoft Teams y elija la cuenta que desea usar.

Cuando haya terminado de actualizar el nombre y haya autenticado la cuenta correcta, seleccione Siguiente.

Configuración de plantilla de webhook

En la siguiente página, podrá elegir el equipo, el canal o el chat en el que se publicará esta notificación. Tenga en cuenta que si usa este flujo de trabajo desde un chat o canal, estos campos se rellenarán automáticamente. Después de rellenar los detalles necesarios, seleccione Agregar flujo de trabajo.

Una vez creado el flujo de trabajo, verá un nuevo cuadro de diálogo con la dirección URL que puede copiar.

Botón de copia de url de webhook

Si alguna vez necesita volver a copiar la dirección URL del flujo de trabajo, podrá encontrarla abriendo la aplicación Flujos de trabajo en Teams, seleccionando el flujo de trabajo que se creó, seleccionando Editaricono Editar y expandiendo el desencadenador Cuando se recibe una solicitud de webhook de Teams.

Copiar la dirección URL del webhook en la página de detalles del flujo

Configurar un flujo de trabajo entrante de webhook desde cero

Captura de pantalla que muestra dónde buscar plantillas en blanco para flujos de trabajo

  1. Seleccione Ver más aplicacionesIcono más opciones de Microsoft Teams en el lado izquierdo de Teams y, a continuación, abra el logotipo de flujo de trabajo deflujos de trabajo.

  2. Vaya a la pestaña Crear y seleccione Crear desde blanco junto a la barra de búsqueda.

  3. Use la barra de búsqueda para buscar el desencadenador Cuando se recibe una solicitud de webhook de Teams y selecciónela.

  4. Elija quién puede desencadenar el flujo (tipo de autenticación). Puede elegir entre tres tipos de autenticación diferentes:

    1. Cualquier persona (esta opción no está autenticada)
    2. Cualquier usuario de mi inquilino
    3. Usuarios específicos de mi espacio empresarial
  5. Ahora tendrá que agregar una acción al flujo de trabajo. Seleccione Nuevo paso y elija la acción Publicar tarjeta en el chat o canal que proviene del conector de Teams. 

  6. Ahora podrá elegir dónde se publica la información del webhook. Seleccione el campo desplegable Publicar en y elija la ubicación. Después de elegir la ubicación del canal, el chat grupal o el chat con flow bot, rellene los demás campos necesarios.

  7. Seleccione Guardar debajo del flujo de trabajo. Una vez guardado, puede volver al cuadro Cuando se recibe un webhook de Teams y copiar la dirección URL de HTTP POST.

Nota

Al configurar el desencadenador de webhook, puede agregar condiciones opcionales. Vaya al icono Menú de desencadenador de Microsoft Teams más opciones y seleccione el botón Configuración . Desplázate hasta la parte inferior y selecciona Agregaricono de cruz en la parte superior de la pantalla en la sección Condiciones de desencadenador . Este paso es opcional y no es necesario para que el flujo de trabajo se ejecute.

Más información

Documentación del desarrollador del conector webhook de Teams

Examinar y agregar flujos de trabajo en Microsoft Teams

     Agregar o ejecutar un flujo de trabajo desde un mensaje