botpress install broadcast
The broadcast module should now be available in your bot UI, and the APIs exposed.
You can decide wether the scheduled time is abolute to the bot's time or to individual users. If no timezone information available for the user, GMT is chosen.
Instead of sending text, you can decide the behavior of the sending function and do basically anything. The function will be called for every message (so for every user).
Variables exposed:
bp
botpress instanceuserId
the userId to send the message toplatform
the platform on which the user is on
The built-in Facebook Messenger snippets are example of Javascript execution (see UI).
You can apply filters to the broadcasts. Filters are small javascript functions that will be evaluated before sending the broadcast to a user. The condition is called for every users the broadcast is scheduled to.
Variables exposed to the filter function:
bp
botpress instanceuserId
the userId to send the message toplatform
the platform on which the user is on
The function needs to return a boolean or a Promise of a boolean.
Note: Starting your function with return
is optional.
["platform === 'facebook'"]
Note: Assuming your bot has a subscriptions
table that holds userId and platform
// in your bot's index.js
bp.isUserSubscribed = (userId, platform) => {
return bp.db.get()
.then(knex =>
knex('subscriptions')
.where({ userId, platform })
.select('count(*) as count')
then().get(0).then(({count}) => count > 0)
)
}
["bp.isUserSubscribed(userId)"]
- User segmentation
Returns a list of the scheduled broadcasts.
Schedules a new broadcast.
{
date: string, // *required*, 'YYYY-MM-DD'
time: string, // *required*, 'HH:mm'
timezone: null|int, // null (users timezone), or integer (absolute timezone)
type: string, // *required*, 'text' or 'javascript'
content: string // *required*, the text to be sent or the javascript code to execute,
filters: [string] // filtering conditions, Javascript code
}
"Hello, Human!"
Update an existing broadcast. Same as PUT except that id
is also necessary. You can't modify a processing broadcast.
Delete an existing broadcast. You can't delete a processing broadcast.
Pull requests are welcomed! We believe that it takes all of us to create something big and impactful. There's a Slack community where you are welcome to join us, ask any question and even help others.
Get an invite and join us now! ๐https://slack.botpress.io
botpress-broadcast is licensed under AGPL-3.0