Integration trigger
  • 14 Feb 2023
  • 1 Minute to read
  • Dark

Integration trigger

  • Dark

Article Summary

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

  1. Create a trigger integration with the third-party service you want to get events from (you can also use the webhook integration).
  2. Select the Integrations trigger when creating a new workflow.
    Create an integration triggerYou can also click on the replace icon above an existing trigger to change it to an integration trigger.
  3. Select the integration instance you want to get events from.
  4. Integration events can be viewed in the trigger Event Log.
  5. 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.use event data in workflow steps
  6. 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.

  1. 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.
      Trigger events are available for 90 days up to a maximum of 30 events.
      resend a trigger event
  2. Change the trigger event fields or their values as necessary and click Test Run.
    edit a trigger event

Trigger conditions

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.
apply trigger conditions 

Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.