Send trigger alerts to email, Slack, Discord, Google Chat or Telegram, so the right people hear about problems wherever they work. Chat alerts are delivered by Foreman's bot, Todd.
Before You Start
- Create the trigger first. See Quick Guide: Alerts & Triggers.
- For chat apps, you'll need your Client ID and an API key. Find them under the user menu (top right) > My Account > API Information. The Client ID is different for each client, so switch to the right client first.
- For Slack, Discord and Google Chat, you need permission to add apps to the workspace, server or space.
Step 1: Choose the Destination in Your Trigger
- Go to Alerts & Triggers and open or create a trigger.
- Under What to Do, select Send Alert.
- Under Destinations, choose one or more of All Emails, Specific Emails, Slack, Discord, Google Chat or Telegram, then save.
All Emails goes to every user on the client who has Subscribed To Alert Emails turned on in My Account. Specific Emails goes only to the addresses you enter.
Step 2: Connect Todd to Your Chat App
Each person or channel registers once. After that, Todd posts every alert from triggers that send to that app.
Slack
- Install Todd from slack.foreman.mn/slack/install, choose your workspace, and click Allow.
- Add Todd to the channel: open the channel's details, go to Integrations, click Add an App, and add Todd.
- In the channel, type
/foreman_start, then/foreman_register <Client ID> <API key>. - Type
/foreman_helpto see all commands. To stop alerts, type/foreman_forget.
Discord
- To get alerts in your own server, invite Todd to your server. For direct messages instead, join the Foreman Discord server and message Todd there.
- In a channel Todd can read, or in a direct message, send
fm!start, thenfm!register <Client ID> <API key>. - Send
fm!helpto see all commands. To stop alerts, sendfm!forgetor remove Todd from your server.
Google Chat
- Open the space where you want alerts, click the space name, choose Add people & apps, search for Foreman Todd, and click Add.
- In the space, type
/start, then/register <Client ID> <API key>. - Type
/helpto see all commands. To stop alerts, type/forget.
Telegram
- Direct messages: open @ForemanToddBot, click Start, and enter your Client ID and API key when Todd asks.
-
A channel: add Todd to the channel as an admin, type
/start, and enter your Client ID and API key when prompted. - A green check confirms the setup. To stop alerts, send
/forget, or remove Todd from the channel.
Check It Works
Make a test trigger that will fire right away, for example a Time Interval trigger with Send Alert to your new destination. Once the alert arrives, delete or turn off the test trigger.
Common Problems
| Symptom | Likely cause | Fix |
|---|---|---|
| No chat alerts | The trigger doesn't send to that app | Check Destinations in the trigger's Send Alert action. |
| Registration fails | Wrong Client ID or API key | Copy both again from My Account > API Information, for the client you want alerts from. |
| No alert emails | Not subscribed, or filtered as spam | Turn on Subscribed To Alert Emails in My Account and add Foreman to your allowed senders. |
See the Foreman privacy policy for how Todd handles your data.
Last verified: November 19, 2026