Create your bot
Basics - Essentials to build a bot
Variables in Landbot - Getting Started
Landbot system Variables
Builder's keyboard shortcuts and mechanics! 🏗
Builder Interface
Supported Browsers
Guidelines 🚀 5 best practices for chatbot design in Landbot 🤖
How to "debug" (troubleshoot) your bot's flow to spot possible errors (for non coders)
Build a bot
Blocks and flow operations
AB Test block (randomize flow)
Buttons block
Buttons block
Reply Buttons block (WhatsApp)
Default Output Explained
How to open a new URL in another tab (window)
How to set up Multiple Choice questions
Code Block (Javascript)
Conditions block
Conditions block
Conditions block II (with Dates, Usage and Agents variables)
How to ask a question based on a variable not being set (empty URL params) (v3)
Flow operations
Global Keywords 🌍
Keyword Jump
Keyword Options 🔑 Assign keywords to buttons (WhatsApp and Facebook)
Lead Scoring block
Persistent Menu
Jump To block
Formulas block
Get started with the Formulas block
Formulas Blocks Dashboard
Formulas - Regex
Formulas - Date
Formulas - String
Formulas - Logical
Formulas - Math
Formulas - Object
Formulas - Comparison
Formulas - Array
Goals block
Goodbye block
Media Block
Multi-Question block (Create a Form)
Note block
Question blocks
Question: Address block
Question: Autocomplete block
Question: Date block
Question: Email block
Question: File block
Question: Name block
Question: Number block
Question: Phone block
Question: Picture Choice block
Question: Rating block
Question: Scale block
Question: Text block
Question: URL block
Question: Yes/No block
Send a Message block
Send an Email block
Set Variable block
Starting Point block
Business Hours block
List Buttons Block (WhatsApp)
Collect Intent block
Bricks
Bot Settings
Bot General Settings
Second Visit Settings
Custom System Messages
Hidden Fields (Get params / UTMs from url and use it as variables)
Landbot native SEO & Tracking tools
Typing Emulation
Landbot in Wix
Chats - Livechat and Human Takeover
Design (bots for Web)
Share & Embed
Account Settings and Billing
Billing
Teammates - Add extra agents (seats) to your Account
Subscription Section (v3)
Payment FAQ 💳
Fair Use Policy
Account Settings
Account Settings
Account Homepage
Dashboard
Roles & Permissions for Teammates
Agent Status and Log out
Common reasons for not receiving account activation email
Privacy and Security
Integrations with Landbot
ActiveCampaign
Airtable
Airtable integration block
Get data filtered from Airtable with a Brick- Shop example
20 different ways to GET and filter data from Airtable
How to add/update different field types in Airtable (POST, PATCH & PUT)
How to Create, Update, Retrieve and Delete records in Airtable (POST, PATCH, GET & DELETE)
Get more than 100 items from Airtable
Insert Multiple Records to Airtable with a Loop
How to Get an Airtable Token
Advanced filters formulas Airtable block
Update Multiple Records in Airtable Using a Loop
Automate.io
Calendly
Carrd
DeepL
Dialogflow
Dialogflow & Landbot course
Dialogflow & Landbot intro: What is NLP, Dialogflow and what can you do with it?
Dialogflow & Landbot lesson 1: Create your first agent and intent in Dialogflow
Dialogflow & Landbot lesson 2: Get the JSON Key
Dialogflow & Landbot lesson 3: Setting up of Dialogflow in Landbot
Dialogflow & Landbot lesson 4: Training phrases and responses for a FAQ
Dialogflow & Landbot lesson 5: Entities and Landbot variables
Dialogflow & Landbot lesson 6: Redirect user depending on Dialogflow response parameters (intent, entities and more)
Learn more about Dialogflow - Courses and communities
Integrations > Dialogflow Block
How to extract parameters from Dialogflow response with Formulas
Dialogflow Integration Dashboard
Dialogflow in Unsupported Languages (& Multilingual)
Dialogflow - How to get JSON Key
External API REST
Dynamic Data (Arrays)
Webhook Block Dashboard
Webhook block (External API REST)
How to TEST your Http Request (Webhook block)
How to POST, GET (and more) with Landbot
Facebook Pixel
Google Analytics
Google Adwords
Google Cloud Functions
Google Maps
Google Maps API Key for Address block
Extract Data With Google Maps Geocoding API
Calculate Distances With Google Maps API
Google Sheets
Google Sheets (Insert, Update and Get data)
How to use Google Sheets to create a simple verification system for returning visitors
How to Upload Document & store link
How to give unique Coupon Codes (with Google Spreadsheets)
Google Sheets Integration Dashboard
How to insert a new row with data and formulas in Google Sheets
How to use Google Spreadsheet as a Content Management System for your bot
Google Tag Manager
GTM - How Track Google Analytics Events in Landbot with Google Tag Manager
Landbot in your web with Google Tag Manager
HubSpot
IFTTT
Integromat
Connecting MySQL with Make.com (formerly Integromat)
How to upload a file to Google Drive using Make.com (formerly Integromat)
Send HSM Template from Make (ex Integromat)
Make.com (formerly Integromat) trigger
How to send an email through Sendinblue by Make.com (formerly Integromat)
Get Opt-ins (Subscribers) from Facebook Leads using Make (ex Integromat)
How to extract data from an external source with Make.com and use it in Landbot
Integrately
Intercom
Vonage
Mailchimp
OCR
OpenAI
How to build a FAQ chatbot with GPT-3
Fine-Tune GPT3 with Postman
OpenAI
Prompt Engineering for GPT-3
Build a Customer Service Bot with ChatGPT and Extract Information
Pabbly
Paragon
PDF Monkey
Pipedream
Salesforce
Segment
Sendgrid
Slack
Stripe
Squarespace
Sharetribe
Shopify
Store Locator Widgets
How to display the near location of your store in WhatsApp (with Store Locator Widgets)
How to display the near location of your store for Web bots (with Store Locator Widgets)
Webflow
Wordpress
Xano
Zendesk
Zapier
Zapier block
Zapier Integration Dashboard
How to insert a row to Google Spreadsheet by Zapier
How to generate a document with PDFMonkey by Zapier
Send HSM Template from Zapier
How to send an email with Gmail by Zapier
Get Opt-ins (Subscribers) from Facebook Leads using Zapier
How to extract data from an external source with Zapier and use it in Landbot
Zapier trigger
How to complete a digital signature flow by Zapier
Make a survey with Landbot and display the results in a Notion table using Zapier
Trigger Automation block
WhatsApp Channel
Getting started with the WhatsApp Integration
WhatsApp Testing
Сonnecting WhatsApp Business API with 360Dialog
WhatsApp Number Migration / Porting to Landbot
Facebook Business Verification - Best Practices 🇬🇧
Adding a WhatsApp number to your account
Settings
Growth Tools for WhatsApp
Opt-in, Templates and Campaigns
Parent Bot/Linked Bot - Add a main bot to your WhatsApp number
How to get Opt-ins (Subscribers) for your WhatsApp 🚀
WhatsApp Campaigns 💌
WhatsApp's Message Templates
Send WhatsApp Messages with Landbot API
Recognise the users input when sending a Message Template with buttons
Audiences
Create Opt-ins (Subscribers) using Landbot API
New Opt-in block for WhatsApp 🚀
Opt-in Check Block
WhatsApp Bot Creation - Best Practices and compatibility guide
Build a WhatsApp Bot - Best Practices and User guide
Build a WhatsApp Bot - Best Practices for Developers
WhatsApp bots - Feature Compatibility Guide
Types of Content and Media you can use in WhatsApp 🖼
WhatsApp - How to capture and use the first user's interaction (input)
WhatsApp - How to direct a user through a different bot flow on their second visit
WhatsApp - Get user out of error message loop
Javascript in WhatsApp
How to calculate the number of days between two selected dates (WhatsApp)
Creating a Loop in WhatsApp
AI in WhatsApp
Send Automated Message Templates based on Dates
Different ways to format numbers with JS (WhatsApp)
Notify Teammates of Chat via WhatsApp
Creating a Simple Cart in WhatsApp
1. WhatsApp Article Directory
2. WhatsApp Integration FAQ's
Customize and embed your WhatsApp Widget
Other Channels - Messenger and APIChat
Facebook Messenger
The Facebook Messenger Ultimate Guide
Types of content you can use in Messenger bots 🖼
How to Preview a Messenger bot
Facebook Ad connected to Messenger Bot
API Chat (for Developers)
How to create an API chat bot and set up the Hook Url
Building a Slack APP Bot with Landbot APIChat and Node JS
Build a Telegram Bot with Landbot APIChat and Node JS
Duplicating bots
Metrics and Data Management
Metrics Section
How to export the data from your bots
Export data: How to open a CSV file
Bot's Analyze Section
For Developers & Designers
CSS and Design Customizations
Dynamic Customizations
How to change Avatar dynamically (Landbot v3)
Dynamically Change a Bot's Background
Create a Checkbox in the Welcome Block
Dynamically Change Any Style
Embed Customizations
Open LiveChat bot as soon as page loads (3 ways)
How to launch a Landbot by clicking a button
Modifying Embed Size
Load script and display bot on click button
How to trigger events and/or pass values from Landbot to the container site
How to "send" a user to a specific point in the flow with Javascript and with the API
Change Landbot custom CSS dynamically from parent page onload
CSS Customization Examples
CSS Customization Examples: "Back to School" Theme
CSS Customization Examples: Call To Action: WhatsApp
CSS Customization Example: "Lead Gen"
CSS Customization Examples: "Translucid"
CSS Customization Examples: "Minimalist" Theme
CSS Customization Examples: Carrd Embed Beginner
Make Persistent Menu Appear During the Flow
CSS Customization Examples: Video Bubble
CSS Customization Examples: CV Template
Design Customizations
How to use Google Fonts in Landbot
CSS for Typewriter Effect
Hide time stamp (under avatar)
Detect if a visitor is on Mobile/Tablet or Desktop
Proactive Message Customizations with Javascript and CSS
Landbot v3 - Web CSS - RTL
How to remove Landbot branding
HTML Template for Emails
Widget/Bubble Customizations with Javascript and CSS
Customized display in the bot
Add a Chart (with Chart JS library) in your Landbot
How to display an HTML Table and a List in Landbot v3 web
Pop up modal to embed third party elements
Progress Bar Workaround
Different ways to embed Videos in Landbot
How to embed a .gif file inside a message
Display video and hide button to continue until video has ended
Components CSS Library
Components CSS Library Index
Background Class CSS
Identify Blocks CSS
Buttons Class CSS
Header Class CSS
Media Class CSS
Message Bubble Class CSS
Miscellaneous Classes CSS
Recommended Image Sizes
Dynamic Data CSS
Get started guide for CSS Design in Landbot
Landbot APIs
APIs
reply from Slack: How to create an integration to allow agents reply WhatsApp users from Slack (with Node JS)
MessageHooks - Landbot Webhooks
Javascript and SDK
Workarounds and How To's
Building Tips & How to's
How to add a Click-to-Call/Email/WhatsApp button
Send variables from your page (the container site) to your embedded Landbot
How to build an event registration Landbot (to be used in one screen by many attendees) (web only)
How to redirect user to another url in your site with Livechat open to continue conversation
How to let user select a time of booking (with a minimum 45 minutes notice)
Dynamic Data in WhatsApp (Get Index Array selection)
Get the array's index of the user selection and extract information from array
How to encode a variable
How to calculate the number of days between two selected dates
How to redirect visitors to a URL (web only)
How to disable a bot
Airtable usecase: Create an event registration bot with limited availability
Get the time between certain messages
Reservation bot with Airtable
Workarounds & Codes
Refillable bottles
How to Detect Visitors Browser
Proactive message on mobile
Different ways to format numbers with JS
Conditional Welcome: Direct the Flow of Your Bot Based on External Parameters
Two-Step Email Verification
Trigger Event if User Abandons Chat (For Non Developers)
Calculate Distances in WhatsApp
Customized Behavior in Mobile Browsers
How to not display Proactive Message to repeating Visitors
Trigger Event if User Abandons Chat Using AWS
Launch Bot On Exit Intent
Display Bot During Business Hours Only (Livechat & Popup)
Delete Customer Data in Flow
Cookie consent banner (full page / full page embed)
Add Captcha Verification (Non-Embedded Bots)
Set the flow depending on the url path (for embedded landbots)
Trigger a Global Keyword with JS (web v3)
Create a Scale out of Buttons - Workaround
How to pass WordPress logged in user data to Landbot
Create Dynamic Shopping Cart with JS and CSS
Generate a URL that has variables from user answers
Resume flow based on external process with Landbot API (Request, Set, Go)
Popup on Exit Intent
Embed Google Maps
Detect if bot was opened
Launching a bot depending on browser language
How to set up questions with a countdown
Set a timer to get the time spent during the flow
More Topics
Introducing a new Landbot Community 🎉
How to migrate your bot from Landbot v2 (legacy) to Landbot v3
Introducing Landbot 3
Migrate your web bot from the Old Builder to the New Builder (Landbot 2 and 3)
Landbot Affiliate Program
Security Update - HTTPS URLs only
Startup Discounts
NGOs and Educational Organizations Discount
Table of Contents
- All Categories
- WhatsApp Channel
- Getting started with the WhatsApp Integration
- The Ultimate WhatsApp Guide 🇬🇧
The Ultimate WhatsApp Guide 🇬🇧
Updated
by Xandro Lopez
You can check this same guide in a different language, by clicking on one of the following links:
Spanish 🇪🇸 : Pulse aquí para leer la Guía Optima para WhatsApp en español.
1. Introduction
Are you wondering how to apply for a WhatsApp Business API number?
Are you just trying to run some tests?
The fact is, you're probably not the only one. Many companies these days are looking to jump on the WhatsApp Business API bandwagon but the truth is, it's either hard to find the right information or the information is unclear.
Therefore, we have decided to create a step by step guide of how to test our WhatsApp integration and how to apply for an official WhatsApp Business API number with Landbot.
2. Getting Started
2.1 Creating an account
First things first, before you can do anything on the platform you'll have to create an account.
Its very simple! Just go to this sign up link and sign up with your favourite option out of those provided!

