Crear webhooks entrantes

Un webhook entrante permite a las aplicaciones externas compartir contenido en canales de Microsoft Teams. Los webhooks se utilizan como herramientas de seguimiento y notificación. Los webhooks proporcionan una dirección URL única para enviar 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 artículo. Puede usar las tarjetas en las siguientes funciones:

• Bots
• Extensiones de mensajería
• Conectores

Nota:

• El límite de tamaño del mensaje es de 28 KB. Cuando el tamaño supera los 28 KB, recibirá un error. Para obtener más información, consulte Límites y especificaciones de Microsoft Teams.
• Si se realizan más de cuatro solicitudes en un segundo, la conexión de cliente se limita hasta que la ventana se actualiza mientras dure la tasa fija. Una lógica de reintento con retroceso exponencial puede mitigar la limitación de velocidad en los casos en los que las solicitudes superan los límites en un segundo. Para evitar alcanzar los límites de velocidad, consulte Respuestas HTTP 429.

Características clave de los webhooks entrantes

La siguiente tabla proporciona las características y la descripción de un Webhook entrante:

Características	Descripción
Tarjetas adaptables mediante 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 mensajería accionable	Las tarjetas de mensaje accionables se admiten en todos los grupos de Microsoft 365, incluidos Teams. Si envía mensajes a través de tarjetas, debe usar el formato de tarjeta de mensaje accionable. Para obtener más información, vea Referencia de tarjeta de mensaje accionable 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 accionables admiten Markdown básico. No use el formato HTML en las tarjetas, puesto que se omite y se trata como texto sin formato.
Configuración con ámbito	Un webhook entrante tiene el ámbito y se configura en el nivel de canal.
Protección de definiciones de recursos	Los mensajes tienen formato de cargas JSON. Esta estructura de mensajería declarativa impide la inserción de código malintencionado.

Nota:

• Los bots de Teams, las extensiones de mensajería, el Webhook entrante y el soporte de Bot Framework admiten Tarjetas adaptables. La tarjeta adaptable es un marco abierto de plataforma multiplataforma que se usa en todas las plataformas, como Windows, Android, iOS, etc. Actualmente, los conectores de Teams no admiten Tarjetas adaptables. Sin embargo, es posible crear un flujo que publique Tarjetas adaptables en un canal de Teams.
• Para obtener más información sobre tarjetas y webhooks, vea tarjetas adaptables y Webhooks entrantes.

Crear un webhook entrante

Para agregar un Webhook entrante a un canal de Teams, siga estos pasos:

Nuevo Teams

1. En el nuevo cliente de Teams, seleccione Teams y vaya al canal donde desea agregar un webhook entrante.

2. Seleccione Más opciones ••• en el lado derecho del nombre del canal.

3. Seleccione Administrar canal.

   

4. Seleccione Editar.

   

5. Busque Webhook entrante y seleccione Agregar.

   

   Aparece el cuadro de diálogo Webhook entrante.

6. Seleccione Agregar.

   

   Nota:

   Si ya ha agregado un webhook entrante, aparece la opción Configurar . Seleccione Configurar para crear un webhook entrante.

7. Proporcione un nombre para el webhook y cargue una imagen si es necesario.

8. Seleccione Crear.

   

9. Copie y guarde la dirección URL de webhook única presente en el cuadro de diálogo. La URL se asigna al canal y se puede utilizar para enviar información a los equipos.

10. Seleccione Listo. El webhook ya está disponible en el canal de Teams.

    

La siguiente representación gráfica proporciona los pasos para crear un webhook entrante:

Teams clásico

1. En el cliente de Teams clásico, seleccione Teams y vaya al canal donde desea agregar un webhook entrante.

2. Seleccione Más opciones ••• en la esquina superior derecha.

3. Seleccione Conectores en el menú desplegable.

   

4. Busque Webhook entrante y seleccione Agregar.

   

   Aparece el cuadro de diálogo Webhook entrante.

5. Seleccione Agregar.

   

   Nota:

   Si ya ha agregado un webhook entrante, aparece la opción Configurar . Seleccione Configurar para crear un webhook entrante.

