Welcome to BotSailor Help! Just use the email OTP to sign in and track your tickets. Password login isn’t needed anymore.
One of the most powerful features of BotSailor is the ability to personalize your chatbot messages based on collected user data. By using custom fields, you can store subscriber-specific information like name, email, phone number, or any other detail and then dynamically use those data points in your follow-up messages.
This guide walks you through how to create custom fields in BotSailor and use those fields in personalized WhatsApp messages within chatbot flows.
Custom fields in BotSailor are user-defined data placeholders that let you collect and reuse subscriber information throughout your chatbot journey. These fields help you:
Go to Subscriber Manager → WhatsApp Subscriber from your BotSailor sidebar.
Click the Manage button → Select Manage Custom Fields.
Click on the Create button to add a new field.
Then click Save.
Open your chatbot flow and add or edit a message block. In the message configuration window:
Example message:
Your data is:
Name: #full_name#
Phone: #User phn num#
Email: #User Email#
Address: #User Address#
This will dynamically insert each user’s data into the message.
Can I update a custom field later in the conversation?
Yes. You can overwrite an existing custom field value any time using user input.
What happens if the field is empty during the message sending?
If the field is empty, it will show a blank space in the message unless you use fallback conditions.
Are custom fields available across all channels?
Custom fields are specific to each channel (WhatsApp, Messenger, etc.). This guide is for WhatsApp.
Can I export custom field data?
Yes, BotSailor allows exporting subscriber data including custom fields.
Is there a limit to how many custom fields I can create?
There’s no strict limit, but keeping it organized and minimal is recommended for usability.
Can I display custom fields in user profiles?
Yes, collected data is shown in the Subscriber Manager table for each user.
Are custom fields secure?
BotSailor uses encryption and secure storage practices for all user data.
How do I delete a custom field?
Go to Manage Custom Fields and click the delete icon beside the field.
Can I use custom fields inside broadcast campaigns?
Yes, dynamic tags using custom fields can be used in broadcast messages.
How can I test my custom field flow?
Use a test number to go through the full flow and check the replaced values in the message preview.