2.2 Building your Bot 🤖
From the moment you sign up, you have a 14 day free trial period where all premium bot building features are available fo testing, so we recommend building your bot within those 14 days.
However, if you feel like you need a little bit more time, do not hesitate to contact us on sales@landbot.io or on the chat in the bottom right corner of the app to find out if you are eligible for a trial extension!
To help you build your bot you can:
- Use our extensive Knowledge Base, and you can find here content specific for our WhatsApp integration.
- Join our Academy with video tutorials for different WhatsApp use cases 📹
2.3 WhatsApp Testing (former Playground)
Since our WhatsApp integration is a paid subscription, we have created a free testing environment called WhatsApp Testing. 🧪
It allows you to experience what the official API integration feels like from the final user perspective.
Testing channels work in one direction only, which means only the phone number you connect to it will be able to send and receive messages from the testing channel.
You will be able to add up to 10 phone numbers to the WhatsApp Testing channel! If you reach this limitation, you can just delete one of the numbers and add a new one.
2.4 WhatsApp Testing vs WhatsApp Official Integration
There are a few features/actions that are only available for the WhatsApp Official Integration since they require brand and number approval by WhatsApp.
Below is a list of the features available ✅ and not available ❌ on WhatsApp Testing (former Playground).
Once you are happy with the bot you created (or if you are in a rush, while you are creating it) you can start applying for the official WhatsApp Integration.

