Triggering a Notification Event

A notification event that has been successfully created and saved can be run or executed by hitting the cURL request.

From the Notification Events section:

Notification Event Playground

The notification playground allows you to visualize, trigger and view logs of the test notification that you have triggered from Fyno’s application.

Let’s have a look at the Notification Playground and how to use it most efficiently.

In the Notification event playground, you will see the following:

• Notification Event: Gives you the option to select a notification event from the ones you have created, in a drop-down. Select the one you would like to trigger. You can also open the notification event in a separate browser by clicking on the icon next to the Event name.

• Trigger using: Select one of the destination options:

  • Distinct ID - Distinct ID is the user profile identifier unique to that recipient. Use this only if you manage Distinct Id in your user profile.
  • Destination: On selecting manual you would be able to add one of the below details for the recipient.
  • Both: The API will understand to accept either the Distinct ID or the recipient details directly.

• Additional data: This allows you to provide the data for testing the “Placeholders” with dynamic values, which would have to be written in JSON.

• Receive Delivery Report - Select this option if you want to check if delivery report is sent to Allowlist URL. You can read more about it here.

• Preview: The Preview tab shows the details of the notification that is about to be triggered. You can see how it looks for each channel by clicking on the respective icon. For Email, you can preview both Desktop and Mobile views.

• Preview with Conditional Templates : If you have used conditional templates in the notification event, you will see the Preview, as shown below. The template will be selected based on the satisfaction of a particular condition.

  • Using Template: “Template_name” (template version)
  • because “placeholder” matches the condition

  

• Code: The code tab displays the cURL command that has been generated for this Notification Event and can be copied and placed into your code easily.

• Logs: When the notification event is triggered, the logs that would be generated can be seen on the logs tab as well for a quick overview of the status.

Copy your All-In-One API

Under the Code tab, you will be able to copy the API by clicking on the Copy button on the top right corner of the cURL window.

Test your All-In-One API

From the same notification event’s playground, find the “Test notification” button on the bottom left.

Use Batch Send

Batch Send or Batching allows you to use the same Notification Event API to send information to multiple users, like a campaign.

When creating a Notification Event, if the check box is marked for Use Batch Send, then this Notification Event API can be used like a campaigning or bulk send API.

How to receive delivery reports

If you want to receive delivery reports in your system or any third party tool, you need to send callback object in the API call as shown below:

1
{
2
   "event": "YOUR_EVENT_NAME",
3
   "to": { // you channel destination },
4
   "data": {  // your template placeholders  },
5
   "callback": {
6
       "enable":true,
7
       "custom_id": "YOUR_CUSTOM_ID_VALUE",
8
       "custom1": "YOUR_CUSTOM_VARIABLE_1",
9
       "custom2": "YOUR_CUSTOM_VARIABLE_2",
10
       "custom3": "YOUR_CUSTOM_VARIABLE_3",
11
       "allowlist_url": ["DynamicWebhookSite", "Mixpanel"]
12
    }
13
}