This Pro feature is currently a developer solution 🤓 but it will soon be a simpler, no-code solution. 🍰
The One-Time Notification API allows you to send one additional message to users after the 24-hour standard contact window has ended.
Keep in mind that this feature allows for exactly one message. However, users can subscribe to multiple One-Time Notifications (OTNs) from your Messenger bot (e.g. a back-in-stock alert AND an alert for the launch of a new collection). You’ll need to get consent from the user for each one, and you’ll need to get it within the 24-hour window.
If you get consent but don’t send the notification within one year, the permission will expire. If that happens, you’ll have to request consent from the user again.
When to use a One-Time Notification
Facebook’s Messenger policy outlines a small range of specific use cases for One-Time Notifications. (You’ll notice that they’re especially useful for ecommerce businesses! 🛍) A few examples include:
- A price drop
- A back in-stock alert
- A collection launch
- Tickets now available for purchase
Requesting permission to send One-Time Notifications
Before you can send One-Time Notifications, you need to be granted permission from Facebook to access the beta. Apply for this from 'Messenger Platform' > 'Advanced Messaging Features' For pages connected to Business Manager.
Or through the 'Advanced Messaging' section of your Page Settings
Scroll down to Requested Features > click on 'Request' next to One-Time Notification
You’ll need to agree to the beta terms there. You will then receive permission if your page meets Facebook’s criteria.
How to send One-Time Notifications from your Messenger bot
There are two steps in the process of sending One-Time Notifications:
- Get user consent to send the message, also known as subscribing the user to a One-Time Notification or collecting subscriptions.
- Send the message itself.
We’ll be releasing a plugin soon to make this process quick and simple. Until then, here’s how to set up a One-Time Notification manually.
#1. Get consent from the user
To request a user's consent to send them a One-Time Notification, you must:
1. Add the JSON plugin to start collecting subscriptions.
2. Select the POST Type with the Chatfuel URL.
3. Specify title and notification topic in the JSON body. The subtitle and the button will always be the default ones.
"title": "Add the title here. Max 65 characters.",
"topic": "Add the OTN topic here. It's an internal name for your future reference in the Reengage tab.",
"block_id": "It's an optional field. Add 24 character block id here where to redirect user after button click"
As far as when to collect user subscriptions, you’ve got options—but you have to do it within the 24-hour contact window. You could:
- Use triggered messages. Send them out 23 hours after the first interaction, for example.
- Use Sequences. For instance, you could subscribe the user to the Sequence 23 hours after they finish a lead-generation flow.
- Create a REF link to the block where you’ve set up the plugin above, then add it to the item in question on your website. You can do this directly in the item’s description, or you can add the checkbox plugin with the specific REF link.
#2. Send the One-Time Notification message
When you’re ready to send the One-Time Notification message itself (for the back-in-stock use case, for example, this would happen when the item the user wanted to be notified about is in stock again, or you know exactly when it will be), there are a few ways to do so. All must be done from Chatfuel’s Reengage tab.
- Use the Deliver Your Message Now functionality, or choose Schedule for Later.
- Or, use the Autopost from an External Source option to trigger a message with a Zap once a new item is added to your stock.
Either way, you’ll need to select the correct One-Time Notification tag—whichever one fits the purpose of your message.
Keep in mind, that after the first subscription with JSON plugin, it will take a few minutes the new topic to appear on the list. You'll need to refresh the page too.
Then, add the message content. Remember, you only get to send a single message (one text card, one gallery, or one image card), plus one quick reply if needed.
Finally, press Send. The users who receive the message will then be removed from this One-Time Notification purpose list.
💡 Reminder: We’ll be releasing our One-Time Notification plugin soon! It’ll make this setup process much simpler. Join our Facebook community for the latest updates.
Important tips for sending One-Time Notifications via Messenger bot
- Per Facebook’s Platform Policy: “Don’t confuse, deceive, defraud, mislead, spam or surprise anyone.” Only send One-Time Notification messages that contain exactly the content you told the user to expect when they gave you consent.
- Facebook also prohibits incentivizing One-Time Notification opt-ins. Don’t promise users money or other rewards in exchange for signing up for these messages.
- Don’t use One-Time Notifications for recurring content like newsletters, multi-day onboarding flows, game updates, etc. Only send them for the approved use cases, or there may be consequences for your bot and/or your page.
- Know that if your page receives lots of negative user feedback and/or violates Facebook’s policies, it will lose access to the One-Time Notification API.