Awell Docs

Send messages to Slack channels from your care flows to keep your team informed.

Category: Communication. Adds 1 action to a care flow.

What to configure

Set these once, on the extension in Awell Studio. An action fails at run time if a required setting is missing.

Setting	Required	Notes
Bot Token	Yes	Your Slack Bot User OAuth Token (starts with xoxb-). You can find this in your Slack App settings under "OAuth & Permissions". The bot needs the chat:write scope. Stored as a secret.

Actions

Slack adds this action to a care flow. Add one to a step, then fill in its inputs.

Send Message to Channel

Send a message to a Slack channel.

This action can be previewed in Studio before you publish.

Input	Type	Required	Description
Channel	`string`	Yes	The Slack channel to send the message to. Use the channel ID (e.g., C1234567890) or channel name (e.g., #general). The bot must be invited to the channel.
Message	`text`	Yes	The message content to send to the channel.

Returns:

Data point	Type
`channelId`	`string`
`messageTs`	`string`

Send a message to a Slack channel.

**Input fields:

Channel (required): The Slack channel to send the message to. You can use either the channel ID (e.g., C1234567890) or the channel name (e.g., #general). The bot must be invited to the channel.
Message (required): The message content to send to the channel.

Output data points:

messageTs: The timestamp/ID of the posted message. This can be used for threading or updating the message later.
channelId**: The channel ID where the message was posted.

Setup and notes

Slack is a messaging platform for teams that brings all your communication together, giving everyone a shared workspace where conversations are organized and accessible.

This extension allows you to send messages to Slack channels from your care flows, keeping your team informed about important events and updates.

Extension settings

In order to set up this extension, you will need:

A Slack App with a Bot User OAuth Token (starts with xoxb-)
The bot must have the chat:write OAuth scope

Setting up your Slack App

Go to https://api.slack.com/apps and click "Create New App"
Choose "From scratch" and give your app a name
Navigate to "OAuth & Permissions" in the sidebar
Under "Scopes", add the chat:write Bot Token Scope
Click "Install to Workspace" at the top of the page
Copy the "Bot User OAuth Token" (starts with xoxb-)
Use this token in the extension settings

Inviting the bot to channels

Before the bot can post messages to a channel, it must be invited to that channel. You can do this by:

Going to the channel in Slack
Typing /invite @YourBotName

Changelog

Initial release

Initial release of the Slack extension with the following action:

Send Message to Channel: Send a message to a Slack channel from your care flow.

The settings, actions, inputs, outputs and webhooks above are generated from the extension's own code, at @awell-health/awell-extensions v2.1.159. They match what the platform actually does rather than a description of it.

Field-level detail also appears in Awell Studio when you configure the action. Something wrong or missing? Email support@awellhealth.com.

Slack