3. How to apply for the Official WhatsApp Integration
If your question is "How do I make my bot public?", then you're in the right place.
Below, you can find the details of the whole process!
3.1 Choose your WhatsApp Plan
We have 2 plans that include the Whatsapp Official integration. The main criteria to choose one of those plans is usually the amount of WhatsApp contact numbers or the number of conversations you expect to have each month.
- Professional Plan + WhatsApp add-on - for small/medium size companies with lower conversation volumes.
- Customised Plan - for larger companies with high conversation volumes.
3.2 Purchase your WhatsApp Plan
- Customised plan:
If you decide that the customised plan would be the best fit for you, our Sales team will guide you through the purchase process.
- WhatsApp add-on for Professional Plan:
If you decide to go for a Professional Plan + WhatsApp Add on, you should contact sales and they will unlock the WhatsApp add-on on your account. Once this step is completed you should:
1. Access the Subscription Section of your account.
2. Select WhatsApp Pro Add on and Upgrade to the Professional plan + WhatsApp add-on. You can find more information on how to upgrade in this article.
3. If the payment is processed correctly, you will now have access to all Professional Plan functionalities and can start the WhatsApp Brand and Number approval.
The WhatsApp Official integration depends exclusively on WhatsApp's approval, and will only be made available in your account after the number is approved.
3.3 Requesting WhatsApp Brand and Number Approval 📞
Once you have completed the previous steps you will be able to make a request for your brand and number to be approved.

