jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-16 13:56:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clarify how Slack uses messages and blocks (#30089)

Browse Source 
* Document Slack block limit per message

* Explain where blocks and message fields will be used by Slack

* Update example to clarify block/message usage

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Fletcher 2023-12-02 15:17:45 +08:00 committed by GitHub
parent 201600fddc
commit fe9655e4c9
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
source/_integrations/slack.markdown
View File

@ -119,7 +119,7 @@ sequence:
mode: single
```
Update the blocks array with valid Slack blocks. The easiest way to create this is using [Slack Block Kit Builder](https://app.slack.com/block-kit-builder)
Update the blocks array with valid Slack blocks. The easiest way to create this is using [Slack Block Kit Builder](https://app.slack.com/block-kit-builder). Up to 50 blocks may be included per message.
Create a duplicate of this script to use for different messages, and different channels (the door was opened in #security, the light was left on on #lights, etc).
@ -142,7 +142,7 @@ The following attributes can be placed inside the `data` key of the service call
| `username` | yes | The username of the Slack bot.
| `icon` | yes | The icon of the Slack bot.
| `file` | yes | A file to include with the message; see below.
| `blocks` | yes | Array of [Slack blocks](https://api.slack.com/messaging/composing/layouts). *NOTE*: if using `blocks`, they are shown **in place of** the `message` (note that the `message` is required nonetheless).
| `blocks` | yes | Array of [Slack blocks](https://api.slack.com/messaging/composing/layouts). *NOTE*: if using `blocks`, they are shown **in place of** the `message` within Slack apps. The message field will be used as notification text and anywhere else Slack is unable to display blocks. `message` is required regardless of whether this field is used.
| `blocks_template` | yes | The same as `blocks`, but able to support [templates](https://www.home-assistant.io/docs/configuration/templating).
| `thread_ts` | yes | Sends the message as a reply to a specified parent message.
@ -209,7 +209,7 @@ data:
To use the block framework:
```yaml
message: Fallback message in case the blocks don't display anything.
message: Fallback message for notifications or in case the blocks don't display anything.
title: Title of the file.
data:
blocks:
@ -237,8 +237,10 @@ data:
1.0
```
Send a message directly to a user by setting the target to their member ID.
```yaml
message: "Hello there!"
target: "U12345"