Slack Integration
Conviva VSI Video supports Slack integration for manual and AI alert notifications. The integration uses Conviva webhooks together with a Slack workflow that starts from a webhook in Slack Workflow Builder. When a Conviva alert fires, Conviva sends an HTTP POST request to the Slack workflow URL, which then posts a message to the Slack channel you configure.
Key Capabilities
-
Deliver Conviva manual and AI alert notifications to Slack channels
-
Use Slack Workflow Builder to control message formatting and routing
-
Reuse the standard Conviva webhook configuration workflow in Settings
-
Map Conviva alert payload fields into Slack workflow variables for customized messages
Prerequisites
-
Access to Slack Workflow Builder with permission to create workflows that start from a webhook. Workspace owners and admins can restrict this capability.
-
A Conviva account with Admin access to configure webhooks.
-
Configured Conviva manual or AI alerts to route through webhooks.
Configure Slack Integration
Slack integration requires two setup steps: create the Slack webhook workflow, then add that webhook URL in Conviva.
Step 1: Create a Slack webhook workflow
In Slack, create a workflow that starts outside of Slack and receives HTTP POST requests from Conviva. For full Slack-side setup details, see Build a workflow: Create a workflow that starts outside of Slack.
-
Open Workflow Builder in Slack and create a new workflow.
-
Choose to start the workflow From a webhook.
-
Add workflow variables for the Conviva alert fields you want to include in Slack messages. Slack supports up to 20 variables with data types such as text, channel ID, user ID, and user email.
Note: Slack workflow variables do not support nested JSON structures. If you need custom fields at the top level of the Conviva payload, enable flatten webhooks in Conviva or map only top-level alert fields in your Slack workflow. See Example Webhook Payload Formats for payload structure details.
-
Add a workflow step to Send a message to a channel (or another supported action), and insert your workflow variables into the message content.
-
Publish the workflow and copy the generated web request URL. Slack workflow URLs start with
https://hooks.slack.com/triggers.Note: Keep the Slack web request URL secure. Anyone with the URL can start the workflow. Slack webhook workflows are limited to one request per second.
-
Send a test POST request to the Slack web request URL and confirm that the workflow posts to your target Slack channel before connecting Conviva.
Step 2: Configure the Conviva webhook
Use the Slack web request URL as the destination URL in Conviva webhook settings.
-
In Conviva, open Settings and click Webhooks.
-
Click Add Webhook.
-
Enter a webhook name and notification email addresses.
-
Paste the Slack web request URL into the Webhook URL field.
-
Select the alert types to include in the webhook payload and customize fields as needed.
-
Click Test Webhook to verify that Conviva can reach the Slack workflow URL and receive a successful response.
-
Click Save to enable the webhook.
For detailed Conviva webhook configuration, payload customization, retry behavior, and troubleshooting, see Setting Webhook Notifications.