Triggering campaigns

Depending on the type of your campaign, you must set up different campaign triggers: manual, scheduled, remote action, or via API.

Triggering a campaign manually

To manually trigger a campaign, you must:

  1. Grant Trigger manually all campaigns or share a campaign with trigger permission.

  2. Configure the campaign for a Manual trigger.

Refer to the Manage Campaigns documentation for more information.

To manually trigger a campaign from the list of results of an NQL query on users on the Investigations page:

  • Select a user or a set of Users from the list on the Investigations page.

  • Choose Launch campaigns from the action bar at the button of the page. A list of the available campaigns pops up.

  • Select the campaign and click Send.

    • A warning message appears displaying the number of targeted employees selected and asking for confirmation. If the campaign has parameters, you must provide a value for each parameter on the Send campaign popup window. Click Yes to proceed.

    • If all employees have a valid user SID, a validation message confirms the system has triggered the campaign.

    • If there is a mix of employees with valid or invalid SIDs, a warning message confirms that the system can only trigger the campaign for those employees with valid SIDs.

    • If all employees have an invalid SID, an error message confirms that the system cannot trigger the campaign.

Refer to Types of campaigns documentation for information on parameters for manual and API campaigns.

Triggering a scheduled campaign

Once you publish a scheduled campaign, the evaluation of the NQL query defined in the Schedule tab of the Edit campaign page begins.

The query will be re-evaluated, relative to the time it was first published, daily or hourly, depending on the option Only once or Again after that was selected, according to the following rules:

  • Only once: the campaign will only be sent once, and will never recur. Use this option, for example, for employee onboarding campaigns, one-time surveys or notifications, and other one-time communications. With this option, the system evaluates the NQL query every 24 hours from the time the campaign is published, to ensure only the employees who have not yet answered or declined the campaign receive it.

  • Again after: the option to enable recurring campaigns. Use it, for example, for proactive fixes, a reminder to restart computers regularly or for surveys that need to be sent at specific intervals. To provide more immediate feedback, the system evaluates the campaign every hour. To protect employees from unnecessary interruption, they will not receive the campaign if they have already answered it or declined it within the selected timeframe. For example, if you choose the campaign to be resent again after one week, the system will resend it seven days after the employee has either answered or declined the campaign. If you choose one month, the system will resend it 30 days after the employee has either answered or declined the campaign.

To randomly select a different sample of employees to continuously collect the sentiment data, set up the query below. Replace #dex_campaign_name with the NQL ID of the campaign and adjust the limit below set as 50 to specify the number of new users the campaign targets every hour.

Note that you need to:

  • Define the trigger Schedule and select Only after the (minimum) number of days you want to have in between responses for each employee

  • First, save the campaign at least once before you can use the below NQL query, so that the system is aware that your campaign exists and does not generate a Table does not exist error when validating the NQL query.

| include campaign.#dex_campaign_name.responses
| compute number_of_requests = count()
| sort number_of_requests asc
| limit 50

Triggering a remote action campaign

Once you have published a remote action campaign, add its NQL ID to the remote action’s scripts to trigger the campaign.

Retrieving campaign NQL ID

Nexthink recommends using NQL ID as a campaign identifier if you use Collectors version 23.5 or higher. You can still use campaign UID for compatibility reasons.

Retrieving campaign UID

  • Select Campaigns from the main menu.

  • Choose the campaign you wish to connect to from the navigation menu.

  • Locate the UID of the campaign as part of the URL and copy it for the remote action.

Finding UID in Campaigns

Triggering a campaign using the API

Trigger campaigns using the Nexthink Campaigns API, giving you the flexibility to create integrations with external applications. For parametric campaigns, specify the values of each parameter defined for the campaign. Visit the website to learn more.

Last updated