How to use Segment events to power Knock
This guide covers using Segment as a Knock source to bring track and identify event data from Segment into Knock to power your notifications.
Knock also provides a separate Segment extension for sending Knock notification data into Segment for use in your downstream tools.
Getting started
When using Segment as a Knock source, you also need to configure Knock as a destination within Segment. This means you can use events coming through Segment to power actions in Knock, such as triggering a workflow.
To start routing your Segment events to Knock, click the "Create Source" button in the Knock dashboard under the Integrations > Sources section and select Segment. Once created, select it from the list to navigate to the environment configuration page, where you can copy the unique webhook destination URLs for each environment you have configured in Knock.
Configure a Knock destination in Segment
Add webhook destination in Segment
In your Segment workspace, navigate to the Destinations tab and click "Add Destination." From here, search for Webhooks or navigate to Raw Data in the sidebar and click the "Webhooks (Actions)" option. This is the destination type we'll use for Knock.
Configure webhook
Click the "Configure Webhooks (Actions)" button in the top right to enter the setup flow to configure your webhook:
- Select the data source you'd like to receive events from and click "Next."
- Give a name to the destination, like "Knock," and keep the "Fill in settings manually" option selected, then click "Create destination."
Save changes
Now you'll see a Settings page. Check the "Enable Destination" button and click "Save changes."
Add mapping
At the top of the page, navigate to the Mappings tab. Click "New Mapping," and under Actions, click "Send".
You will then be directed to a form to configure the webhook:
- Select the events to map and send to Knock. If you'd like to send all events to Knock, you can add the condition Event type is Track, a condition for Event type is Identify, and change the top operator to any instead of all:
- You can load a test or sample event; either way, ensure it matches your trigger conditions (Segment will warn you if it doesn't).
- Click "Test Mapping" to send the loaded or sample event from the previous step to Knock.
- If the test is successful, click "Save" to exit the form, and then click to enable the mapping you just created.
Viewing Segment track events in Knock
Once your Segment destination is set up, all events you trigger from the Segment source will be forwarded to Knock. Unique events will appear in your list of events under the Source so that you can set up triggers for your workflows.
From the source environment configuration page, click the "View in environment" button on one of the source environments. You'll be taken to the Segment source in the environment you selected, and you should see events sent. If you don't, try clicking the refresh button at the top of the list to refetch any incoming events.
Triggering workflows from received events
You can add a track event as a trigger to your workflow directly from the workflow builder. Click on the workflow's trigger step and change the type from "API" to "Source Event." Then you'll be able to select the event and map its properties into the data the workflow needs.
actor in the workflow, then in the actor field, you would write properties.commenter.id to supply their ID as the actor.If you wanted to supply the event's
userId as the workflow's recipient, you'd write userId in the Recipients field.Note: when you edit message templates, all
properties are available to you as data variables. You can access them directly in your templates without the properties. prefix.Read more on configuring workflow triggers
Disabling a trigger
Triggers are automatically enabled when you create them. If you want to stop an event from triggering a workflow, you can go to the trigger page and toggle its status to "Inactive." Keep in mind that this will disable that trigger for the current environment only. When you're ready to trigger the workflow again, you can set it back to "Active."
Enabling Identify events
When Segment sends identify events, Knock will create and update user information accordingly. Knock will correctly map the id, email, phone, avatar, name, and any other custom properties.
To enable the handling of identify events, open the settings for the source in the environment. You can then enable or disable handling identify events accordingly.
For use cases such as new signup events, where events often reach Knock before identify calls, consider inline identification of users in your Segment events.
Inline identify users in a Segment event
In cases where you send a Segment event to Knock with recipients who may not yet have been identified in our system, it's good practice to inline identify your users. By inline identifying your users within your Segment events, you ensure that those users are identified in Knock when your event triggers a workflow.
As an example, take the user-signed-up event below. We're currently mapping the properties.recipients field to the recipients field of our workflow in Knock. If we send this event to Knock before the user with id sam10 has been identified, the user will not be notified.
To ensure the user is notified, we'd change the id reference in recipients to a complete user object, as in the example below. This way, Knock has all the information it needs to identify the user during workflow runtime.
You can learn more about inline identification in our guide on identifying recipients.