Skip to main content

​
Intro

You can start a Campaign from a Domo DataSet Alert. Documentation on Domo DataSet Alerts can be found here.

​
Setting up a Domo DataSet Alert with Campaigns

​
Go to DataSet Alerts

To setup a Domo DataSet Alert, go to Data, select your DataSet, select the Alerts tab, and click on New Alert.
Alerts.PNG

​
Configure your Alert

Configure your Alert Rule. Documentation on setting up your Alert can be found here.
Note: B e sure to go to the “You’ll be notified when this alert is in a triggered state every time your data updates:” section and Uncheck the check box “Keep sending notifications while in a triggered state”. Otherwise, your Campaign could be triggered over and over again and you could end up spamming your recipients.
Continue_Triggering.PNG
Click Next when finished.

​
Create a Domo Webhook

The next step is to create the Domo Webhook that will be triggering your Campaign. In the Message screen, click Attach Action and select Domo Webhook.
Domo_Webhook.PNG

​
Configure the Domo Webhook

Next:
  1. In the box titled URL, paste the following URL: https://campaigns-prod.domolabs.io/api/v1/campaigns/bae/start
  2. Set Method to POST.
  3. Leave the box Secret (optional) blank.
  4. Click on Webhook body to expand that section.
Configure_Webhook.PNG

​
Configure the Domo Webhook body

In order to configure the Domo Webhook body, you need to click the pencil icon next to Message.
Pencil_Icon.PNG
In the Customize the webhook’s body’s message section, paste the following JSON: 
{
 "campaignId": 0, 
 "instance": "", 
 "domoAccessToken": "", 
 "domoAccessTokenOwnerEmailAddress": "", 
 "emailAddresses": [""], 
 "isTest":true,
 "fields":[{"key": "", "value": ""},
           {"key": "", "value": ""},
           {"key": "", "value": ""}]
}
Json_Body.PNG
Each of the values should be defined as follows:

​
Campaign Id

The id of the Campaign you want to start. You can get the Campaign Id by editing the Campaign and going to the Settings tab:
Settings.PNG

​
Domo Access Token

A Domo access token that has been generated in Domo. You can generate Domo Access Tokens by logging in, going to the Admin settings section, go to Security, and selecting Access tokens. There you can simply generate a new access token to use for calls to the API.
AccessToken.PNG

​
Domo Access Token Owner Email Address

The email address of the user who owns the Domo Access Token specified above.

​
Email Addresses (OPTIONAL)

A list of email addresses the campaign should be delivered to. If no email addresses are selected, the entire campaign will be started and delivered to all recipients in the distribution list.
Note: T hese email addresses MUST exist in your distribution list. If you specify an email address that does not exist in your distribution list, no email will be delivered to that email address.
Tip: You can use the + Metric button to include values from the row in the DataSet that triggered this Alert. For instance, if you want to only deliver this Campaign to the email address in the row in the DataSet that triggered this Alert, you would click on + Metric and select the field in your DataSet that contains the email address.
Email_Metric.PNG
This will add a tag to your webhook’s body’s message that will reference that field in your DataSet. Now when this Alert is triggered, the email address from the row that triggered the Alert will be included in the message that is sent to Campaigns. This will cause the Campaign to only be delivered to that email address. Again, please note that the email address MUST exist in your distribution list or the email will not be delivered.

​
Instance

You Domo instance (e.g. domo.domo.com ).

​
Is Test (OPTIONAL)

You can use this flag to send a test Campaign. This can help you test your Campaign, connection, access token, etc. without actually sending an email to your recipients. This is the same functionality as when you click the Test Email button from within the Distribution List in the Campaigns app. When you send a test Campaign the email will be delivered to the Sender Address of the Campaign rather than the recipients so that the delivered content can be tested and verified.
Note: If you set this flag to true, you MUST specify at least one email address in the Email Addresses field. You cannot send a Test Campaign without specifying at least one email address.

​
Fields (OPTIONAL)

Fields give you the ability to pass other information and values from the Alert to Campaigns so that information can be used in the Campaign messages. For instance, if the DataSet to which I am adding this Alert has a field for first name and last name and I want to include those fields in my Campaign, I would include those fields from my DataSet in the fields list. You can then use the key to insert those values into Campaigns.
Fields_Example.PNG
Then I would go to my Campaign and add the following tag into my Campaign anywhere I would want my Alert fields to be rendered. 
{{domo-alert-[field key goes here]}}
So anywhere I want first name rendered I would add the tag 
 {{domo-alert-first name}}
and anywhere I want last name rendered I would add the tag 
{{domo-alert-last name}}
In Campaigns it would look like this:
In_Campaigns.PNG
Note: To avoid failures and issues, make sure the name of your key in your DataSet Alert exactly matches the name in your Campaigns tag.
Match.png

​
Example of Webhook’s Body’s Message

An example of a completed webhook’s body’s message would look like this:
Example.PNG

​
Testing and errors

​
Testing

Once you have your webhook’s body’s message configured, you can test it by clicking on the Send Test button.
Send_Test.PNG
This will call the endpoint in Campaigns with your custom webhook’s body’s message and will notify you if the call succeeded or failed.
Note: b e sure to have the isTest flag set to true and include at least one email address in the emailAddresses field so you don’t accidentally deliver this Campaign to all of your recipients.

​
Errors

If your test does not succeed, there are a number of things to check. A few of them are:
  1. Ensure your Campaign Id is correct.
  2. Ensure you have a valid Domo Access Token specified in the domoAccessToken field.
  3. Ensure the Domo user who owns the Domo Access Token has access to the Campaign and the Campaign’s distribution list DataSet.
  4. Ensure the email address specified in the domoAccessTokenOwnerEmailAddress field matches the email address of the user in Domo who owns the Domo Access Token.
  5. If the isTest flag is set to true, ensure you have included at least one email address in the emailAddresses field.
  6. Ensure your webhook’s body’s message is a correctly formed JSON object. There are a number of JSON validators available online that you could use to check.