- 14 Feb 2023
- 1 Minute to read
- Updated on 14 Feb 2023
- 1 Minute to read
Use an integration trigger to ingest data from a third-party service into Torqvia a webhook (Torq endpoint). Create a trigger integration in Torq to get a webhook you can provide to the third-party service you want to get events from. Every service has its own process for providing a webhook so we recommend that you check out the Torq integration documentation for relevant information.Torq does not normalize or manipulate the trigger event JSON.
Here are a few common examples of integration events that can be used to trigger a workflow:
- Incidents being created, updated, or resolved by paging/on-call management systems.
- Tickets being created, updated, or closed by ticketing systems.
- Users being added, modified, or removed in identity management systems.
How to use
- Create a trigger integration with the third-party service you want to get events from (you can also use the webhook integration).
- Select the Integrations trigger when creating a new workflow.
You can also click on the replace icon above an existing trigger to change it to an integration trigger.
- Select the integration instance you want to get events from.
- Integration events can be viewed in the trigger Event Log.
- Use the trigger event data in workflow steps: $.event.<event_structure>. Test Run the workflow with an integration event to make sure your workflow is running as expected.
- Publish the workflow to have it execute automatically when a new integration event occurs. You can also apply trigger conditions.
Resend a trigger event
After an event JSON is received, you can modify and resend it. This enables you to test different trigger event parameters and scenarios to see how they impact the workflow.
- There are 2 ways to resend an integration event:
- Click Run Workflow if the workflow is published or Test Run in draft mode. Search for a specific event or select the last one.
- Go to the trigger Event Log, select an event, and click Resend.NoteTrigger events are available for 90 days up to a maximum of 30 events.
- Change the trigger event fields or their values as necessary and click Test Run.
You can apply conditions to specify which integration events will trigger the workflow. For example, specify an event type that will trigger the workflow. Events from the same integration with a different event type will not trigger the workflow but you'll be able to see them in the trigger Event Log.