1. Introduction #
Floatchat makes it incredibly easy for you to create a broadcast. Simply go to the Broadcast workflow, accessible from the left Navigation as “Broadcast.”
If you don’t have an active WhatsApp business number, you can use the “WhatsApp Sandbox” feature to test your bot flow on the WhatsApp channel. Click here to learn more. Please note that this feature is only available if your bot is not deployed on the WhatsApp channel.
To make testing your broadcasts easier, we’ve made the “WhatsApp Sandbox” and “Create New Broadcast” options available in all three sections: Broadcast History, Scheduled Broadcast, and Draft Broadcasts.
2. Create New Broadcast #
When you click on the “Create new broadcast” button, it will open a section as follows:
While creating a new broadcast, you need to provide the following details:
- Broadcast Name: Provide a name related to the context of your broadcast for future reference.
- Target Channels: Select the deployed channel you want to use to send the broadcast.
- Broadcast Type: You have the following options to personalize your broadcast message:
- Send a Message: This type of broadcast is non-interactive, and the receiver will see a message.
- Send Message with options: This type of broadcast allows the sender to receive input from the receiver.
- Trigger a path: This option takes the receiver through all the flows defined in a path. Use this option to re-engage your users and encourage them to start interacting with your chatbot again. Avoid triggering paths just to deliver a lot of content to users.
- Send template message (Only for WhatsApp channel – Click here)
- Broadcast Message: For the “Send Message” and “Send Message with options” broadcast types, you can add a text message.
- Target Segment: You have two options for selecting your target user group:
- Contact list (Only for WhatsApp channel): Select the contact list you’ve already uploaded or upload a new contact list by clicking on the “Import Contact List” option.
- Segment: Using the “all users” option, you can include all users who have previously interacted with your bot, or you can select a custom segment you created.
- Schedule: This option allows you to define a set schedule for when you want the broadcast to be initiated/published. You can choose to publish a broadcast as a one-time or recurring occurrence. If it’s recurring, you can select the frequency and time period during which the broadcast will continue to be active.
Note: This feature is available if you have an active WhatsApp setup with 360Dialog or Kaleyra. Navigate to “Configure” and “WhatsApp” to set up your WhatsApp account. Visit the detailed documentation here to learn how to send WhatsApp template messages to new and existing users. Please contact your WhatsApp provider or Floatchat support team (email@example.com) for more information on the pricing of template messages.
4. Broadcast APIs #
Navigate to the “Users” page and create a segment.
Click here to learn more about segments.
HTTP Method: POST
Request URL: https://api.engati.com/bot-api/v1.0/customer/<customerId>/bot/<botkey>/broadcast
(Customer ID, Bot key, and Authorization token are available in the Integrations -> Floatchat API)
- Content-Type: Application/json
- Authorization: Basic <Auth token>
- Dynamic parameters:
- “broadcastTitle”: Identifier name for the broadcast.
- “channels”: Channels such as Web users, WhatsApp users, mobile app.
4.2 Usage Rules
While defining the Broadcast Segment using an API, the below rules have to be kept in mind – Specifying Channels are mandatory If we are sending a DIRECT message on WhatsApp, and LastActiveAfter is 24hrs. For the web LastActiveAfter is 48hrs.
4.3 Direct Message
See an example below of a Broadcast API request for a Direct Message to be sent to users
Direct Message with Options
See an example below of a Broadcast API request for a Message with options sent to users
4.4 Set an attribute and send a message (optional)
See an example below of a Broadcast API request to set an attribute and send a message
4.5 Trigger a Path and send a message (optional)
See an example below of a Broadcast API request to trigger a path and send a message
4.6 Template Message on Whatsapp
Whatsapp typically supports in session messages that are messages, sent to a user who was active with the chatbot in the last 24 hours. For initiating a conversation or notification beyond that time window, you need to send what’s called a message with a defined template. Floatchat supports sending template messages for Whatsapp using the below API structure. The below API is for Nexmo.
4.7 Template Message on 360dialog
URL: https://api.floatchat.ai/bot-api/v2.0/customer/<customerId>/bot/<botkey>/broadcast HTTP Method: POST
Header – Authorization: Basic <API Key>
Note: Navigate to Floatchat APIs to find the customer id, and bot key and generate the API Key
Below is the explanation of the attributes used above,
For broadcast creation
broadcastTitle – Broadcast will be created using this name
publishedOn – Time stamp when broadcast is to be scheduled. Provided time here in UTC, this will be taken as a scheduling time.
For a new user creation
phoneNumber – Whatsapp number with + and country code – ‘+91979093071’. This is a mandatory field
email – Email of the user will be set. This is an optional field
organization – Organization of the user will be set. This is an optional field
title – Title of the user will be set. This is an optional field
lastName – Last name of the user will be set. This is an optional field
firstName – First name of the user will be set. This is an optional field
userName – Username of the user will be set. This is an optional field
Parameters used will also have to be provided under TEXT.
For media templates you can provide URLs for images, documents and flow keys (5.5 Trigger a path) for buttons, if applicable, like the below script,
5. Tracking broadcast status #
As a part of the Broadcasts, users will be able to download the target user and failed users list by clicking on their respective statistics number as highlighted in the image. The downloaded file will be available as a CSV and will have the following information,
Platform/channel (on which the broadcast was sent)
Reason for failure (available only for WhatsApp – 360dialog)
For the sent broadcasts, you get the following options such as: #
a. View Broadcast
b. Copy Broadcast
c. Export Broadcast
d. Retry Broadcast
a. View Broadcast – #
Once you click on the ‘View Broadcast’ option, it will open a window as shown below
Channel – a specific icon for the chosen channel will be displayed.
Completion time – It displays the date and time when the broadcast was sent.
Target Users – It indicates the count of valid phone numbers or users included in your broadcast’s target segment or contact group.
Failed Users – It indicates the count of invalid phone numbers or users that are excluded from the target segment or contact group for your broadcast.
CTA (URL Clicks) – It shows the count of clicks made by your targeted user group on the CTA (Call-to-Action) button.
Sent – The message acknowledged as sent by the channel to the number of users.
Delivered – The message acknowledged as delivered by the channel to the number of users.
Read – Messages read by the number of users and acknowledged by the channel.
Click rate – Messages on which buttons were clicked by your target audience (only button clicks with type as quick reply are captured by WhatsApp)
You also get an option to Retarget the broadcast, Click here to learn more…
b. Copy Broadcast – #
You can choose this option if you want to edit and reuse the same broadcast for a different group of users.
Once you click on the ‘Copy Broadcast’ option, it would open a window as shown below –
c. Export Broadcast – #
If you require a detailed report for the sent broadcast, you can generate it by clicking on the ‘Export Broadcast’ option. This action will trigger the download of a zip file that contains an Excel sheet of your broadcast report. The Excel sheet will provide you with comprehensive information on the broadcast, allowing you to analyze the data and gain insights into the performance of your message.
A downloaded report would look like this –
d. Retry Broadcast – #
In the event that there are any failed users in your sent broadcast, you will have the option to retry the broadcast for those users. To retry the broadcast, simply click on the ‘Retry Broadcast’ option. This action will allow you to re-initiate the broadcast for the failed users, ensuring that they receive the message as intended.
Click on the ‘confirm’ button to retry the broadcast –