post
https://api.flow.ai/rest/v1/broadcast/instant
Broadcasts to a mobile subscriber ISDN (MSISDN) number with the Flow REST API.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Details
Send a WhatsApp templated message or SMS (text) message to a list of phone numbers (MSISDN).
Mapping of channel and channel name
The following table shows the channel mapping with the channel name.
| Channel | channelName |
|---|---|
| Google RBM | rbm |
| MessageMedia | messagemedia |
| Telekom RBM | telekom |
| Twilio | twilio |
whatsapp | |
| Khoros | khoros |
| Messenger | messenger |
Mapping of the channel with the external ID
Within the Khoros Flow dashboard, open the messaging channel you'd like to use to send a message. Use the reference table below to find the value to use within your API call.
| Channel | externalId |
|---|---|
| Google RBM | Project ID |
| MessageMedia | Phone Number |
| Telekom RBM | Telekom bot ID |
| Twilio | Phone Number |
| Production phone number | |
| Khoros | Phone number |
| Messenger | Page ID |
Text Example
The following example demonstrates how to send a message through Whatsapp.
POST rest/v1/broadcast/instant HTTP/1.1
Host: api.flow.ai
Content-Type: application/json
Authorization: MY_MESSAGING_API_KEY
{
"audience": [{
"name": "John Doe",
"phoneNumber": "+12345678901",
"profile": {}
}],
"channel": {
"channelName": "whatsapp",
"externalId": "+12345678902"
},
"payload": {
"type": "text",
"speech": "I'm searching for the address of your store in New York"
}
}
Event Example
The following example demonstrates how to send an event message through WhatsApp.
POST rest/v1/broadcast/instant HTTP/1.1
Host: api.flow.ai
Content-Type: application/json
Authorization: MY_MESSAGING_API_KEY
{
"audience": [{
"name": "John Doe",
"phoneNumber": "+12345678901",
"profile": {}
}],
"channel": {
"channelName": "whatsapp",
"externalId": "+10987654321"
},
"payload": {
"type": "event",
"eventName": "Send template"
}
}