Envoyer un message de canal

Compatibilité du projet

Windows | Multiplate-forme

Vue d'ensemble (Overview)

Description	méthode API	Chemin d'accès à l'API
Envoyer des messages dans un canal Microsoft Teams avec des pièces jointes SharePoint facultatives.	Publier	/normalized-teams/{team_id}/channels/{channel_id}/messages-v2/drive/items

Entrée

Paramètre	Description	Type de données
ID d'équipe	Identifiant unique de l'équipe. Saisissez le nom de l'équipe pour le récupérer dans la liste déroulante disponible, ou saisissez un ID d'équipe personnalisé. Vous pouvez récupérer l'ID à partir de la sortie de l'activité Obtenir l'équipe par nom .	string
Identifiant du canal	Identifiant unique du canal. Saisissez le nom du canal pour le récupérer dans la liste déroulante disponible, ou saisissez un ID de canal. Vous pouvez récupérer l'ID à partir de la sortie de l'activité Obtenir le canal par nom .	string
Corps du message	Contenu textuel du message	string
Carte JSON adaptative	Charge utile JSON représentant le contenu de la carte adaptative. Remplacez " par ' et supprimez tous les caractères d'échappement qui contiennent '', tels que \n, \r. Par exemple, remplacez \r\n"type" par 'type'. Pour de plus amples informations, consultez la documentation de l'API Microsoft Teams et la documentation relative aux cartes adaptatives.	string
Image	Image de la pièce jointe à inclure dans le message	Fichier
ID de fichier	Un ou plusieurs ID de fichiers Sharepoint à joindre au message. Vous pouvez récupérer cet ID à partir de la sortie des activités Obtenir le fichier ou le dossier ou Charger les fichiers (activités Microsoft 365). Ce champ prend en charge les entrées de type Chaîne.	Tableau de chaînes
ID des mentions	Index de l'entité mentionnée dans le message, un identifiant numérique liant les balises <at> dans le texte du message pour mentionner les entrées. Doit correspondre à l'attribut id dans la balise HTML <at> . Valeurs possibles : 0, 1, 2, etc.	Int32
Mentions mentionnées le type d’identité de l’utilisateur	Type d’identité de l’utilisateur mentionné. Valeurs communes : member, aadUser, onPremiseAadUser, guest. La valeur par défaut pour les membres réguliers de l'équipe est member.	string
Mentions de l’ID utilisateur mentionné	Identifiant unique de l'utilisateur mentionné (identifiant unique de l'utilisateur AAD). Par exemple 74a49af0-e4a2-43d6-9d83-52f5f0.	string
Mentions d’utilisateur mentionné nom complet	Nom complet de l'utilisateur mentionné d'Azure AD. Par exemple John Doe	string
Texte de mention des mentions	Texte utilisé pour mentionner l'utilisateur dans le message. Doit correspondre au texte entre les balises <at> . Par exemple, John Doe.	string

Sortie

Paramètre	Description	Type de données
IDMessage	Identifiant unique du message envoyé	string
URL Web	URL Web du message envoyé	string
Message	Objet de message de canal complet renvoyé par l'API	Objet

Remarque :

• Dans les workflows d’API, un seul objet de réponse est renvoyé en tant que sortie. Tous les champs obligatoires peuvent être extraits directement de cet objet.
• Dans les workflows RPA, certains paramètres de sortie peuvent différer, mais les valeurs nécessaires peuvent toujours être récupérées à partir de l'objet de réponse même s'ils ne sont pas explicitement exposés.

Utilisation de mentions d'utilisateurs

Pour mentionner un utilisateur dans votre message de canal Teams, vous devez configurer à la fois le texte du message et les propriétés des mentions.

Remarque :

La mention des balises n'est actuellement pas prise en charge, vous pouvez uniquement mentionner les utilisateurs.

1. Formatez le texte du message.

Incluez la mention utilisant des balises HTML <at> avec un attribut id :

"Hello <at id=\"0\">John Doe</at>, please review this."

2. Configurez les propriétés des mentions comme dans le tableau suivant.

   Propriété	Valeur (Value)	Description
   ID des mentions	0	Identifiant numérique (incrémentation pour plusieurs mentions)
   Texte de mention des mentions	John Doe	Nom complet indiqué dans la mention
   Mentions d’utilisateur mentionné nom complet	John Doe	Nom complet de l’utilisateur provenant d’Azure AD
   Mentions de l’ID utilisateur mentionné	{AAD Object ID}	ID d'objet Azure AD de l'utilisateur
   Mentions mentionnées le type d’identité de l’utilisateur	Membre	Type d'identité (membre/aadUser/invité)

Pour obtenir l’ ID d’objet Azure AD :

• Portail Azure : accédez à Azure Active Directory > Utilisateurs > {User}> Copier l'ID de l'objet.
• API Microsoft Graph - GET https://graph.microsoft.com/v1.0/users/{userPrincipalName}
• PowerShell - Get-AzureADUser -ObjectId "[e-mail]" | Select ObjectId

Exemple de configuration pour mentionner l'utilisateur « Jane Smith » :

• Texte du message: "Task completed <at id=\"0\">Jane Smith</at>"
• ID des mentions: 0
• Texte de référence des mentions: "Jane Smith"
• Mentions du nom complet de l’utilisateur mentionné: "Jane Smith"
• Mentions de l’ID utilisateur mentionné: "ef1c916a-3135-4417-ba27-8eb7bd084193"
• Mentions mentionnés Type d'identité de l'utilisateur: "member"
  Remarque :

  • Un seul utilisateur peut être mentionné par instance d'activité.
  • Le id dans la balise <at> doit correspondre à la propriété ID de mentions.
  • Un ID d'objet Azure AD incorrect entraînera l'échec de la mention.
  • Assurez-vous que votre bot/application dispose des autorisations nécessaires pour mentionner les utilisateurs sur le canal.