README.md

Blueprint: Onboarding (app_home_opened event)

app_home_opened event example

🎥 High Resolution screencast

💻 Check out code example on Glitch

Examples

• Onboarding new users once they open your App's DM for the first time
• Send a help message with important Call-to-actions once they open your App's DM

Required App functionality

• Bot User
• Interactive Components
• Events API

Event subscriptions

• app_home_opened

1. Show a welcome message once users open your App's DM for the first time

• payload.json
• Open in Block Kit Builder

Methods

• chat.postMessage

2. Show a help message when a user opens your App's DM

Note: Only post a help message if there was some considerable time between the last interaction with the user and the last message wasn't a help message itself. Additionally give the user an option to opt-out of these messages by e.g. providing a "Don't show this again" button

• payload.json
• Open in Block Kit Builder

Methods

• chat.postMesssage

List of required scopes

• bot

Recommended usage

Message Type	Recommended
Public Channel	❌
Private Channel	❌
Thread	❌
DM	✅
Group DM	❌