You can do this on the platform by going to your WhatsApp Pro section, clicking on the "Request WhatsApp number" and filling out the bot.
You can also read it here 🚀
Once you have read the document, the bot will ask you for the following information:
- Company details: Full company name and address including country and postal code.
- Facebook Business Manager ID: You can find it by following this guide.
- Phone number: The number you want to activate a WhatsApp Business account for. It needs to be able to receive an SMS / phone call for the activation. Please, ready carefully WhatsApp policy about numbers.
- Display Name: The name that shows to your customers when they haven't saved your number.
All display names should have a relationship with your business, should not violate WhatsApp Commerce and Business policies, and be an accurate representation of your business.
Please, read with attention WhatsApp Display name policy here.
Once the details have been filled out and your WhatsApp Business account created, someone from our Customer Success team will reach out to you with next steps 😉
You can also find them detailed below:
4. Approval Process
1. Facebook Business Verification
Business verification is a process that verifies your:
- Business as a legal entity: Your business should be properly registered with official local authorities and have an official business phone number or mailing address.
- Proof of access to your business: You must be able to receive a verification code sent to your business’s phone number or email address.
You can verify your business by following this Facebook Guide.
2. Signing the WhatsApp Business End-Client Addendum
At the end of the number request bot you'll see a message asking you to sign a document called WhatsApp Business End-Client Addendum and a link to said document.
In a nutshell, the document explains the Terms and Conditions you agree with in exchange for using the WhatsApp Business API solution.
Please make sure you sign it on the given link, since this is the only way it will be accepted by Sunshine Conversations will accept it.
3. Approving Facebook Notification
You will receive a notification on your Facebook Business Manager on behalf of Sunshine Conversations in order to accept the WhatsApp Business Account creation. Please approve it.

