Skip to content

Slack integration

The Coralogix Slack integration connects Coralogix Cases to your Slack workspace, so on-call teams can triage and resolve incidents in the channels they already work in. On v0.1.0, Case notifications post to Slack, replies in the thread flow back into the Case timeline, and pasting a Coralogix Case URL into any channel where the bot is present renders a rich preview with status and priority.

This page is the setup hub for the integration. Two adjacent pages own the rest:

  • Working with Cases covers the Case-side experience: what Slack notifications look like in a Case, how synced comments appear in the timeline, and per-Case controls.
  • Slack connector configuration covers channel routing, dynamic templating, and fallback channels for anything Coralogix sends to Slack, including Case notifications.

Why v0.1.0

v0.1.0 is in public preview and is the default version for new Slack integrations. It brings Cases capabilities that earlier versions cannot offer, along with operational improvements that apply to every notification flow:

  • Two-way comment sync with Cases. Slack replies on a Case notification become comments in the matching Case timeline, so the conversation that resolved the incident is preserved with the incident itself.
  • Choice of reply mode for Case updates. Post each Case update as a new message in the channel or as a reply in the existing notification thread, configured per Case.
  • Rich link previews for Coralogix Case URLs. Any time a Case URL is shared in a channel where the bot is present, Slack renders the Case status and priority inline so context follows the link.
  • Higher Slack delivery throughput. The new app has better rate limits with Slack, which reduces throttling on busy workspaces.
  • Installable without Slack admin scope. Workspace members without Slack admin permissions can install the app.
  • Same Slack delivery for everything else. Anything Notification Center sends to Slack, including alert notifications, continues to flow through this integration. No change to existing routing rules or connectors.

To start using v0.1.0, add a new integration on v0.1.0. Your earlier-version Slack integration keeps running, and you can migrate each Notification Center connector to v0.1.0 one at a time. Both versions can run in parallel during the cutover.

Coming soon

  • Alert evaluation chart visible directly in the Slack notification (optional).

After Slack Marketplace certification

Certification is a Slack-side review of the app listing, currently in progress. The integration is fully supported for production use during the review, and certification does not change how the integration behaves in your workspace.

When certification completes:

  • Existing customers see a one-time re-approval prompt. The prompt can be completed at any time and is not required to keep using the app.
  • No breaking changes are expected.
  • The app remains the default for new Slack integrations.

Prerequisites

To configure this integration in Coralogix, ensure you have:
ResourceActionDescription
integrationsReadConfigView deployed integrations.
integrationsManageAdd, remove, or update integration packages.

Learn more about Coralogix roles and permissions in Access control permissions.

To install the Coralogix Slack app in your workspace, you also need permission to authorize Slack apps in that workspace.

Set up the integration

Add a new Slack integration

  1. From the Coralogix toolbar, go to Data Flow, then Integrations.
  2. Select Slack.
  3. Select Add New. The current version is shown on the button, for example Add New (v0.1.0).
  4. In Settings:
    • Enter an Integration name.
    • Under Application functionality, select what this integration should handle: Send notifications, Collect access logs, or both.
    • When Send notifications is selected, the Notification settings section appears. Select Two-way comment sync to enable replies on a Slack thread to flow back into the Coralogix Case timeline.
    • Confirm Consent to U.S. data transfer.
    • Select Create.
  5. In Install the Coralogix Application:
    • Select Authorize.
    • On the Slack authorization page, review the scopes and select Allow. See OAuth scopes for what is requested and why.
    • Select Close.
  6. In Application Setup:
    • Select Create New Connector to add the first Slack connector. The connector defines the destination channel and routing behavior; for the full field reference, see Slack connector configuration.
    • Select Save.

The integration is now installed and ready to be referenced from Case notification settings and Notification Center routing rules.

Migrate existing connectors to v0.1.0

v0.1.0 is a new integration that runs alongside any earlier-version Slack integration you already have. Each Notification Center connector references one integration, so the cutover is per-connector. Migrate one connector at a time with no downtime.

  1. Add a new Slack integration on v0.1.0. The earlier-version integration keeps delivering notifications through every connector that still references it.
  2. In Notification Center, open a Slack connector that references the earlier-version integration.
  3. In the connector's Integration field, select the new v0.1.0 integration.
  4. (Optional) Run Send test notification to confirm the connector delivers through the new integration.
  5. Save the connector.

Repeat for each Slack connector. Connectors not yet migrated continue to deliver through the earlier-version integration, so both versions run in parallel during the cutover. Once every connector is on v0.1.0, you can remove the earlier-version integration.

OAuth scopes

The Coralogix Slack app requests OAuth scopes from Slack based on the features you enabled. Scopes are grouped by functionality.

