Jeśli masz problem ze zrozumieniem jak działa zadanie automatyczne, sprawdź opisy: Zadanie automatyczne, Wykonanie warunkowe, Parametry komponentów

Kategoria: Slack

Dostępne od wersji: 1.0.0

Komponent służy do wysyłania wiadomości w komunikatorze Slack do wskazanych adresatów przy użyciu bota. Aby móc używać bota należy najpierw stworzyć aplikację na stronie api.slack.com w odpowiedniej przestrzeni roboczej. Bot umożliwia w sposób automatyczny wysyłanie wiadomości do pojedynczego użytkownika, prywatnych grup oraz publicznego i prywatnego kanału. Bot jest kontrolowany za pomocą specjalnego tokena użytkownika bota (Bot User OAuth Token), który może uzyskać dostęp do jednego lub więcej API Slack'a.

Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Rodzaj adresata*1.0.0

Określa typ odbiorcy wiadomości.

Tekstowy Lista wartości
Wartość wyświetlanaWartość przekazywanaOpis
UżytkownicyUSERSMożliwość wysłania wiadomości do jednego lub większej liczby użytkowników. W przypadku wysyłania wiadomości do większej liczby użytkowników niż 1, zostanie utworzona grupa prywatna składająca się z tych użytkowników oraz aplikacji.
KanałCHANNELMożliwość wysłania wiadomości do publicznego lub prywatnego kanału.
Nazwy użytkowników*1.0.0

Nazwy użytkowników pochodzących z systemu. Muszą mieć oni w systemie zdefiniowany adres email.

Tablica wartości tekstowych Pole edytowalne 
Kanał*1.0.0Nazwa kanału pochodzącego z określonej przestrzeni roboczej Slack'a.Tekstowy Pole edytowalneZamiast nazwy kanału można podać ID kanału, który znajduje się w adresie URL aktualnie przeglądanego kanału Slack'a.
Wiadomość*1.0.0

Treść wiadomości.

Tekstowy Pole edytowalne

Informacje o metodach formatowania tekstu link

Parametr*- pole wymagane

1. Będąc zalogowanym w odpowiedniej przestrzeni roboczej Slack'a, na stronie link należy stworzyć aplikację.

2. Następnie dodajemy przynajmniej jeden zakres uprawnień, aby móc zainstalować aplikację w określonej przestrzeni roboczej. W tym celu wybieramy w sekcji Building Apps for Slack z listy rozwijanej Add features and functionality opcję Permissions. Następnie w sekcji Scopes w Bot Token Scopes dodajemy zakres uprawnień (np. chat:write).

3. Na tej samej stronie w sekcji OAuth Tokens for Your Workspace klikamy przycisk Install to Workspace. W nowym oknie zezwalamy nowo utworzonej aplikacji na dostęp do określonej przestrzeni roboczej Slack'a klikając przycisk Allow.

4. W sekcji OAuth Tokens for Your Workspace został wygenerowany token. Umieszczamy jego wartość w systemie w zakładce zarządzania konfiguracjami wtyczek (Plugin Configuration Manager) w pozycji Plus Slack Integrator. W strukturze JSON musi znaleźć się jedna para klucz : wartość odnosząca się do tokenu.

{
 	"token": "xoxb-99489924819-2348753480899-FF1LDoP3DZ2xzEZj9140HTvA"
}


 

 Możliwości działania aplikacji Slack'a są regulowane przez zakresy uprawnień.

OperacjaZakresOpis
Wysyłanie wiadomości na kanałchat:writeWysyłanie wiadomości, jako aplikacja o określonej nazwie, na kanał.
chat:write:publicWysyłanie wiadomości, jako aplikacja o określonej nazwie, na kanał, do którego aplikacja nie należy (nie jest członkiem).
Wysyłanie bezpośrednich wiadomościim:writeWysyłanie bezpośrednich, jako aplikacja o określonej nazwie, wiadomości do użytkowników.
users:readPrzegląd użytkowników w przestrzeni roboczej.
users:read:emailPrzegląd adresów e-mail użytkowników w przestrzeni roboczej.
Wysyłanie wiadomości do grup prywatnych / bezpośrednio do więcej niż 1 użytkownikampim:writeWysyłanie wiadomości jednocześnie do większej liczby użytkowników niż 1, tworząc przy tym prywatną grupę składającą się tych użytkowników i aplikacji.
users:readPrzegląd użytkowników w przestrzeni roboczej.
users:read:emailPrzegląd adresów e-mail użytkowników w przestrzeni roboczej.

