To receive alerts and notifications in TrueFoundry, you need to set up notification integrations for Email and Slack Bot. This guide walks you through adding both types of integrations, describing each field in the forms, and providing helpful links for setup.

​
Email Notification Integration

To add an Email notification integration:

  1. Go to the Integrations Tab in the TrueFoundry UI.
  2. Click on ‘Add Integration Provider’.
  3. Select ‘Custom’ as the provider type.
  4. Choose ‘Email Notification Channel’ in the integrations section.
  5. Fill out the form fields as shown below:

​
Field Descriptions

  • Name: A unique name for this integration provider (e.g., “Production SMTP”).
  • Custom Basic Auth (Optional): Enable if your SMTP server requires custom authentication.
  • Display Name: The display name for this email notification channel (e.g., “Alerts Email Channel”).
  • From Email: The email address that will appear as the sender of alert emails.
  • SMTP Credentials:
    • Host: The SMTP server hostname (e.g., smtp.gmail.com).
    • Username: The username for SMTP authentication (often your email address).
    • Password: The password or app-specific password for SMTP authentication.
    • Port: The port for SMTP (commonly 587 for TLS, 465 for SSL, or 25 for non-encrypted).
    • TLS: Enable if your SMTP server requires TLS encryption (recommended for most providers).
  • Access Control (Optional): List of users or groups allowed to use this integration. By default, set to everyone.

Note:

  • For more information about SMTP and how to get your SMTP credentials, see What is SMTP? (Mailgun Docs).
  • If using Gmail, you may need to generate an App Password and enable “Less secure app access” or use OAuth2.

​
Slack Bot Notification Integration

To add a Slack Bot notification integration:

  1. Go to the Integrations page in the TrueFoundry UI.
  2. Click on ‘Add Integration Provider’.
  3. Select ‘Slack’ as the provider type.
  4. Choose ‘Slack Bot Token Integration’ in the integrations section.
  5. Fill out the form fields as shown below:

​
Field Descriptions

  • Name: A unique name for this integration provider (e.g., “Slack Alerts Bot”).
  • Display Name: The display name for this Slack bot integration (e.g., “Critical Alerts Bot”).
  • Bot Token: The OAuth token for your Slack bot. This is required for the bot to send messages to channels.
  • Access Control (Optional): List of users or groups allowed to use this integration. By default, set to everyone.

How to create a Slack Bot Token:

  1. Go to the Slack API: Your Apps page.
  2. Click “Create New App” and follow the prompts.
  3. Add the chat:write and chat:write.public scopes under “OAuth & Permissions”.
  4. Install the app to your workspace and copy the Bot User OAuth Token (starts with xoxb-).
  5. For more details, see the Slack Bot User OAuth Access Tokens documentation.

​
Access Control

For both integrations, you can restrict access to specific users or groups by editing the Access Control field. By default, it is set to everyone so all users can use the integration.

​
Final Steps

  • After filling all required fields, click Add Integration Provider to save your integration.
  • You can now use these integrations as notification channels when setting up alerts for your applications.

With these integrations in place, you can receive real-time alerts via Email and Slack for all your TrueFoundry applications!