ayon-core/openpype/modules/slack
2023-11-16 15:27:33 +01:00
..
launch_hooks Applications: Use prelaunch hooks to extract environments (#5387) 2023-08-03 10:04:15 +02:00
plugins/publish use project, task and host name from context data (#5918) 2023-11-16 15:27:33 +01:00
python2_vendor/python-slack-sdk-1 moved slack module 2021-12-02 16:31:22 +01:00
resources OP-1730 - added icon and documentation 2022-01-12 16:43:12 +01:00
__init__.py moved slack module 2021-12-02 16:31:22 +01:00
manifest.yml Revert "Fix - added missed scopes for Slack bot" 2023-02-23 16:31:26 +01:00
README.md moved slack module 2021-12-02 16:31:22 +01:00
slack_module.py added forgotten modules 2022-11-03 16:26:26 +01:00

Slack notification for publishing

This module allows configuring profiles(when to trigger, for which combination of task, host and family) and templates(could contain {} placeholder, as "{asset} published").

These need to be configured in Project settings > Slack > Publish plugins > Notification to Slack

Slack module must be enabled in System Setting, could be configured per Project.

App installation

Slack app needs to be installed to company's workspace. Attached .yaml file could be used, follow instruction https://api.slack.com/reference/manifests#using

Settings

Token

Most important for module to work is to fill authentication token Project settings > Slack > Publish plugins > Token

This token should be available after installation of app in Slack dashboard. It is possible to create multiple tokens and configure different scopes for them.

Profiles

Profiles are used to select when to trigger notification. One or multiple profiles could be configured, 'family', 'task name' (regex available) and host combination is needed.

Eg. If I want to be notified when render is published from Maya, setting is:

  • family: 'render'
  • host: 'Maya'

Channel

Message could be delivered to one or multiple channels, by default app allows Slack bot to send messages to 'public' channels (eg. bot doesn't need to join channel first).

This could be configured in Slack dashboard and scopes might be modified.

Message

Placeholders {} could be used in message content which will be filled during runtime. Only keys available in 'anatomyData' are currently implemented.

Example of message content: {SUBSET} for {Asset} was published.

Integration can upload 'thumbnail' file (if present in instance), for that bot must be manually added to target channel by Slack admin! (In target channel write: ```/invite @OpenPypeNotifier``)