Integrating Beam with Slack

Overview

This guide explains how to integrate Beam with your Slack workspace using an Incoming Webhook. Once configured, Beam will send alerts and notifications directly to a designated Slack channel.

This integration leverages Slack’s Incoming Webhooks feature, as documented in Slack’s official guide:

https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks/

Prerequisites

Before starting, ensure you have:

• Admin or appropriate permissions in your Slack workspace
• Access to Beam with permission to edit account settings

Step 1: Create a Slack App

1. Visit the Slack API apps page: 👉 https://api.slack.com/apps
2. Click Create New App.
3. Select From scratch.
4. Provide:
   • App Name (e.g., “Beam Alerts”)
   • Workspace where notifications should be delivered
5. Click Create App.

You will be redirected to the Slack App Dashboard.

Step 2: Enable Incoming Webhooks

1. In the Slack App Dashboard sidebar, click Incoming Webhooks.
2. Toggle Activate Incoming Webhooks to On.

Incoming Webhooks allow external systems like Beam to send HTTP POST requests that deliver messages directly into Slack channels.

Step 3: Create a New Webhook

1. Click Add New Webhook to Workspace.
2. Select the Slack channel where Beam alerts should be posted.
3. Click Allow.

Slack will generate a unique Webhook URL for that channel.

You will now see:

• The newly created Webhook
• The connected Slack channel
• A generated Webhook URL

⚠️ Treat this Webhook URL like a secret. Anyone with it can post messages to your channel.

Step 4: Connect Slack to Beam

Once the webhook is confirmed working:

1. Copy the Webhook URL (not the entire curl command — only the URL).
2. Log into Beam.
3. Navigate to: Configuration -> Account Settings

4. Scroll to the Integration section.
5. Locate Slack Alerts.
6. Click Connect.
7. Paste the Webhook URL.
8. Click Connect again to confirm.

Result

Beam is now successfully integrated with Slack.

From now on, when a ticket is created Beam will automatically send an alert in your Slack channel.

Troubleshooting

No message appears during testing

• Ensure Incoming Webhooks are activated.
• Confirm the correct Slack channel was selected.
• Verify the full webhook URL was copied.
• Remove extra spaces when pasting the URL into Beam.

Slack permission errors

• Confirm you have permission to install apps.
• Contact your Slack workspace administrator if necessary.

Best Practices

• Create a dedicated channel (e.g., #beam-alerts) to prevent clutter.
• Name the Slack app clearly (e.g., “Beam Notifications”).
• Rotate the Webhook if it is ever exposed.