4. Account Review
Once step 1 and 2 are completed, please let us know in the email thread we have created to guide you through the integration.
WhatsApp will review the account and we'll let you know as soon as we receive an update on its approval status. Note that this process can take between 1-2 weeks.
If you are using the number provided for activation on the mobile consumer version or the WhatsApp Business app, you will have to migrate the number to the WhatsApp Business API platform.
You can do this directly on the WhatsApp app by following the steps described here.
5. Display Name Review
If the WhatsApp Business Account has been approved, the display name will then be reviewed 🔎
6. Pin Number Exchange
Once step 4 is approved, we are finally ready to complete the integration!
We will reach out to you to find a good time to launch an SMS to the number to integrate which will include a 6 digit pin code.
Once received you will need to send it back to us on the email thread.
Once we have received the pin we will activate your account and the integration will be complete and available on your Landbot account!
CONGRATULATIONS!! 🎉🥳
7. Green Tick (Optional) ✅
The Green Tick is given when WhatsApp has verified that an authentic, notable brand owns this account.
An Official Business Account has a green checkmark badge in its profile and chat thread headers. The name of the business is visible even if the user hasn't added the business to their address book.
More information here.
You are able to request the Green tick once your number is approved by WhatsApp and connected to Landbot.
All you need to do is let us know by sending the following information:
- Phone number to verify:
- Website:
- Link to Facebook Page:
We'll let you know if you have been approved as soon as we receive an update from WhatsApp.
5. WhatsApp Business API Functionalities on Landbot
Once your number has been activated you will be able to use some functionalities you were not able to use on the WhatsApp Testing (former Playground):
5.1 Get Opt Ins
In order to reach out to your users, they need to become subscribers first by means of an Opt-in! 🤚
This is the place where we provide you with the tools you need to get them onboard. 🚀
You can find the full explanation here.

5.2 Request HSM Template
You can request an HSM template from the Channels section in Landbot!

You will also be able to see all your approved Templates in this section. 👀
For more information on the full process, click here
5.3 Campaigns
By setting a Campaign you'll have full control on how you reach out to your subscribed users.
You can send pro-active messages (HSM Templates) to a defined segment of your subscribers, decide which message to send, when to send it, and if this message will trigger a WhatsApp bot.
Once you launched a campaign, you'll be able to know exactly how it has been received by checking the Metrics.
Check out the full article here
6. Definitions
Session Messages - Session messages are reactive messages written in response to a customer inquiry. WhatsApp labeled them as “session messages” since they can only be sent within 24H Customer Care Window.
HSM Templates - (Highly Structured Messages) are proactive messages that companies can send via WhatsApp to their subscribers after 24 hours from the subscriber's last contact. Read more about the different types of messages in our blog!
Opt-In - A user must first consent to receive messages in WhatsApp by opting into them via a third-party channel. This can be any channel your business uses to communicate with people today — your website, app, email, SMS, retail location or you can even create an Opt-in bot. Find out how to do it here.
Feel free to check the Facebook official documentation as well.
AUC/WAUC/Contacts - Any number of sent and/or received messages exchanged between a unique end-user and a WhatsApp channel during a billing cycle.
Team Member/Agent - a user that has access to the Landbot platform through their personal email
7. FAQ
Read the full list of FAQ by clicking here