Slack
Slack to narzędzie do komunikacji zespołowej, które łączy całą komunikację zespołu w jednym miejscu, błyskawicznie z możliwością wyszukiwania i dostępności niezależnie od tego, gdzie idziesz.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Standard | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Power Automate - narzędzie do automatyzacji procesów | Standard | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Kontakt | |
|---|---|
| Name | Microsoft |
| adres URL | https://support.microsoft.com/contactus |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://slack.com/ |
| Zasady ochrony prywatności | https://slack.com/privacy-policy |
| Kategorie | Kolaboracja; Komunikacja |
Znane problemy i ograniczenia
Zgodnie z dokumentacją interfejsu API usługi Slack niektóre metody interfejsu API usługi Slack używane przez łącznik przestaną działać w lutym 2021 r. i nie będą działać z nowo utworzonymi aplikacjami po 10 czerwca 2020 r. Dlatego użyj najnowszych wersji poniższych akcji.
Akcje:
Tworzenie grupy jest przestarzałe. Utwórz kanał w najnowszej wersji, aby utworzyć kanały prywatne.
Maksymalna liczba znaków w wiadomości jest ograniczona do 4000. Aby uzyskać więcej informacji, zapoznaj się z oficjalną dokumentacją usługi Slack.
Szczegółowe informacje o konektorze
Aby uzyskać więcej informacji na temat łącznika, zobacz szczegółową sekcję.
Limity ograniczania
| Nazwisko | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
| Częstotliwość sond wyzwalacza | 1 | 120 sekund |
Akcje
| Dołączanie do kanału [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj opcji Dołącz do publicznego kanału .
|
| Dołączanie do kanału publicznego |
Dołącz do publicznego kanału w usłudze Slack. |
| Opublikuj wiadomość (wersja 2) |
Ta operacja służy do publikowania komunikatu w określonym kanale. |
| Opublikuj wiadomość [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj komunikatu Post (wersja 2).
|
| Pobieranie profilu użytkownika (wersja zapoznawcza) |
Pobieranie informacji o profilu użytkownika usługi Slack. Przydatne do rozpoznawania autora wiadomości zwracanej przez listy wiadomości konwersacji lub odpowiedzi z listą. |
| Tworzenie grupy [PRZESTARZAŁE] |
Tworzy grupę w usłudze Slack. |
| Tworzenie kanału |
Utwórz kanał w usłudze Slack. |
| Tworzenie kanału [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Utwórz kanał .
|
| Ustawianie nie przeszkadza |
Ustaw stan nie przeszkadzać użytkownikowi. |
| Wyświetlanie listy kanałów [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj opcji Wyświetl kanały publiczne (obsługa stronicowania).
|
| Wyświetlanie listy kanałów publicznych |
Wyświetl listę kanałów publicznych w usłudze Slack. |
| Wyświetlanie listy kanałów publicznych (obsługa stronicowania) (wersja zapoznawcza) |
Wyświetl listę kanałów publicznych w usłudze Slack. |
| Wyświetlanie listy odpowiedzi wiadomości (wersja zapoznawcza) |
Wyświetl odpowiedzi w wątku wiadomości, w tym wiadomość nadrzędną. |
| Wyświetlanie listy wiadomości konwersacji (wersja zapoznawcza) |
Wyświetl listę wiadomości opublikowanych w konwersacji (kanał publiczny, kanał prywatny, wiadomość bezpośrednia lub bezpośrednia wiadomość grupy). |
Dołączanie do kanału [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj opcji Dołącz do publicznego kanału .
Dołącz do kanału w usłudze Slack.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Name
|
name | string |
Nazwa kanału. |
Zwraca
- Body
- JoinChannel_Response
Dołączanie do kanału publicznego
Dołącz do publicznego kanału w usłudze Slack.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kanału
|
channel | string |
Nazwa kanału. |
Zwraca
Opublikuj wiadomość (wersja 2)
Ta operacja służy do publikowania komunikatu w określonym kanale.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kanału
|
channel | True | string |
Kanał, grupa prywatna lub kanał wiadomości błyskawicznych do wysłania wiadomości. Może być nazwą (np. #general) lub zakodowanym identyfikatorem. |
|
Tekst wiadomości
|
text | True | string |
Treść wiadomości do wysłania. Interfejs API usługi Slack obcina komunikaty zawierające więcej niż 40 000 znaków. Aby uzyskać opcje formatowania, zobacz https://api.slack.com/docs/formatting |
|
Sygnatura czasowa komunikatu nadrzędnego
|
thread_ts | string |
Sygnatura czasowa wiadomości nadrzędnej podczas publikowania odpowiedzi w wątku. |
|
|
Emisja do kanału
|
reply_broadcast | boolean |
Przekaż wartość true, aby również wysłać wątek odpowiedzi do kanału. |
|
|
Nazwa bota
|
username | string |
Nazwa bota. |
|
|
Opublikuj jako użytkownika
|
as_user | boolean |
Przekaż wartość true, aby opublikować komunikat jako uwierzytelniony użytkownik, a nie jako bot. |
|
|
Tryb analizowania
|
parse | string |
Zmień sposób traktowania komunikatów. Aby uzyskać szczegółowe informacje, zobacz https://api.slack.com/docs/formatting |
|
|
Analizowanie znaczników w usłudze Slack
|
mrkdwn | boolean |
Ustawienie analizy znaczników slack. Włączone domyślnie. |
|
|
Nazwy łączy
|
link_names | integer |
Znajdowanie i łączenie nazw kanałów i nazw użytkowników. |
|
|
Rozwiernij łącza
|
unfurl_links | boolean |
Przekaż wartość true, aby umożliwić rozwikłanie zawartości opartej głównie na tekście. |
|
|
Unfurl Media
|
unfurl_media | boolean |
Przekaż wartość false, aby wyłączyć rozwieranie zawartości multimedialnej. |
|
|
Adres URL ikony
|
icon_url | uri |
Adres URL obrazu do użycia jako ikona dla tej wiadomości. |
|
|
Ikona Emoji
|
icon_emoji | string |
Emoji do użycia jako ikona tej wiadomości. |
Zwraca
Szczegóły wiadomości opublikowanej w kanale usługi Slack.
- Body
- PostMessageResponse
Opublikuj wiadomość [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj komunikatu Post (wersja 2).
Ta operacja służy do publikowania komunikatu w określonym kanale.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kanału
|
channel | True | string |
Kanał, grupa prywatna lub kanał wiadomości błyskawicznych do wysłania wiadomości. Może być nazwą (np. #general) lub zakodowanym identyfikatorem. |
|
Tekst wiadomości
|
text | True | string |
Treść wiadomości do wysłania (mniej niż 4000 znaków). Aby uzyskać opcje formatowania, zobacz https://api.slack.com/docs/formatting. |
|
Nazwa bota
|
username | string |
Nazwa bota. |
|
|
Opublikuj jako użytkownika
|
as_user | boolean |
Przekaż wartość true, aby opublikować komunikat jako uwierzytelniony użytkownik, a nie jako bot. |
|
|
Tryb analizowania
|
parse | string |
Zmień sposób traktowania komunikatów. Aby uzyskać szczegółowe informacje, zobacz https://api.slack.com/docs/formatting. |
|
|
Nazwy łączy
|
link_names | integer |
Znajdowanie i łączenie nazw kanałów i nazw użytkowników. |
|
|
Rozwiernij łącza
|
unfurl_links | boolean |
Przekaż wartość true, aby umożliwić rozwikłanie zawartości opartej głównie na tekście. |
|
|
Unfurl Media
|
unfurl_media | boolean |
Przekaż wartość false, aby wyłączyć rozwieranie zawartości multimedialnej. |
|
|
Adres URL ikony
|
icon_url | uri |
Adres URL obrazu do użycia jako ikona dla tej wiadomości. |
|
|
Ikona Emoji
|
icon_emoji | string |
Emoji do użycia jako ikona tej wiadomości. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Wynik powodzenia
|
ok | boolean |
Wskazuje, czy operacja zakończyła się pomyślnie. |
|
Channel
|
channel | string |
Kanał, do którego wysłano wiadomość. |
|
Utworzono Date-Time
|
ts | string |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Tekst wiadomości
|
message.text | string |
Treść wiadomości. |
|
Identyfikator wiadomości
|
message.id | string |
Unikatowy identyfikator wiadomości. |
|
Identyfikator twórcy
|
message.user | string |
Unikatowy identyfikator użytkownika, który opublikował wiadomość. |
|
Czas utworzenia
|
message.created | integer |
Sygnatura czasowa systemu Unix dla momentu utworzenia komunikatu. |
|
Jest usuwany
|
message.is_user-deleted | boolean |
Czy wiadomość została usunięta. |
|
Komunikaty o błędach
|
error | string |
Szczegóły komunikatów o błędach, jeśli istnieją. |
Pobieranie profilu użytkownika (wersja zapoznawcza)
Pobieranie informacji o profilu użytkownika usługi Slack. Przydatne do rozpoznawania autora wiadomości zwracanej przez listy wiadomości konwersacji lub odpowiedzi z listą.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator użytkownika
|
user | True | string |
Identyfikator użytkownika do pobrania informacji o profilu. |
Zwraca
Tworzenie grupy [PRZESTARZAŁE]
Tworzy grupę w usłudze Slack.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Name
|
name | string |
Nazwa grupy. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
group.id | string |
Identyfikator grupy. |
|
Name
|
group.name | string |
Nazwa grupy. |
Tworzenie kanału
Utwórz kanał w usłudze Slack.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Name
|
name | string |
Nazwa nowego kanału. |
|
|
Czy kanał prywatny?
|
is_private | boolean |
Kanał jest prywatny lub nie |
Zwraca
Tworzenie kanału [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Utwórz kanał .
Utwórz kanał w usłudze Slack.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Name
|
name | string |
Nazwa nowego kanału. |
Zwraca
Ustawianie nie przeszkadza
Ustaw stan nie przeszkadzać użytkownikowi.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Liczba minut
|
num_minutes | string |
Liczba minut do ustawienia nie przeszkadza. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Włącz odłożenie
|
snooze_enabled | boolean |
Określa, czy włączono snooze. |
Wyświetlanie listy kanałów [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj opcji Wyświetl kanały publiczne (obsługa stronicowania).
Wyświetl listę kanałów w usłudze Slack.
Zwraca
Wyświetlanie listy kanałów publicznych
Wyświetl listę kanałów publicznych w usłudze Slack.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Typy konwersacji
|
types | string |
Rozdzielane przecinkami typy konwersacji do uwzględnienia. Wartość domyślna to public_channel. Jawnie dołącz private_channel, im lub mpim, aby wyświetlić listę innych typów konwersacji. |
|
|
Wyklucz zarchiwizowane
|
exclude_archived | boolean |
Ustaw wartość true, aby wykluczyć zarchiwizowane konwersacje. |
|
|
Maksymalna liczba wyników
|
limit | integer |
Maksymalna liczba konwersacji do zwrócenia. |
|
|
Identyfikator zespołu
|
team_id | string |
Zakodowany identyfikator zespołu. Wymagane tylko dla tokenu dla całej organizacji. |
|
|
Cursor
|
cursor | string |
Kursor stronicowania zwrócony przez poprzednie żądanie. |
Zwraca
Wyświetlanie listy kanałów publicznych (obsługa stronicowania) (wersja zapoznawcza)
Wyświetlanie listy odpowiedzi wiadomości (wersja zapoznawcza)
Wyświetl odpowiedzi w wątku wiadomości, w tym wiadomość nadrzędną.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator konwersacji
|
channel | True | string |
Konwersacja zawierająca wątek. |
|
Sygnatura czasowa komunikatu nadrzędnego
|
ts | True | string |
Sygnatura czasowa komunikatu nadrzędnego, który uruchamia wątek. Dostępne jako |
|
Maksymalna liczba wyników
|
limit | integer |
Maksymalna liczba komunikatów zwracanych na stronę. |
|
|
Najstarsza sygnatura czasowa
|
oldest | string |
W wynikach zostaną uwzględnione tylko komunikaty po tym znaczniku czasu systemu Unix. |
|
|
Najnowszy znacznik czasu
|
latest | string |
W wynikach zostaną uwzględnione tylko komunikaty przed tym znacznikami czasu systemu Unix. |
|
|
All inclusive
|
inclusive | boolean |
Uwzględnij komunikaty z najstarszymi lub najnowszymi znacznikami czasu w wynikach. |
Zwraca
Wyświetlanie listy wiadomości konwersacji (wersja zapoznawcza)
Wyświetl listę wiadomości opublikowanych w konwersacji (kanał publiczny, kanał prywatny, wiadomość bezpośrednia lub bezpośrednia wiadomość grupy).
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator konwersacji
|
channel | True | string |
Konwersacja do pobierania wiadomości z. |
|
Maksymalna liczba wyników
|
limit | integer |
Maksymalna liczba komunikatów zwracanych na stronę. |
|
|
Najstarsza sygnatura czasowa
|
oldest | string |
W wynikach zostaną uwzględnione tylko komunikaty po tym znaczniku czasu systemu Unix. |
|
|
Najnowszy znacznik czasu
|
latest | string |
W wynikach zostaną uwzględnione tylko komunikaty przed tym znacznikami czasu systemu Unix. |
|
|
All inclusive
|
inclusive | boolean |
Uwzględnij komunikaty z najstarszymi lub najnowszymi znacznikami czasu w wynikach. |
|
|
Uwzględnij wszystkie metadane
|
include_all_metadata | boolean |
Zwróć wszystkie metadane skojarzone z każdym komunikatem. |
Zwraca
Wyzwalacze
| Po utworzeniu pliku |
Po utworzeniu pliku |
Po utworzeniu pliku
Po utworzeniu pliku
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Channel
|
channel | True | string |
Nazwa kanału. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Identyfikator pliku |
|
Created
|
created | integer |
Po utworzeniu pliku. |
|
Name
|
name | string |
Nazwa pliku. |
|
Title
|
title | string |
Tytuł pliku. |
Definicje
Channel
Kanał
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Identyfikator kanału. |
|
Name
|
name | string |
Nazwa kanału. |
|
Jest kanałem publicznym
|
is_channel | boolean |
Czy ta konwersacja jest publicznym kanałem. |
|
Jest kanałem prywatnym
|
is_group | boolean |
Czy ta konwersacja jest kanałem prywatnym. |
|
Jest komunikatem bezpośrednim
|
is_im | boolean |
Czy ta konwersacja jest bezpośrednią wiadomością między dwoma użytkownikami. |
|
Czy wiadomość bezpośrednia grupy
|
is_mpim | boolean |
Czy ta konwersacja jest wiadomością bezpośrednią grupy. |
|
Jest prywatny
|
is_private | boolean |
Czy ta konwersacja jest prywatna. |
|
Jest zarchiwizowane
|
is_archived | boolean |
Czy ta konwersacja została zarchiwizowana. |
|
Jest członkiem
|
is_member | boolean |
Czy uwierzytelniony użytkownik jest członkiem tej konwersacji. |
|
Identyfikator użytkownika
|
user | string |
W przypadku wiadomości bezpośrednich identyfikator innego użytkownika w konwersacji. |
|
Liczba elementów członkowskich
|
num_members | integer |
Liczba członków w tej konwersacji. |
ListChannels_Response
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kanały
|
channels | array of Channel | |
|
Następny kursor
|
response_metadata.next_cursor | string |
Kursor, aby przekazać do następnego żądania. Puste, gdy nie ma więcej wyników. |
ListChannels_ResponseV3
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
value
|
value | array of Channel |
SlackMessage
Wiadomość wysłana w konwersacji usługi Slack.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator wiadomości
|
ts | string |
Unikatowy identyfikator znacznika czasu wiadomości. |
|
Identyfikator autora
|
user | string |
Identyfikator użytkownika, który opublikował wiadomość. Użyj opcji Pobierz profil użytkownika, aby rozwiązać ten problem dla użytkownika. |
|
Tekst wiadomości
|
text | string |
Treść wiadomości. |
|
Typ komunikatu
|
type | string |
Wpisz komunikat. |
|
Identyfikator wątku
|
thread_ts | string |
Sygnatura czasowa komunikatu nadrzędnego, jeśli ten komunikat jest częścią wątku. |
|
Liczba odpowiedzi
|
reply_count | integer |
Liczba odpowiedzi na tę wiadomość, jeśli uruchamia wątek. |
ListMessages_Response
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
value
|
value | array of SlackMessage |
SlackUserProfile
Dodatkowe szczegóły profilu użytkownika usługi Slack.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Wyświetlana nazwa
|
display_name | string |
Nazwa wyświetlana wybrana przez użytkownika dla swojego profilu. |
|
Rzeczywista nazwa
|
real_name | string |
Imię i nazwisko użytkownika. |
|
Email
|
string |
Adres e-mail użytkownika. |
|
|
Adres URL awatara
|
image_72 | string |
Adres URL 72x72 pikseli wersji awatara użytkownika. |
SlackUser
Użytkownik usługi Slack.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Identyfikator użytkownika. |
|
Nazwa użytkownika
|
name | string |
Nazwa użytkownika usługi Slack. |
|
Rzeczywista nazwa
|
real_name | string |
Imię i nazwisko użytkownika. |
|
Jest botem
|
is_bot | boolean |
Czy użytkownik jest botem. |
|
Jest dezaktywowany
|
deleted | boolean |
Czy konto użytkownika zostało zdezaktywowane. |
|
Strefa czasowa
|
tz | string |
Czytelna dla człowieka strefa czasowa użytkownika. |
|
Profile
|
profile | SlackUserProfile |
Dodatkowe szczegóły profilu użytkownika usługi Slack. |
GetUserProfile_Response
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Wynik powodzenia
|
ok | boolean |
Wskazuje, czy operacja zakończyła się pomyślnie. |
|
User
|
user | SlackUser |
Użytkownik usługi Slack. |
|
Komunikaty o błędach
|
error | string |
Szczegóły komunikatów o błędach, jeśli istnieją. |
CreateChannel_Response
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Channel
|
channel | Channel |
Kanał |
JoinChannel_Response
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Już w kanale
|
already_in_channel | boolean |
Czy użytkownik jest już w kanale, czy nie. |
|
Channel
|
channel | Channel |
Kanał |
JoinChannel_ResponseV2
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Channel
|
channel | Channel |
Kanał |
|
Ostrzeżenie
|
warning | string |
Czy użytkownik jest już w kanale, czy nie. |
PostMessageResponse
Szczegóły wiadomości opublikowanej w kanale usługi Slack.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Wynik powodzenia
|
ok | boolean |
Wskazuje, czy operacja zakończyła się pomyślnie. |
|
Channel
|
channel | string |
Kanał, do którego wysłano wiadomość. |
|
Czas utworzenia
|
ts | string |
Sygnatura czasowa systemu Unix dla momentu utworzenia komunikatu. |
|
Typ komunikatu
|
message.type | string |
Wpisz komunikat. |
|
Tekst wiadomości
|
message.text | string |
Treść wiadomości. |
|
Czas utworzenia
|
message.ts | string |
Sygnatura czasowa systemu Unix dla momentu utworzenia komunikatu. |
|
Komunikaty o błędach
|
error | string |
Szczegóły komunikatów o błędach, jeśli istnieją. |