Crear webhooks entrantes
Importante
Los conectores existentes de Microsoft 365 (anteriormente denominados Office 365) en todas las plataformas en la nube 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.
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 e iOS. 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:
En el nuevo cliente de Teams, seleccione Teams y vaya al canal donde desea agregar un webhook entrante.
Seleccione Más opciones ••• en el lado derecho del nombre del canal.
Seleccione Administrar canal.
Seleccione Editar.
Busque Webhook entrante y seleccione Agregar.
Aparece el cuadro de diálogo Webhook entrante.
Seleccione Agregar.
Nota:
Si ya ha agregado un webhook entrante, aparece la opción Configurar . Seleccione Configurar para crear un webhook entrante.
Proporcione un nombre para el webhook y cargue una imagen si es necesario.
Seleccione Crear.
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.
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:
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
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);
Eliminación de webhooks entrantes
Para eliminar un Webhook entrante de un canal de Teams, siga estos pasos:
En nuevo cliente de Teams, seleccione el icono de Teams y vaya al canal donde desea quitar un webhook entrante.
Seleccione Más opciones ••• en el lado derecho del nombre del canal.
Seleccione Administrar canal.
Seleccione Editar.
En el panel izquierdo, seleccione Configurado.
En Webhook entrante, seleccione 1 Configurado.
Haga clic en Administrar.
Seleccione Quitar.
Aparece el cuadro de diálogo Quitar configuración.
Seleccione las casillas necesarias.
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
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