Slack Event API for Bot Mentions

Question

I\'m building a Slack bot using a Slack App. I have managed to authorise and am successfully receiving events via the Event API.

I\'m trying to find out how to listen

Answer 1

You can choose to subscribe either to Team events or Bot events in your app configuration (Event Subscription). For your case I would recommend to subscribe to bot events.

Then you need to subscribe to an event type. Since you want your bot to listen on all kinds of channels you want to subscribe to message.channels, message.groups, message.im and message.mpim. Don't forget to requested the corresponding scopes when installing your Slack app.

Your bot will now receive event requests for all messages that are posted in any channel (public, private, direct message, directmessage group) that your bot is a member of.

As last step you have to filter and parse those event requests so that your bot only reacts to @-mentions.

UPDATE October 2018

Slack now also supports a special event type that lets you subscribe to bot mentions only: app_mention

So if you only want to receive bot mentions you do not need to subscribe to any of the other events (message.channels, message.groups, message.mpim) anymore.

However, if you also want to get direct messages to your bot you still need to subscribe to message.im.

Answer 2

Subscribe to the app_mention event instead of the message.channels to receive events mentioning your app/bot.

Here's an example payload from slack:

{
    "type": "app_mention",
    "user": "U061F7AUR",
    "text": "<@U0LAN0Z89> is it everything a river should be?",
    "ts": "1515449522.000016",
    "channel": "C0LAN2Q65",
    "event_ts": "1515449522000016"
}

Subscribe to the message.im also if you want to receive Direct message events.

More info on the app_mention event - https://api.slack.com/events/app_mention

Hope that helps :)