Slack
Slack ist ein Tool für die Teamkommunikation, das alle Ihre Teamkommunikation an einem zentralen Ort vereint, sofort durchsuchbar und überall verfügbar ist.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - China Cloud betrieben von 21Vianet |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Norm | Alle Power Apps-Regionen mit Ausnahme der folgenden: - China Cloud betrieben von 21Vianet |
| Power Automate | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - China Cloud betrieben von 21Vianet |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL | https://support.microsoft.com/contactus |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
| Webseite | https://slack.com/ |
| Datenschutzrichtlinie | https://slack.com/privacy-policy |
| Kategorien | Zusammenarbeit; Kommunikation |
Bekannte Probleme und Einschränkungen
Gemäß der Slack-API-Dokumentation funktionieren einige Slack-API-Methoden, die der Connector verwendet, im Februar 2021 nicht mehr und funktioniert nach dem 10. Juni 2020 nicht mehr mit neu erstellten Apps. Bitte verwenden Sie daher die neuesten Versionen der folgenden Aktionen.
Aktionen:
Die Erstellung einer Gruppe ist veraltet. Verwenden Sie die neueste Version von "Kanal erstellen", um private Kanäle zu erstellen.
Die maximale Anzahl von Zeichen in einer Nachricht ist auf 4000 begrenzt. Weitere Informationen finden Sie in der offiziellen Dokumentation von Slack.
Verbinder im Detail
Weitere Informationen zum Verbinder finden Sie im ausführlichen Abschnitt.
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
| Häufigkeit der Triggerumfragen | 1 | 120 Sekunden |
Aktionen
| "Nicht stören" festlegen |
Legen Sie den Status "Nicht stören" für den Benutzer fest. |
| Antworten auf Nachrichten auflisten (Vorschau) |
Auflisten der Antworten in einem Nachrichtenthread, einschließlich der übergeordneten Nachricht. |
| Beitreten zu einem Kanal [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen einen öffentlichen Kanal .
|
| Benutzerprofil abrufen (Vorschau) |
Abrufen von Profilinformationen für einen Slack-Benutzer. Nützlich zum Auflösen des Autors einer Nachricht, die von Listenunterhaltungsnachrichten oder Antworten auf Nachrichten auflisten zurückgegeben wird. |
| Einem öffentlichen Kanal beitreten |
Treten Sie einem öffentlichen Kanal in Pufferzeit bei. |
| Erstellen einer Gruppe [VERALTET] |
Erstellt eine Gruppe in Pufferzeit. |
| Erstellen eines Kanals |
Erstellen Sie einen Kanal in Pufferzeit. |
| Erstellen eines Kanals [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen " Kanal erstellen" .
|
| Kanäle auflisten [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Öffentliche Kanäle auflisten" (Paginierungsunterstützung).
|
| Nachricht posten (V2) |
Dieser Vorgang wird verwendet, um eine Nachricht an den angegebenen Kanal zu posten. |
| Nachricht posten [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen post message (V2).
|
| Unterhaltungsnachrichten auflisten (Vorschau) |
Auflisten der in einer Unterhaltung geposteten Nachrichten (öffentlicher Kanal, privater Kanal, direkte Nachricht oder Direkte Gruppennachricht). |
| Öffentliche Kanäle auflisten |
Listet die öffentlichen Kanäle in Pufferzeit auf. |
| Öffentliche Kanäle auflisten (Paginierungsunterstützung) (Vorschau) |
Listet die öffentlichen Kanäle in Pufferzeit auf. |
"Nicht stören" festlegen
Legen Sie den Status "Nicht stören" für den Benutzer fest.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Anzahl der Minuten.
|
num_minutes | string |
Die Anzahl der festzulegenden Minuten wird nicht gestört. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Erneutes Erinnern aktiviert
|
snooze_enabled | boolean |
Gibt an, ob das Erneute Erinnern aktiviert ist. |
Antworten auf Nachrichten auflisten (Vorschau)
Auflisten der Antworten in einem Nachrichtenthread, einschließlich der übergeordneten Nachricht.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Unterhaltungs-ID
|
channel | True | string |
Die Unterhaltung, die den Thread enthält. |
|
Zeitstempel der übergeordneten Nachricht
|
ts | True | string |
Zeitstempel der übergeordneten Nachricht, die den Thread startet. Verfügbar als Feld für eine Nachricht, die |
|
Maximale Ergebnisse
|
limit | integer |
Die maximale Anzahl von Nachrichten, die pro Seite zurückgegeben werden sollen. |
|
|
Ältester Zeitstempel
|
oldest | string |
Nur Nachrichten nach diesem Unix-Zeitstempel werden in die Ergebnisse aufgenommen. |
|
|
Neuester Zeitstempel
|
latest | string |
Nur Nachrichten vor diesem Unix-Zeitstempel werden in die Ergebnisse einbezogen. |
|
|
Inklusiv
|
inclusive | boolean |
Schließen Sie Nachrichten mit den ältesten oder neuesten Zeitstempeln in die Ergebnisse ein. |
Gibt zurück
Beitreten zu einem Kanal [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen einen öffentlichen Kanal .
Treten Sie einem Kanal in Pufferzeit bei.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
name | string |
Der Name des Kanals. |
Gibt zurück
- Body
- JoinChannel_Response
Benutzerprofil abrufen (Vorschau)
Abrufen von Profilinformationen für einen Slack-Benutzer. Nützlich zum Auflösen des Autors einer Nachricht, die von Listenunterhaltungsnachrichten oder Antworten auf Nachrichten auflisten zurückgegeben wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
user | True | string |
Die ID des Benutzers, für den Profilinformationen abgerufen werden sollen. |
Gibt zurück
Einem öffentlichen Kanal beitreten
Treten Sie einem öffentlichen Kanal in Pufferzeit bei.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kanalname
|
channel | string |
Der Name des Kanals. |
Gibt zurück
Erstellen einer Gruppe [VERALTET]
Erstellt eine Gruppe in Pufferzeit.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
name | string |
Der Name der Gruppe. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Id
|
group.id | string |
Die ID der Gruppe. |
|
Name
|
group.name | string |
Der Name der Gruppe. |
Erstellen eines Kanals
Erstellen Sie einen Kanal in Pufferzeit.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
name | string |
Der Name des neuen Kanals. |
|
|
Ist der private Kanal?
|
is_private | boolean |
Kanal ist privat oder nicht |
Gibt zurück
Erstellen eines Kanals [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen " Kanal erstellen" .
Erstellen Sie einen Kanal in Pufferzeit.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
name | string |
Der Name des neuen Kanals. |
Gibt zurück
Kanäle auflisten [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Öffentliche Kanäle auflisten" (Paginierungsunterstützung).
Listet die Kanäle in Pufferzeit auf.
Gibt zurück
Nachricht posten (V2)
Dieser Vorgang wird verwendet, um eine Nachricht an den angegebenen Kanal zu posten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kanalname
|
channel | True | string |
Kanal, private Gruppe oder Chatkanal zum Senden von Nachrichten an. Kann ein Name (z. B. #general) oder eine codierte ID sein. |
|
Meldungstext
|
text | True | string |
Textkörper der zu sendenden Nachricht. Die Slack-API schneidet Nachrichten ab, die mehr als 40.000 Zeichen enthalten. Informationen zu Formatierungsoptionen finden Sie unter https://api.slack.com/docs/formatting |
|
Zeitstempel der übergeordneten Nachricht
|
thread_ts | string |
Zeitstempel der übergeordneten Nachricht beim Posten einer Antwort in einem Thread. |
|
|
An Kanal übertragen
|
reply_broadcast | boolean |
Übergeben Sie true, um auch eine Threadantwort an den Kanal zu senden. |
|
|
Botname
|
username | string |
Name des Bots. |
|
|
Als Benutzer posten
|
as_user | boolean |
Übergeben Sie "true", um die Nachricht als authentifizierten Benutzer statt als Bot zu posten. |
|
|
Analysemodus
|
parse | string |
Ändern Sie, wie Nachrichten behandelt werden. Weitere Informationen finden Sie unter https://api.slack.com/docs/formatting |
|
|
Slack-Markupanalyse
|
mrkdwn | boolean |
Slack-Markupanalyseeinstellung. Standardmäßig aktiviert. |
|
|
Verknüpfungsnamen
|
link_names | integer |
Suchen und Verknüpfen von Kanalnamen und Benutzernamen. |
|
|
Unfurl Links
|
unfurl_links | boolean |
Übergeben Sie "true", um die Entfurmung von textbasierten Inhalten zu ermöglichen. |
|
|
Unfurl Media
|
unfurl_media | boolean |
Übergeben Sie "false", um die Entfurmung von Medieninhalten zu deaktivieren. |
|
|
Symbol-URL
|
icon_url | uri |
URL zu einem Bild, das als Symbol für diese Nachricht verwendet werden soll. |
|
|
Symbol-Emoji
|
icon_emoji | string |
Emoji, das als Symbol für diese Nachricht verwendet werden soll. |
Gibt zurück
Details der Nachricht, die in einem Slack-Kanal gepostet wurde.
- Body
- PostMessageResponse
Nachricht posten [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen post message (V2).
Dieser Vorgang wird verwendet, um eine Nachricht an den angegebenen Kanal zu posten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kanalname
|
channel | True | string |
Kanal, private Gruppe oder Chatkanal zum Senden von Nachrichten an. Kann ein Name (z. B. #general) oder eine codierte ID sein. |
|
Meldungstext
|
text | True | string |
Textkörper der zu sendenden Nachricht (weniger als 4000 Zeichen). Formatierungsoptionen finden Sie unter https://api.slack.com/docs/formatting. |
|
Botname
|
username | string |
Name des Bots. |
|
|
Als Benutzer posten
|
as_user | boolean |
Übergeben Sie "true", um die Nachricht als authentifizierten Benutzer statt als Bot zu posten. |
|
|
Analysemodus
|
parse | string |
Ändern Sie, wie Nachrichten behandelt werden. Weitere Informationen finden Sie unter https://api.slack.com/docs/formatting. |
|
|
Verknüpfungsnamen
|
link_names | integer |
Suchen und Verknüpfen von Kanalnamen und Benutzernamen. |
|
|
Unfurl Links
|
unfurl_links | boolean |
Übergeben Sie "true", um die Entfurmung von textbasierten Inhalten zu ermöglichen. |
|
|
Unfurl Media
|
unfurl_media | boolean |
Übergeben Sie "false", um die Entfurmung von Medieninhalten zu deaktivieren. |
|
|
Symbol-URL
|
icon_url | uri |
URL zu einem Bild, das als Symbol für diese Nachricht verwendet werden soll. |
|
|
Symbol-Emoji
|
icon_emoji | string |
Emoji, das als Symbol für diese Nachricht verwendet werden soll. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Erfolgsergebnis
|
ok | boolean |
Gibt an, ob der Vorgang erfolgreich war. |
|
Kanal
|
channel | string |
Der Kanal, in dem die Nachricht gepostet wurde. |
|
Erstellt Date-Time
|
ts | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Meldungstext
|
message.text | string |
Textkörper der Nachricht. |
|
Nachrichten-ID
|
message.id | string |
Eindeutiger Bezeichner der Nachricht. |
|
Creator-ID
|
message.user | string |
Eindeutiger Bezeichner des Benutzers, der die Nachricht gepostet hat. |
|
Erstellungszeit
|
message.created | integer |
Unix-Zeitstempel für den Zeitpunkt der Erstellung der Nachricht. |
|
Ist gelöscht
|
message.is_user-deleted | boolean |
Gibt an, ob die Nachricht gelöscht wurde. |
|
Fehlermeldungen
|
error | string |
Details zu den Fehlermeldungen, falls vorhanden. |
Unterhaltungsnachrichten auflisten (Vorschau)
Auflisten der in einer Unterhaltung geposteten Nachrichten (öffentlicher Kanal, privater Kanal, direkte Nachricht oder Direkte Gruppennachricht).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Unterhaltungs-ID
|
channel | True | string |
Die Unterhaltung, aus der Nachrichten abgerufen werden sollen. |
|
Maximale Ergebnisse
|
limit | integer |
Die maximale Anzahl von Nachrichten, die pro Seite zurückgegeben werden sollen. |
|
|
Ältester Zeitstempel
|
oldest | string |
Nur Nachrichten nach diesem Unix-Zeitstempel werden in die Ergebnisse aufgenommen. |
|
|
Neuester Zeitstempel
|
latest | string |
Nur Nachrichten vor diesem Unix-Zeitstempel werden in die Ergebnisse einbezogen. |
|
|
Inklusiv
|
inclusive | boolean |
Schließen Sie Nachrichten mit den ältesten oder neuesten Zeitstempeln in die Ergebnisse ein. |
|
|
Alle Metadaten einschließen
|
include_all_metadata | boolean |
Gibt alle Metadaten zurück, die jeder Nachricht zugeordnet sind. |
Gibt zurück
Öffentliche Kanäle auflisten
Listet die öffentlichen Kanäle in Pufferzeit auf.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Unterhaltungstypen
|
types | string |
Einzuschließende Durch Trennzeichen getrennte Unterhaltungstypen. Standardmäßig wird public_channel. Fügen Sie explizit private_channel, Chat oder Mpim hinzu, um andere Unterhaltungstypen auflisten zu können. |
|
|
Archiviert ausschließen
|
exclude_archived | boolean |
Auf "true" festgelegt, um archivierte Unterhaltungen auszuschließen. |
|
|
Maximale Ergebnisse
|
limit | integer |
Die maximale Anzahl von Unterhaltungen, die zurückgegeben werden sollen. |
|
|
Team-ID
|
team_id | string |
Codierte Team-ID. Nur für ein organisationsweites Token erforderlich. |
|
|
Cursor
|
cursor | string |
Paginierungscursor, der von der vorherigen Anforderung zurückgegeben wird. |
Gibt zurück
Öffentliche Kanäle auflisten (Paginierungsunterstützung) (Vorschau)
Trigger
| Beim Erstellen einer Datei |
Beim Erstellen einer Datei |
Beim Erstellen einer Datei
Beim Erstellen einer Datei
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kanal
|
channel | True | string |
Der Name des Kanals. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Id
|
id | string |
ID der Datei |
|
Erstellt
|
created | integer |
Wann die Datei erstellt wurde. |
|
Name
|
name | string |
Der Name der Datei. |
|
Title
|
title | string |
Der Titel der Datei. |
Definitionen
Kanal
Der Kanal
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Id
|
id | string |
Die ID des Kanals. |
|
Name
|
name | string |
Der Name des Kanals. |
|
Ist öffentlicher Kanal
|
is_channel | boolean |
Gibt an, ob es sich bei dieser Unterhaltung um einen öffentlichen Kanal handelt. |
|
Ist privater Kanal
|
is_group | boolean |
Gibt an, ob es sich bei dieser Unterhaltung um einen privaten Kanal handelt. |
|
Ist direkte Nachricht
|
is_im | boolean |
Gibt an, ob es sich bei dieser Unterhaltung um eine direkte Nachricht zwischen zwei Benutzern handelt. |
|
Ist "Direkte Gruppieren"-Nachricht
|
is_mpim | boolean |
Gibt an, ob es sich bei dieser Unterhaltung um eine Direkte Gruppennachricht handelt. |
|
Ist privat
|
is_private | boolean |
Gibt an, ob diese Unterhaltung privat ist. |
|
Ist archiviert
|
is_archived | boolean |
Gibt an, ob diese Unterhaltung archiviert wurde. |
|
Ist Mitglied
|
is_member | boolean |
Gibt an, ob der authentifizierte Benutzer Mitglied dieser Unterhaltung ist. |
|
Benutzer-ID
|
user | string |
Bei direkten Nachrichten die ID des anderen Benutzers in der Unterhaltung. |
|
Mitgliederzahl
|
num_members | integer |
Die Anzahl der Mitglieder in dieser Unterhaltung. |
ListChannels_Response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Kanäle
|
channels | array of Channel | |
|
Nächster Cursor
|
response_metadata.next_cursor | string |
Cursor, der an die nächste Anforderung übergeben werden soll. Leer, wenn keine weiteren Ergebnisse vorhanden sind. |
ListChannels_ResponseV3
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
value
|
value | array of Channel |
SlackMessage
Eine Nachricht, die in einer Slack-Unterhaltung gepostet wurde.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Nachrichten-ID
|
ts | string |
Eindeutiger Zeitstempelbezeichner der Nachricht. |
|
Autor-ID
|
user | string |
Die ID des Benutzers, der die Nachricht gepostet hat. Verwenden Sie "Benutzerprofil abrufen", um dies für einen Benutzer aufzulösen. |
|
Meldungstext
|
text | string |
Textkörper der Nachricht. |
|
Nachrichtentyp
|
type | string |
Typ der Nachricht. |
|
Thread-ID
|
thread_ts | string |
Der Zeitstempel der übergeordneten Nachricht, wenn diese Nachricht Teil eines Threads ist. |
|
Anzahl antworten
|
reply_count | integer |
Die Anzahl der Antworten auf diese Nachricht, wenn sie einen Thread startet. |
ListMessages_Response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
value
|
value | array of SlackMessage |
SlackUserProfile
Zusätzliche Profildetails für einen Slack-Benutzer.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzeigename
|
display_name | string |
Der Anzeigename, den der Benutzer für sein Profil ausgewählt hat. |
|
Realer Name
|
real_name | string |
Der Vor- und Nachname des Benutzers. |
|
Email
|
string |
Die E-Mail-Adresse des Benutzers. |
|
|
Avatar-URL
|
image_72 | string |
URL einer 72x72-Pixelversion des Avatars des Benutzers. |
SlackUser
Ein Pufferbenutzer.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Id
|
id | string |
Die ID des Benutzers. |
|
Nutzername
|
name | string |
Der Slack-Benutzername des Benutzers. |
|
Realer Name
|
real_name | string |
Der Vor- und Nachname des Benutzers. |
|
Ist Bot
|
is_bot | boolean |
Gibt an, ob der Benutzer ein Bot ist. |
|
Wird deaktiviert
|
deleted | boolean |
Gibt an, ob das Konto des Benutzers deaktiviert wurde. |
|
Zeitzone
|
tz | string |
Die lesbare Zeitzone des Benutzers. |
|
Profile
|
profile | SlackUserProfile |
Zusätzliche Profildetails für einen Slack-Benutzer. |
GetUserProfile_Response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Erfolgsergebnis
|
ok | boolean |
Gibt an, ob der Vorgang erfolgreich war. |
|
User
|
user | SlackUser |
Ein Pufferbenutzer. |
|
Fehlermeldungen
|
error | string |
Details zu den Fehlermeldungen, falls vorhanden. |
CreateChannel_Response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Kanal
|
channel | Channel |
Der Kanal |
JoinChannel_Response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Bereits im Kanal
|
already_in_channel | boolean |
Gibt an, ob sich der Benutzer bereits im Kanal befindet oder nicht. |
|
Kanal
|
channel | Channel |
Der Kanal |
JoinChannel_ResponseV2
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Kanal
|
channel | Channel |
Der Kanal |
|
Warnung
|
warning | string |
Gibt an, ob sich der Benutzer bereits im Kanal befindet oder nicht. |
PostMessageResponse
Details der Nachricht, die in einem Slack-Kanal gepostet wurde.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Erfolgsergebnis
|
ok | boolean |
Gibt an, ob der Vorgang erfolgreich war. |
|
Kanal
|
channel | string |
Der Kanal, in dem die Nachricht gepostet wurde. |
|
Erstellungszeit
|
ts | string |
Unix-Zeitstempel für den Zeitpunkt der Erstellung der Nachricht. |
|
Nachrichtentyp
|
message.type | string |
Typ der Nachricht. |
|
Meldungstext
|
message.text | string |
Textkörper der Nachricht. |
|
Erstellungszeit
|
message.ts | string |
Unix-Zeitstempel für den Zeitpunkt der Erstellung der Nachricht. |
|
Fehlermeldungen
|
error | string |
Details zu den Fehlermeldungen, falls vorhanden. |