N-Time Notification (Beta)

N-Time Notification (NTN) provides developer the flexibility to push any contents to the users as long as it is complied with the community standards and the users have opted-in to receive the push message.

Different from One-Time Notification, N-Time Notification (NTN) is requesting user's consent to send one message at a fixed time interval, and the notification token will last for a fixed period of time until expiry.

Business can manage the Notification Frequency and let user agree to recevie a push message on a regular basis:

Frequency	Description
DAILY	allow business to send 1 message daily for a span of 1 month
WEEKLY	allow business to send 1 message in 7 days for a span of 12 weeks
MONTHLY	allos business to send 1 message in 30 days for a span of 12 months

Prerequisite

Please note that N-Time Notification (NTN) is currently a feature in Closed-Beta. As a BSP, we are able to request approval in order to apply this feature on a Facebook page.

Therefore, before getting started, please send an email request to support@stellabot.com with the following information:

• Stella Organisation ID
• Link to your Facebook Page
• Facebook Page ID

---

What is your result?

1. The user enters the chatbot and triggers the N-time Notification Message.

User activates NTN.

2. The user clicks on the button to agree, a opt-in message is displayed.

User opts for NTN.

3. After getting opt-in, the business can now send push message to this user.

NTN is sent after a period of time

4. When the notification token is about to expire, an automatic re-opt-in request will be sent to user. This is a default setting of N-time notification, which cannot be customized by businesses.

Re-opt-in request when token is about to expire

Sample Tree Structure

Sample Tree Structure for N-Time Notification

---

Create a Tree Node - NTN Message

1. Create a Tree Node and name it as "N-Time Notification". This is the message that asks for user's consent, it comes with the content and a button.

N-time notification tree node

2. In the node inspector, create a new response.

Create Response

3. In the Response, select "Advacned" and enter the following code in "Response Object".

{
  "type": "NOTIFICATION",
  "title": "Welcome to Sanuker!🎉",
  "payload": "notification_tag",
  "frequency": "MONTHLY"
}

Property	Description	Required
type	NOTIFICATION	Y
title	String; text content	Y
payload	Custom defined payload trigger; Tag for Notification; Limited to 1,000 characters	Y
frequency	allowed frequency of sending message; either DAILY, WEEKLY or MONTHLY	Y

Create notification message

Create a Tree Node - NTN Opt-in

4. Create a Tree Node following the and name it as "N-Time Notification Opt-in". This is the message displayed after opt-in.

N-time notification Opt-in tree node

5. In the node inspector, select and enter "Trigger".

N-time notification Opt-in tree node

6. Create two new conditions with the following code.

this.messageEvent.type === "OPTIN"

Create Conditions

this.messageEvent.data.payload === "notification_tag"

Create Conditions

7. Create a new trigger with the two newly created conditions.

Create Trigger

8. Head to response, create the response for users who agree to receive notification.

Create Trigger

Create a Global Node - Trigger NTN

9. Create a Global Node, and name it as "N-Time Notification Request".

Create Global Node

10. Create a trigger for triggering the N-Time Notification button. In this example, we set up a keyword: "monthly".

Create Global Node

11. Toggle on Redirect, and redirect to the "N-Time Notification" node.

Create Global Node

Add Tree to Channel

12. Head to Channels, enter the Facebook channel by clicking "Edit".

Create Global Node

13. In Tree Settings, select "+ New Tree".

Please note that N-time notification is only available in Core Version v2.6 or above.

Create Global Node

14. Select the N-Time Notification tree from the dropdown, and select all the Global Nodes.

Create Global Node

Setting Up the Push: Create an NTN Audience

15. Create a "New Audience" and name the audience group.
16. Select the relevant Facebook Channel.

Create an NTN Audience

17. Select "Send to a group of members". Then, click "Criteria".

Send to a group of members

18. In the "Criteria", type the desired OTN Tag which you assigned previously and click the "Enter" key to confirm the tag.

Enter NTN Tag

19. Select "Confirm" to finish setting up the criteria.

20. Select "Save" and the audience group is created.

NTN Audience Group Created

___

Setting Up the Push: Sending the Push

21. Create the push with the audience group created for NTN.
22. Follow the step here to schedule the push.
23. Send a testing push to see if you can produce the Exepcted Outcome.

---