6. Proporcione un nombre para el webhook y cargue una imagen si es necesario.

7. Seleccione Crear.

   

8. Copie y guarde la dirección URL de webhook única presente en el cuadro de diálogo. La URL se asigna al canal y se puede utilizar para enviar información a los equipos.

9. Seleccione Listo.

   

El webhook ya está disponible en el canal de Teams.

Importante

Puede crear una aplicación de Teams del bot de notificación mediante el kit de herramientas de Teams que no sea un webhook entrante. Se realizan de forma similar, pero el bot de notificación tiene más funcionalidades. Para obtener más información, consulte Compilación de un bot de notificación con JavaScript o un ejemplo de notificación de webhook entrante.

Puede crear y enviar mensajes accionables a través de un webhook o conector entrante para Grupos de Microsoft 365. Para obtener más información, consulte Creación y envío de mensajes.

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.

Ejemplo

C#

Referencia de código de ejemplo

var adaptiveCardJson = @"{
  ""type"": ""message"",
  ""attachments"": [
    {
      ""contentType"": ""application/vnd.microsoft.card.adaptive"",
      ""content"": {
        ""type"": ""AdaptiveCard"",
        ""body"": [
          {
            ""type"": ""TextBlock"",
            ""text"": ""Message Text""
          }
        ],
        ""$schema"": ""http://adaptivecards.io/schemas/adaptive-card.json"",
        ""version"": ""1.0""
      }
    }
  ]
}";

var webhookUrl = "https://xxxxx.webhook.office.com/xxxxxxxxx";

var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var content = new StringContent(adaptiveCardJson, System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync(webhookUrl, content);

JavaScript

Referencia de código de ejemplo

var formatted_Card_Payload = {
        "type": "message",
        "attachments": [
            {
                "contentType": "application/vnd.microsoft.card.adaptive",
                "contentUrl": null,
                "content": {
                    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
                    "type": "AdaptiveCard",
                    "version": "1.2",
                    "body": [
                        {
                            "type": "TextBlock",
                            "text": "Submitted response:"+ response
                        }
                    ]
                }
            }
        ]
    }

var webhookUrl = "https://xxxxx.webhook.office.com/xxxxxxxxx";

axios.post(webhookUrl , formatted_Card_Payload )
    .then(res => {
        console.log(`statusCode: ${res.status}`)
        console.log(res)
    })
    .catch(error => {
        console.error(error)
    })

Eliminación de webhooks entrantes

Para eliminar un Webhook entrante de un canal de Teams, siga estos pasos:

Nuevo Teams

1. En nuevo cliente de Teams, seleccione el icono de Teams y vaya al canal donde desea quitar un webhook entrante.

2. Seleccione Más opciones ••• en el lado derecho del nombre del canal.

3. Seleccione Administrar canal.

   

4. Seleccione Editar.

   

5. En el panel izquierdo, seleccione Configurado.

6. En Webhook entrante, seleccione 1 Configurado.

   

7. Haga clic en Administrar.

   

8. Seleccione Quitar.

   

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

9. Seleccione las casillas necesarias.

10. Seleccione Quitar.

    

El webhook ahora se quita del canal de Teams.

Teams clásico

1. En el cliente de Teams clásico, seleccione el icono de Teams y vaya al canal donde desea quitar un webhook entrante.

2. Seleccione Más opciones ••• en la esquina superior derecha.

3. Seleccione Conectores en el menú desplegable.

4. En el panel izquierdo, seleccione Configurado.

5. En Webhook entrante, seleccione 1 Configurado.

   

6. Haga clic en Administrar.

   

7. Seleccione Quitar.

   

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

8. Seleccione las casillas necesarias.

9. Seleccione Quitar.

   

El webhook ahora se quita del canal de Teams.

Ejemplo de código

Ejemplo de nombre	Descripción	.NET	Node.js
Webhook entrante	En este ejemplo se muestra cómo implementar y usar un webhook entrante.	View	Ver

Consulte también

• Crear webhooks salientes
• Crear bots para Teams
• Extensiones de mensajes
• Integrar aplicaciones web
• Compartir en Teams desde aplicaciones web