Slack
Slack est un outil de communication d’équipe qui rassemble toutes vos communications d’équipe à un seul endroit, pouvant faire l’objet d’une recherche instantanée et disponibles partout où vous allez.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Norme | Toutes les régions Power Apps , à l’exception des suivantes : - China Cloud géré par 21Vianet |
| Power Automate | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Contact | |
|---|---|
| Nom | Microsoft |
| URL | https://support.microsoft.com/contactus |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Site internet | https://slack.com/ |
| Politique de confidentialité | https://slack.com/privacy-policy |
| Categories | Collaboration; Communication |
Problèmes connus et limitations
Conformément à la documentation de l’API Slack, certaines méthodes d’API Slack utilisées par le connecteur cesseront de fonctionner en février 2021 et ne fonctionneront pas avec les applications nouvellement créées après le 10 juin 2020. Utilisez donc les dernières versions des actions ci-dessous.
Actions :
Créer un groupe est déconseillé, utilisez la dernière version de Créer un canal pour créer des canaux privés.
Le nombre maximal de caractères dans un message est limité à 4 000. Pour plus d’informations, reportez-vous à la documentation officielle de Slack.
Connecteur en profondeur
Pour plus d’informations sur le connecteur, consultez la section détaillée.
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
| Fréquence des sondages déclencheurs | 1 | 120 secondes |
Actions
| Créer un canal |
Créez un canal dans Slack. |
| Créer un canal [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt Créer un canal .
|
| Créer un groupe [DÉCONSEILLÉ] |
Crée un groupe dans Slack. |
| Définir ne pas déranger |
Définissez l’état ne pas déranger pour l’utilisateur. |
| Joindre un canal [DÉPRÉCIÉ] |
Cette action a été déconseillée. Utilisez plutôt Rejoindre un canal public .
|
| Lister les réponses aux messages (préversion) |
Répertoriez les réponses dans un thread de message, y compris le message parent. |
| Obtenir un profil utilisateur (préversion) |
Obtenez des informations de profil pour un utilisateur Slack. Utile pour résoudre l’auteur d’un message retourné par les messages de conversation de liste ou les réponses aux messages de liste. |
| Publier un message (V2) |
Cette opération est utilisée pour publier un message sur le canal spécifié. |
| Publier un message [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt Post message (V2).
|
| Rejoindre un canal public |
Rejoignez un canal public dans slack. |
| Répertorier les canaux [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt lister les canaux publics (prise en charge de la pagination).
|
| Répertorier les canaux publics |
Répertoriez les canaux publics en marge. |
| Répertorier les canaux publics (prise en charge de la pagination) (préversion) |
Répertoriez les canaux publics en marge. |
| Répertorier les messages de conversation (préversion) |
Répertoriez les messages publiés dans une conversation (canal public, canal privé, message direct ou message direct de groupe). |
Créer un canal
Créez un canal dans Slack.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom
|
name | string |
Nom du nouveau canal. |
|
|
Est-ce que le canal privé ?
|
is_private | boolean |
Le canal est privé ou non |
Retours
- Corps
- CreateChannel_Response
Créer un canal [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt Créer un canal .
Créez un canal dans Slack.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom
|
name | string |
Nom du nouveau canal. |
Retours
- Corps
- CreateChannel_Response
Créer un groupe [DÉCONSEILLÉ]
Crée un groupe dans Slack.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom
|
name | string |
Nom du groupe. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
group.id | string |
ID du groupe. |
|
Nom
|
group.name | string |
Nom du groupe. |
Définir ne pas déranger
Définissez l’état ne pas déranger pour l’utilisateur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nombre de minutes
|
num_minutes | string |
Nombre de minutes à définir ne pas déranger. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Snooze activé
|
snooze_enabled | boolean |
Indique si la répétition est activée. |
Joindre un canal [DÉPRÉCIÉ]
Cette action a été déconseillée. Utilisez plutôt Rejoindre un canal public .
Rejoignez un canal dans slack.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom
|
name | string |
Nom du canal. |
Retours
- Corps
- JoinChannel_Response
Lister les réponses aux messages (préversion)
Répertoriez les réponses dans un thread de message, y compris le message parent.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de la conversation
|
channel | True | string |
Conversation contenant le thread. |
|
Horodatage du message parent
|
ts | True | string |
Horodatage du message parent qui démarre le thread. Disponible en tant que |
|
Résultats maximum
|
limit | integer |
Nombre maximal de messages à retourner par page. |
|
|
Horodatage le plus ancien
|
oldest | string |
Seuls les messages après cet horodatage Unix seront inclus dans les résultats. |
|
|
Horodatage le plus récent
|
latest | string |
Seuls les messages avant cet horodatage Unix seront inclus dans les résultats. |
|
|
Conversation complète
|
inclusive | boolean |
Incluez des messages avec les horodatages les plus anciens ou les plus récents dans les résultats. |
Retours
- Corps
- ListMessages_Response
Obtenir un profil utilisateur (préversion)
Obtenez des informations de profil pour un utilisateur Slack. Utile pour résoudre l’auteur d’un message retourné par les messages de conversation de liste ou les réponses aux messages de liste.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identifiant utilisateur
|
user | True | string |
ID de l’utilisateur pour lequel obtenir des informations de profil. |
Retours
- Corps
- GetUserProfile_Response
Publier un message (V2)
Cette opération est utilisée pour publier un message sur le canal spécifié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom du canal
|
channel | True | string |
Canal, groupe privé ou canal de messagerie instantanée vers lequel envoyer un message. Il peut s’agir d’un nom(ex : #general) ou d’un ID encodé. |
|
Texte du message
|
text | True | string |
Corps du message à envoyer. L’API Slack tronque les messages contenant plus de 40 000 caractères. Pour connaître les options de mise en forme, consultez https://api.slack.com/docs/formatting |
|
Horodatage du message parent
|
thread_ts | string |
Horodatage du message parent lors de la publication d’une réponse dans un thread. |
|
|
Diffusion vers le canal
|
reply_broadcast | boolean |
Transmettez true pour envoyer également une réponse threadée au canal. |
|
|
Nom du bot
|
username | string |
Nom du bot. |
|
|
Publier en tant qu’utilisateur
|
as_user | boolean |
Transmettez true pour publier le message en tant qu’utilisateur authentifié, au lieu d’un bot. |
|
|
Mode d’analyse
|
parse | string |
Modifiez la façon dont les messages sont traités. Pour plus d’informations, consultez https://api.slack.com/docs/formatting |
|
|
Analyse de balisage Slack
|
mrkdwn | boolean |
Paramètre d’analyse de balisage Slack. Option activée par défaut. |
|
|
Noms de liens
|
link_names | integer |
Rechercher et lier des noms d’utilisateur et des noms d’utilisateur de canal. |
|
|
Dissocier les liens
|
unfurl_links | boolean |
Passez la valeur true pour activer le défurlage du contenu principalement basé sur du texte. |
|
|
Unfurl Media
|
unfurl_media | boolean |
Transmettez false pour désactiver le déploiement du contenu multimédia. |
|
|
URL de l’icône
|
icon_url | uri |
URL d’une image à utiliser comme icône pour ce message. |
|
|
Icône Emoji
|
icon_emoji | string |
Emoji à utiliser comme icône pour ce message. |
Retours
Détails du message publié sur un canal Slack.
- Corps
- PostMessageResponse
Publier un message [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt Post message (V2).
Cette opération est utilisée pour publier un message sur le canal spécifié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom du canal
|
channel | True | string |
Canal, groupe privé ou canal de messagerie instantanée vers lequel envoyer un message. Il peut s’agir d’un nom(ex : #general) ou d’un ID encodé. |
|
Texte du message
|
text | True | string |
Corps du message à envoyer (moins de 4 000 caractères). Pour connaître les options de mise en forme, consultez https://api.slack.com/docs/formatting. |
|
Nom du bot
|
username | string |
Nom du bot. |
|
|
Publier en tant qu’utilisateur
|
as_user | boolean |
Transmettez true pour publier le message en tant qu’utilisateur authentifié, au lieu d’un bot. |
|
|
Mode d’analyse
|
parse | string |
Modifiez la façon dont les messages sont traités. Pour plus d’informations, consultez https://api.slack.com/docs/formatting. |
|
|
Noms de liens
|
link_names | integer |
Rechercher et lier des noms d’utilisateur et des noms d’utilisateur de canal. |
|
|
Dissocier les liens
|
unfurl_links | boolean |
Passez la valeur true pour activer le défurlage du contenu principalement basé sur du texte. |
|
|
Unfurl Media
|
unfurl_media | boolean |
Transmettez false pour désactiver le déploiement du contenu multimédia. |
|
|
URL de l’icône
|
icon_url | uri |
URL d’une image à utiliser comme icône pour ce message. |
|
|
Icône Emoji
|
icon_emoji | string |
Emoji à utiliser comme icône pour ce message. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Résultat de la réussite
|
ok | boolean |
Indique si l’opération a réussi. |
|
Canal
|
channel | string |
Canal dans lequel le message a été publié. |
|
Création de Date-Time
|
ts | string |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Texte du message
|
message.text | string |
Corps du message. |
|
ID message
|
message.id | string |
Identificateur unique du message. |
|
ID du créateur
|
message.user | string |
Identificateur unique de l’utilisateur qui a publié le message. |
|
Heure de création
|
message.created | integer |
Horodatage Unix pour le moment où le message est créé. |
|
Est supprimé
|
message.is_user-deleted | boolean |
Indique si le message a été supprimé ou non. |
|
Messages d’erreur
|
error | string |
Détails des messages d’erreur, le cas échéant. |
Rejoindre un canal public
Rejoignez un canal public dans slack.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom du canal
|
channel | string |
Nom du canal. |
Retours
- Corps
- JoinChannel_ResponseV2
Répertorier les canaux [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt lister les canaux publics (prise en charge de la pagination).
Répertoriez les canaux en marge.
Retours
- Corps
- ListChannels_Response
Répertorier les canaux publics
Répertoriez les canaux publics en marge.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Conversation Types
|
types | string |
Types de conversation séparés par des virgules à inclure. La valeur par défaut est public_channel. Incluez explicitement private_channel, im ou mpim pour répertorier d’autres types de conversation. |
|
|
Exclure l’archivage
|
exclude_archived | boolean |
Définissez la valeur true pour exclure les conversations archivées. |
|
|
Résultats maximum
|
limit | integer |
Nombre maximal de conversations à retourner. |
|
|
ID d’équipe
|
team_id | string |
ID d’équipe encodé. Obligatoire uniquement pour un jeton à l’échelle de l’organisation. |
|
|
Cursor
|
cursor | string |
Curseur de pagination retourné par la requête précédente. |
Retours
- Corps
- ListChannels_Response
Répertorier les canaux publics (prise en charge de la pagination) (préversion)
Répertorier les messages de conversation (préversion)
Répertoriez les messages publiés dans une conversation (canal public, canal privé, message direct ou message direct de groupe).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de la conversation
|
channel | True | string |
Conversation à partir de laquelle récupérer des messages. |
|
Résultats maximum
|
limit | integer |
Nombre maximal de messages à retourner par page. |
|
|
Horodatage le plus ancien
|
oldest | string |
Seuls les messages après cet horodatage Unix seront inclus dans les résultats. |
|
|
Horodatage le plus récent
|
latest | string |
Seuls les messages avant cet horodatage Unix seront inclus dans les résultats. |
|
|
Conversation complète
|
inclusive | boolean |
Incluez des messages avec les horodatages les plus anciens ou les plus récents dans les résultats. |
|
|
Inclure toutes les métadonnées
|
include_all_metadata | boolean |
Retourne toutes les métadonnées associées à chaque message. |
Retours
- Corps
- ListMessages_Response
Déclencheurs
| Lorsqu’un fichier est créé |
Lorsqu’un fichier est créé |
Lorsqu’un fichier est créé
Lorsqu’un fichier est créé
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Canal
|
channel | True | string |
Nom du canal. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
ID du fichier |
|
Créé
|
created | integer |
Lorsque le fichier a été créé. |
|
Nom
|
name | string |
Le nom du fichier. |
|
Titre
|
title | string |
Titre du fichier. |
Définitions
Canal
Canal
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
ID du canal. |
|
Nom
|
name | string |
Nom du canal. |
|
Canal public
|
is_channel | boolean |
Indique si cette conversation est un canal public. |
|
Canal privé
|
is_group | boolean |
Indique si cette conversation est un canal privé. |
|
Is Direct Message
|
is_im | boolean |
Indique si cette conversation est un message direct entre deux utilisateurs. |
|
Message direct de groupe
|
is_mpim | boolean |
Indique si cette conversation est un message direct de groupe. |
|
Est privé
|
is_private | boolean |
Indique si cette conversation est privée. |
|
Est archivé
|
is_archived | boolean |
Indique si cette conversation a été archivée. |
|
Membre
|
is_member | boolean |
Indique si l’utilisateur authentifié est membre de cette conversation. |
|
Identifiant utilisateur
|
user | string |
Pour les messages directs, l’ID de l’autre utilisateur dans la conversation. |
|
Nombre de membres
|
num_members | integer |
Nombre de membres dans cette conversation. |
ListChannels_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
channels
|
channels | array of Channel | |
|
Curseur suivant
|
response_metadata.next_cursor | string |
Curseur à passer à la requête suivante. Vide lorsqu’il n’y a plus de résultats. |
ListChannels_ResponseV3
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
value
|
value | array of Channel |
SlackMessage
Message publié dans une conversation Slack.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID message
|
ts | string |
Identificateur d’horodatage unique du message. |
|
ID de l’auteur
|
user | string |
ID de l’utilisateur qui a publié le message. Utilisez obtenir le profil utilisateur pour résoudre ce problème pour un utilisateur. |
|
Texte du message
|
text | string |
Corps du message. |
|
Type de message
|
type | string |
Type du message. |
|
Thread Id
|
thread_ts | string |
Horodatage du message parent, si ce message fait partie d’un thread. |
|
Nombre de réponses
|
reply_count | integer |
Nombre de réponses à ce message, s’il démarre un thread. |
ListMessages_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
value
|
value | array of SlackMessage |
SlackUserProfile
Détails de profil supplémentaires pour un utilisateur Slack.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nom d’affichage
|
display_name | string |
Nom complet choisi par l’utilisateur pour son profil. |
|
Vrai nom
|
real_name | string |
Prénom et nom de l’utilisateur. |
|
Messagerie électronique
|
string |
Adresse de messagerie de l’utilisateur. |
|
|
URL de l’avatar
|
image_72 | string |
URL d’une version de 72 x 72 pixels de l’avatar de l’utilisateur. |
SlackUser
Un utilisateur Slack.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
ID de l’utilisateur. |
|
Nom d’utilisateur
|
name | string |
Nom d’utilisateur Slack de l’utilisateur. |
|
Vrai nom
|
real_name | string |
Prénom et nom de l’utilisateur. |
|
Is Bot
|
is_bot | boolean |
Indique si l’utilisateur est un bot. |
|
Est désactivé
|
deleted | boolean |
Indique si le compte de l’utilisateur a été désactivé. |
|
Fuseau horaire
|
tz | string |
Fuseau horaire lisible de l’utilisateur. |
|
Profile
|
profile | SlackUserProfile |
Détails de profil supplémentaires pour un utilisateur Slack. |
GetUserProfile_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Résultat de la réussite
|
ok | boolean |
Indique si l’opération a réussi. |
|
Utilisateur
|
user | SlackUser |
Un utilisateur Slack. |
|
Messages d’erreur
|
error | string |
Détails des messages d’erreur, le cas échéant. |
CreateChannel_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Canal
|
channel | Channel |
Canal |
JoinChannel_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Déjà dans le canal
|
already_in_channel | boolean |
Indique si l’utilisateur est déjà dans le canal ou non. |
|
Canal
|
channel | Channel |
Canal |
JoinChannel_ResponseV2
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Canal
|
channel | Channel |
Canal |
|
Avertissement
|
warning | string |
Indique si l’utilisateur est déjà dans le canal ou non. |
PostMessageResponse
Détails du message publié sur un canal Slack.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Résultat de la réussite
|
ok | boolean |
Indique si l’opération a réussi. |
|
Canal
|
channel | string |
Canal dans lequel le message a été publié. |
|
Heure de création
|
ts | string |
Horodatage Unix pour lequel le message a été créé. |
|
Type de message
|
message.type | string |
Type du message. |
|
Texte du message
|
message.text | string |
Corps du message. |
|
Heure de création
|
message.ts | string |
Horodatage Unix pour lequel le message a été créé. |
|
Messages d’erreur
|
error | string |
Détails des messages d’erreur, le cas échéant. |