Konfiguracja zapewniająca realizację każdej powyższej operacji wygląda następująco

W przypadku operacji wysyłania wiadomości na kanał należy dodać aplikację do określonego kanału, jeśli jest to kanał prywatny. W sytuacji, gdy wiadomość ma zostać wysłana na kanał publiczny, dodawanie aplikacji do tego kanału nie jest potrzebne.

 

 1.0.0

  • Dodanie komponentu

If you have a problem understanding how the action works, check: Automatic tasks, Conditional execution, Components params

Category: Slack

Available from version: 1.0.0

The component is used to send messages in the Slack communicator to the indicated recipients using a bot. To be able to use a bot, you must first create an application on the api.slack.com website in the appropriate workspace. The bot allows you to automatically send messages to a single user, private groups and public and private channels. The bot is controlled by a special bot user token (Bot User OAuth Token) that can access one or more of Slack's APIs.

Parameter name

From version

Description

Paremeter type

Default value

Field type

Comments and restrictions

Recipient type*

1.0.0

Specifies the type of recipient of the message.

Text

 

Values list

Displayed valuePassed ValueDescription
UsersUSERSThe ability to send messages to one or more users. When sending messages to more than 1 users, a private group will be created consisting of these users and application.
ChannelCHANNELThe ability to send messages to a public or private channel.
User names*1.0.0User names coming from the system. They must have an email address defined in the system.Text values array Editable field 
Channel*1.0.0

The name of the channel that comes from the specified Slack workspace.

Text Editable field

Instead of the channel name, you can enter the channel ID, which is in the URL of the currently viewed Slack channel.

Message*1.0.0

The message content.

Text Editable field

Information on text formatting methods link

Parameter*- mandatory field

1. Being logged in to the appropriate Slack workspace, create an application on the link page.

2. Then we add at least one permission scope to be able to install the application in the specified workspace. To do this, in Building Apps for Slack section select the Permissions option from Add features and functionality drop-down list. Then, in the Scopes section of the Bot Token Scopes, we add the scope of permissions (e.g. chat:write).

3. On the same page, in the OAuth Tokens for Your Workspace section, click the Install to Workspace button. In the new window, we allow the newly created application to access a specific Slack workspace by clicking the Allow button.

4. A token has been generated in the OAuth Tokens for Your Workspace section. We put its value in the system in the plugin configuration management tab in the Plus Slack Integrator item. There must be one key-value pair in the JSON structure that corresponds to the token.

{
 	"token": "xoxb-99489924819-2348753480899-FF1LDoP3DZ2xzEZj9140HTvA"
}


 The Slack application's capabilities are governed by the permission scopes.

OperationZakresOpis
Sending messages to a channelchat:writeSending messages as an application with a specific name to channel.
chat:write:publicSending messages as an application with the specified name to a channel to which the application does not belong (is not a member).
Sending direct messagesim:writeSending direct message as an application with the specified name to users.
users:readOverview of users in the workspace.
users:read:emailOverview of users' email addresses in the workspace.

Sending messages to private groups / directly to more than 1 user

mpim:writeSend messages to more than 1 users simultaneously, creating a private group of those users and application.
users:readOverview of users in the workspace.
users:read:emailOverview of users' email addresses in the workspace

The configuration that ensures the implementation of each of the above operations is as follows

For an operation of sending messages to a channel, add the application to the specified channel, if it is a private channel. In a situation where the message is to be sent to the public channel, adding the application to this channel is not necessary.

1.0.0

  • Component adding