Creating a topic subscription for the Zapier integration
You can create topic subscriptions to notify Zapier whenever a relevant event occurs related to the subscribed topic. Once created, the subscription appears in Zapier as a webhook trigger for use as the first step of a zap.
To create a topic subscription for the Zapier integration:
- Click > Admin > Zapier.
- From the Create list, select Topic Subscription, then click New.
- Enter an internal name for this asset. Brightspot uses this name internally, such as in the search panel and recent activity widget. This name is not visible to visitors to your site.
- In the Description field, enter a description about what this topic subscription achieves, such as
Webhook trigger when an asset is translated
. - In the Zapier Label field, enter a value that will appear when creating actions in Zapier. Use something short but descriptive of the what the query achieves (for example,
Article Translation Events
). - Under Topic, select a notification topic. For an example of a topic subscription to translation events, see the note below.NoteSee the following example of a topic subscription to article translation events. According to this example, any time an article is translated by any service, has any translation status, and is created by anyone, Brightspot sends a trigger to Zapier.
To create an article translation event topic notification:- Under Topic, select Translation.
- Under Translations Filter, click Add Services & Statuses.
- Under Translation Service, Translation Status, and Translation Creator, retain the default values (All Services, All Statuses, and Any Creator, respectively).
- Under Content Filters, click Add Sites & Types.
- Under Sites, retain the default (All Sites).
- Under Types, select Article.
- Depending on your selection, fill out additional configuration fields. For details, see Subscriptions to topics.
- Under Sample Data, do one of the following:
- Retain Auto Generated to have Brightspot automatically generate and send random sample data to populate the test record in Zapier.
- Select Custom to manually populate the data in the test record in Zapier, then do the following:
- Under the second Sample Data field, select Set, then enter values into the Content ID and Content Label fields and select a status under the Status field.
- Click Publish.
Once published, this topic subscription appears in Zapier as a webhook trigger for use as the first step of a zap.
Note
Once published, check the Debug tab to view the associated Zapier webhook address for this topic subscription.
Note
Once published, you may view analytics pertaining to this asset in the Analytics tab. The tab includes when it was last used, its success count, the number of its total requests, and the number of errors it has generated.