Créer un webhook sortant

Le webhook sortant agit comme un bot et recherche des messages dans les canaux à **l’aide de @mention**. Il envoie des notifications aux services web externes et répond par des messages enrichis, qui incluent des cartes et des images. Cela permet d’ignorer le processus de création de bots via le Microsoft Bot Framework.

Fonctionnalités clés du webhook sortant

Le tableau suivant fournit les fonctionnalités et la description des webhooks sortants :

Fonctionnalités Description
Configuration limitée Les webhooks sont limitées au niveau de l’équipe. Le processus de mise en place obligatoire pour chaque application ajoute un webhook sortant.
Messagerie réactive Les utilisateurs doivent utiliser @mention pour que le webhook reçoit des messages. Actuellement, les utilisateurs peuvent uniquement envoyer un webhook sortant dans les canaux publics et non dans l’étendue personnelle ou privée.
Échange de messages HTTP standard Les réponses apparaissent dans la même chaîne que le message de demande d’origine et peuvent inclure n’importe quel contenu de message Bot Framework, par exemple du texte enrichi, des images, des cartes et des emojis. Bien que les webhooks sortants peuvent utiliser des cartes, ils ne peuvent pas utiliser d’actions de carte à l’exception de openURL .
Teams Prise en charge des méthodes d’API Les webhooks sortants envoient une demande HTTP POST à un service web et renvoient une réponse. Ils ne peuvent pas accéder à d’autres API, telles que la récupération de la liste de la liste ou de la liste des canaux d’une équipe.

Créer des webhooks sortants

Créez des webhooks sortants et ajoutez des bots personnalisés à Teams.

Pour créer un webhook sortant

  1. Sélectionnez Teams dans le volet gauche. La page Teams’affiche :

    Canal Teams

  2. Dans la page Teams, sélectionnez l’équipe requise pour créer un webhook sortant et sélectionnez le •••. Dans le menu déroulant, sélectionnez Gérer l’équipe:

    Créer un webhook sortant

  3. Sélectionnez l’onglet Applications sur la page de canal :

    Créer un webhook sortant

  4. Sélectionnez Créer un webhook sortant:

    Créer des webhooks sortants

  5. Tapez les détails suivants dans la page Créer un webhook sortant :

    • Nom: titre du webhook et onglet @mention webhook.
    • URL de rappel: point de terminaison HTTPS qui accepte les charges utiles JSON et reçoit les demandes POST de Teams.
    • Description: chaîne détaillée qui apparaît dans la carte de visite et le tableau de bord de l’application au niveau de l’équipe.
    • Image de profil : icône d’application pour votre webhook, qui est facultative.
  6. Sélectionnez Créer. Le webhook sortant est ajouté au canal de l’équipe actuelle :

    créer un webhook sortant

Une boîte de dialogue HMAC (Message Authentication Code) basée sur le hachage s’affiche. Il s’agit d’un jeton de sécurité utilisé pour authentifier les appels entre Teams et le service extérieur désigné.

Notes

Le webhook sortant est disponible pour les utilisateurs de l’équipe, uniquement si l’URL est valide et que les jetons d’authentification du serveur et du client sont égaux. Par exemple, une poignée de main HMAC.

Le scénario suivant fournit les détails pour ajouter un webhook sortant :

  • Scénario : envoyer des notifications d’état de modification sur Teams serveur de base de données de canal vers votre application.
  • Exemple : vous avez une application métier qui suit toutes les opérations CRUD, telles que créer, lire, mettre à jour et supprimer. Ces opérations sont réalisées sur les enregistrements des employés par Teams utilisateurs RH de canal au sein d’Office 365 location.

Créer une URL sur le serveur de votre application pour accepter et traiter une demande POST avec une charge utile JSON

Votre service reçoit des messages dans un schéma de messagerie de service de bot Azure standard. Le connecteur Bot Framework est un service RESTful qui permet de traiter l’échange de messages au format JSON via des protocoles HTTPS, comme documenté dans l’API Azure Bot Service. Vous pouvez également suivre le SDK Microsoft Bot Framework pour traiter et parer les messages. Pour plus d’informations, voir vue d’ensemble d’Azure Bot Service.

Les webhooks sortants sont limitées au niveau et team sont visibles par tous les membres de l’équipe. Les utilisateurs @ doivent mentionner le nom du webhook sortant pour l’appeler dans le canal.

Notes

  • Vous pouvez envoyer des messages de carte adaptative, de carte Hero et de texte en pièce jointe avec le webhook sortant.
  • Les cartes sont en charge de la mise en forme. Pour plus d’informations, voir les cartes de mise en forme avec markdown.

Les codes suivants sont des exemples de réponse de carte adaptative :

string content = await this.Request.Content.ReadAsStringAsync();
Activity incomingActivity = JsonConvert.DeserializeObject<Activity>(content);

var Card = new AdaptiveCard(new AdaptiveSchemaVersion("1.4"))
{
    Body = new List<AdaptiveElement>()
    {
        new AdaptiveTextBlock(){Text= $"Request sent by: {incomingActivity.From.Name}"},
        new AdaptiveImage(){Url=new Uri("https://c.s-microsoft.com/en-us/CMSImages/DesktopContent-04_UPDATED.png?version=43c80870-99dd-7fb1-48c0-59aced085ab6")},
        new AdaptiveTextBlock(){Text="Sample image for Adaptive Card.."}
    }
};

var attachment = new Attachment()
{
    ContentType = AdaptiveCard.ContentType,
    Content = Card
};

var sampleResponseActivity = new Activity
{
    Attachments = new [] { attachment }
};

return sampleResponseActivity;

Exemple de code

Exemple de nom Description .NET Node.js
Webhooks sortants Exemples de création de bots personnalisés à utiliser dans Microsoft Teams. View View

Voir aussi