Log In
Sign Up
All Posts
Courier Live Header
COURIER LIVE

Courier Live: Sending Notifications via Slack

Aydrian Howard

September 16, 2020

As a follow up to the Courier Live where Troy and I built the Pigeon Weather App, I went back and added support for sending the notification as a direct message in Slack. Adding this additional channel only required adding the Slack provider, designing the message, and updating our Glitch App to accept Slack profile information.

Check out the video below to watch me:

  • Add a Slack Channel to an existing notification

  • Create a Slack App and install it to a test workspace

  • Update the Pigeon Weather application to update Courier Profiles with Slack information

  • See the notification delivered via Slack DM

Be sure to Like the video and Subscribe to our YouTube channel.

Slack as a Notification Channel

Courier makes it easy to send notifications to a Slack channel or as a direct message to a Slack user. You can use your existing Slack App or create a new one, as long as it has the proper permissions granted via OAuth scopes. You can then send a notification by providing a slack object to the profile that includes the Slack App Bot User OAuth Access Token (bot token) and either the channel id, user id, or user email address.

Sending to a Slack Channel

To send to a Slack public or private channel, your Slack app must be granted the chat:write scope. Your Slack app must also be a member of the channel you're sending to. The recipient profile requires the bot token and channel id. This can be supplied to the send in the profile object, but I like to use the Profiles API to create a channel recipient profile.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 import { CourierClient } from "@trycourier/courier"; const courier = CourierClient({ authorizationToken: "<AUTH_TOKEN>" }); const { status: mergeStatus } = await courier.mergeProfile({ recipientId: "CHANNEL_GENERAL", profile: { slack: { access_token: "xoxb-xxxxx", channel: "CL2MR6HEX", }, }, }); console.log(mergeStatus);

You can learn more about sending to public and private channels in our Slack documentation.

Sending a Direct Message

To send a direct message, in addition to the chat:write scope, your app will also need to be granted the im:write scope. For sending a direct message, you have a few options when setting up the recipient profile. You could use a Slack Button, the user's Slack user_id, or the email associated with the user's account like we did in our Pigeon Weather example. To simplify setting up a recipient profile for a Slack direct message, we added the shortcut to allow you to use the email address. This method does require that you add the users:read and users:read.email scopes because Courier will do the user_id lookup for you using the Slack API. Now you can either supply the profile information to the send or live above, use the Profiles API to add the Slack profile to your recipient's profile.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 import { CourierClient } from "@trycourier/courier"; const courier = CourierClient({ authorizationToken: "<AUTH_TOKEN>" }); const { status: mergeStatus } = await courier.mergeProfile({ recipientId: "STANPINES97009", profile: { slack: { access_token: "xoxb-xxxxx", email: "stan.pines@themysteryshack.com", }, }, }); console.log(mergeStatus);

You can learn more about the different options for sending direct messages in our Slack documentation.

Feel free to remix our Pigeon Weather Glitch app and connect your Slack app to it and start sending Slack messages.  Then, check out our Jsonnet Courier Live to learn how to create messages using dynamic Block Kit elements.

Is there something you’d like to see us do using Courier? Let us know and it might be the subject of our next Courier Live. We stream a new Courier Live every Wednesday at noon Pacific. Follow us on Twitch to be notified when we go live.

-Aydrian

Subscribe

More from Courier Live

April 2021 Courier Live Release Notes Thumbnail
COURIER LIVE

Courier April Product Release Updates: In-app Inbox, Preferences, and Automations

In this update, Aydrian and Nate (Head of Customer Success) as cohosts cover what is new with the in-app...

Aydrian Howard

May 20, 2021

Courier Live Thumbnail
COURIER LIVE

Courier Live: Content, Notifications, and IoT

On February 2nd and 3rd, Shy Ruparel joined Aydrian for another Courier and Contentful crossover stream....

Aydrian Howard

February 10, 2021

Build your first notification in minutes

Send up to 10,000 notifications every month, for free.

Email & push notification

Build your first notification in minutes

Send up to 10,000 notifications every month, for free.

Email & push notification

Product

© 2021 Courier. All rights reserved.