New Coralogix Slack app

These scopes are always requested when installing the Coralogix Slack app for Cases and Notification Center:
ScopeReason
chat:writePost notification messages to configured Slack channels.
chat:write.customizeCustomize message appearance (avatar, name) when posting.
chat:write.publicSend notifications to channels without requiring the bot to be invited first.
users:readResolve Slack user identity when a user interacts with a Case notification.
users:read.emailMatch the Slack user's email to their Coralogix account for permission checks on Case interactions.

Notifications

These scopes are requested per feature when configuring Cases or Notification Center. Each is optional and used only when you enable the corresponding feature.
ScopeFeatureReason
channels:joinTwo-way comment syncAfter posting a notification to a public channel, the bot joins the channel to read thread replies.
channels:historyTwo-way comment syncRead thread replies on Coralogix notification messages in public channels to surface them in the Coralogix Case timeline.
groups:historyTwo-way comment syncRead thread replies on Coralogix notification messages in private channels to surface them in the Coralogix Case timeline.
links:readRich link previewsDetect Coralogix Case URLs shared in Slack to trigger preview generation.
links:writeRich link previewsDisplay a rich preview when a Coralogix Case URL is shared in Slack, showing Case status and details inline.

Slack Access Logs

When you enable Slack Access Logs collection, the integration additionally requests these scopes:
ScopeReason
openidConnect the Slack user account with the Coralogix account and determine additional user details.
adminRead access logs for the current team and forward them to Coralogix.

What the integration unlocks

The integration is the workspace connection; the user-facing behavior lives in the product that consumes it.

Case notifications in Slack

Once the integration is live and a connector is configured, Case notifications post to Slack from the channels you defined in the connector. For per-Case notification settings and how Case events map to Slack messages, see Working with Cases.

Two-way Case comment sync (v0.1.0)

When Two-way comment sync is enabled on a v0.1.0 integration, the Coralogix Slack app subscribes to thread events on the messages it posted and writes replies into the matching Case timeline. The integration handles the Slack-side requirements:

  • The bot joins public channels automatically the first time it posts there, using the channels:join scope.
  • For private channels, invite the Coralogix Slack app to the channel before sending notifications there.
  • Slack users are mapped to Coralogix users by email when the Slack email matches a Coralogix account.

How synced comments appear in a Case timeline, and the controls for muting or unmuting sync per Case, are documented in Working with Cases.

Rich Coralogix Case URL previews in Slack (v0.1.0)

When a Coralogix Case URL is shared in any Slack channel where the bot is present, Slack renders a rich preview with the Case status, priority, and a short summary. The preview updates when the Case status changes. No per-Case configuration is required; the capability is active as long as the app is installed with links:read and links:write granted.

Alerts and other Notification Center routing

Notification Center routing rules that target Slack go through the same integration. Channel routing, dynamic templating, and fallback behavior for alert notifications and any other Notification Center traffic are configured in Slack connector configuration. See Notification Center overview for routing rule setup.

Manage your integrations

Each row in the Slack integrations list shows the Integration Name, Status (Active, Pending, or Failing), Integration Version, Application Functionality, the number of Connectors, Last Updated, and Actions.

Versions earlier than v0.1.0 are shown alongside v0.1.0 in the list, so a workspace can run a mix of versions during a migration window. Update integrations to v0.1.0 when you are ready; integrations on older versions continue to deliver outbound notifications and Slack Access Logs but cannot offer two-way Case comment sync or rich Case URL previews.

To edit an integration, use the pencil icon. To remove it, use the trash icon. Removing an integration also removes its connectors, and Case notification settings or Notification Center routing rules that referenced those connectors stop delivering until they are reconfigured.

Troubleshooting

SymptomCauseResolution
Status shows Failing in the integrations listThe app token was revoked or the workspace removed the Coralogix Slack app.Open the integration and reinstall the app.
No Case timeline updates from Slack repliesThe integration is on a version earlier than v0.1.0, Two-way comment sync was not enabled at install, or the bot is not a member of the channel.Update the integration to v0.1.0 and enable Two-way comment sync. For private channels, invite the bot to the channel.
Coralogix Case URLs do not preview in SlackThe integration is on a version earlier than v0.1.0, or links:read and links:write were declined during install.Update to v0.1.0 and reauthorize the Slack app.
Case notifications post to the wrong Slack channelThe connector is routing to a different channel than expected.Review the connector. See Slack connector configuration for channel routing and dynamic templating.
Banner says v0.1.0 is pending certificationSlack Marketplace certification is in progress.The integration is available for production use; no action required.

For Case-side notification configuration issues, see Working with Cases.