Crear webhook entrante

El webhook entrante permite que cualquier aplicación externa comparta contenido en Teams canales. Estos webhooks se usan como herramientas de seguimiento y notificación. Proporcionan una dirección URL única, a la que se envía una carga JSON con un mensaje en formato de tarjeta. Las tarjetas son contenedores de interfaz de usuario que incluyen contenido y acciones relacionadas con un solo tema. Teams tarjetas dentro de las siguientes funcionalidades:

  • Bots
  • Extensiones de mensajería
  • Conectores

Características clave del webhook entrante

En la tabla siguiente se proporcionan las características y la descripción del webhook entrante:

Características Descripción
Tarjetas adaptables con un webhook entrante Las tarjetas adaptables se pueden enviar a través de webhooks entrantes. Para obtener más información, vea Enviar tarjetas adaptables mediante webhooks entrantes.
Compatibilidad con mensajes que se pueden tomar medidas Las tarjetas de mensaje que pueden actuar se admiten en todos Office 365 grupos, incluidos Teams. Si envía mensajes a través de tarjetas, debe usar el formato de tarjeta de mensaje que se puede usar. Para obtener más información, vea referencia de tarjeta de mensaje heredada y área de juegos de tarjetas de mensaje.
Compatibilidad con mensajería HTTPS independiente Las tarjetas proporcionan información de forma clara y coherente. Cualquier herramienta o marco que pueda enviar solicitudes HTTPS POST puede enviar mensajes a Teams a través de un webhook entrante.
Compatibilidad con Markdown Todos los campos de texto de las tarjetas de mensajería que pueden actuar admiten Markdown básico. No use el marcado HTML en las tarjetas. puesto que se omite y se trata como texto sin formato.
Configuración con ámbito El webhook entrante está en el ámbito y configurado en el nivel de canal.
Definiciones de recursos seguros Los mensajes tienen formato de carga JSON. Esta estructura de mensajería declarativa impide la inserción de código malintencionado.

Nota

  • Teams bots, extensiones de mensajería, Webhook entrante y Bot Framework admiten tarjetas adaptables. Las tarjetas adaptables son un marco abierto entre plataformas que se puede usar en todas las plataformas, como Windows, Android, iOS, y así sucesivamente. Actualmente, Teams conectores no admiten tarjetas adaptables. Sin embargo, es posible crear un flujo que publica tarjetas adaptables en un Teams canal.
  • Para obtener más información sobre tarjetas y webhooks, vea Adaptive cards and Incoming Webhooks.

Crear webhook entrante

Para agregar un webhook entrante a un canal Teams entrada

  1. Vaya al canal donde desea agregar el webhook y seleccione ••• Más opciones de la barra de navegación superior.

  2. Seleccione Conectores en el menú desplegable:

    Seleccionar conector

  3. Busque Webhook entrante y seleccione Agregar.

  4. Seleccione Configurar, proporcione un nombre y cargue una imagen para el webhook si es necesario:

    Botón Configurar

  5. La ventana de diálogo presenta una dirección URL única que se asigna al canal. Copie y guarde la dirección URL del webhook, para enviar información a Microsoft Teams y seleccione Listo:

    DIRECCIÓN URL única

El webhook está disponible en el canal Teams web.

Nota

En Teams, seleccione Configuración Permisos de miembro Permitir a los miembros crear, actualizar y quitar conectores, de modo que cualquier miembro del equipo pueda agregar, modificar o eliminar > > un conector.

Quitar webhook entrante

Para quitar un webhook entrante de un canal Teams entrada

  1. Vaya al canal.

  2. Seleccione ••• más opciones en la barra de navegación superior.

  3. Seleccione Conectores en el menú desplegable.

  4. A la izquierda, en Administrar, seleccione Configurado.

  5. Seleccione el < 1> configurado para ver una lista de los conectores actuales:

    Webhook configurado

  6. Seleccione Administrar junto al conector que desea quitar:

    Administrar webhook

  7. Seleccione Quitar:

    Quitar webhook

    Aparece el cuadro de diálogo Quitar configuración:

    Quitar configuración

  8. Complete los campos y casillas del cuadro de diálogo y seleccione Quitar:

    Eliminación final

    El webhook se quita del Teams canal.

Vea también