Connectivity Platform
  • Connectivity Platform Documentation
  • WhatsApp Business Account
    • Can I have multiple WhatsApp Managers in my dashboard?
    • Can my WhatsApp Business subscription be billed monthly?
    • Getting an Official Business Account ("Green Tick") for WhatsApp
    • How do I change my WhatsApp Business display name
    • How to cancel your WhatsApp Business API subscription
    • How to check my quality rating and messaging limits?
    • How to remove 2FA on my WhatsApp channel?
    • Managing your WhatsApp Business account information
    • Migrating WhatsApp Business from another provider (BSP)
    • Migrating to another provider (BSP)
    • My WhatsApp Business Account has been disabled, what can I do?
    • WhatsApp Account FAQ's
    • WhatsApp Billing & Pricing
    • WhatsApp Business App vs API
  • Account
    • Accounts, Workspaces, Users, & Subaccounts
    • Activation code
    • Add & switch between Workspaces
    • Changing ownership of your Workspace
    • Delete an Account and Workspace
    • How to add, edit & delete users
    • I don't remember the email address attached to my Account
    • I’ve lost my password
    • Make someone else in charge of the Account
    • My activation code has not come through
    • Transfer credit to another Account
    • Update personal details on my account
    • Why does MessageBird need my mobile phone number?
  • Add the Omnichannel widget to your online store
    • Adding the MessageBird Omnichannel Widget to a Shopify store
    • Adding the MessageBird Omnichannel Widget to a Squarespace store
    • Adding the MessageBird Omnichannel Widget to a Wix store
    • Adding the MessageBird Omnichannel Widget to a WordPress site or WooCommerce store
  • Admin resources
    • Manager Portal
  • Advanced functionalities
    • Create and use custom functions in Flow Builder
    • Create and use your own custom Flow Builder steps
    • Create your own date formatting function in Flow Builder
    • How to set up Google Places on WhatsApp and Telegram
    • Integrate GCP Cloud Functions and omni-channel automation with FlowBuilder
    • Integrate MongoDB and Omni-Channel automation with FlowBuilder
    • Integrate granular conversational reporting in FlowBuilder with Microsoft Power BI
    • Making an API request and formatting the results in a Flow Function
    • Using Databases
  • Advanced inbox automations and routing
    • Routing setup flow
    • Sentiment Routing
  • Advanced settings
    • Data retention settings
  • Agent resources
    • Contact merging in Inbox
    • Setting your agent status
  • Application security
    • Does MessageBird conduct code scans?
    • Does MessageBird conduct penetration testing on application?
    • How does MessageBird manage SDLC?
  • Basics
    • FlowBuilder Overview Page
    • FlowBuilder Steps Glossary
    • Getting Started with Flow Builder
    • Triggers, Numbers, Templates, & Steps
    • What is Flow Builder?
  • build-and-manage-a-flow
    • Autosave Feature and Version History
    • Get insights about conversation movement with the Flow Heatmap
    • Manage Data Retention of your Flow
    • Steps Grouping
  • business-continuity-and-disaster-recovery
    • Does MessageBird have BCP?
  • contacts
    • Add existing contacts to groups
    • Create a Group
    • Export contacts
    • Formatting your contact numbers
    • How many contacts can I store?
    • How to forward an invoice to a different email address?
    • Managing group subscribers
    • Remove Contacts
  • conversations-chat-api
    • I'm not able to send a message to a certain User ID via the API
    • No messages in Conversation channel
    • Unable to Install Channel
  • country-restrictions-and-regulations
    • Sender ID Availability and Restrictions per Country
    • Australia
    • Canada
    • China
    • France
    • Germany
    • India
    • Japan
    • Malaysia
    • New Zealand
    • Nigeria
    • Norway
    • Romania
    • Russia
    • Singapore
    • South Africa
    • Turkey
    • United Arab Emirates
    • United Kingdom
    • United States
    • United States 10DLC FAQ
  • customizing-the-omnichannel-widget
    • Can I hide the MessageBird privacy consent message in Live Chat on the Omnichannel Widget?
    • Can I hide the “Powered by MessageBird” branding on the Omnichannel Widget?
    • Can I upload a custom logo as my Omnichannel Widget icon?
    • How can I show or hide my agent profiles in Live Chat and the Omnichannel Widget?
    • How can I update the language of my Omnichannel Widget?
    • How to customize the Omnichannel Widget
    • Update my Live Chat company name and avatar
    • What is the default MessageBird privacy consent message in Live Chat?
  • data-governance-and-security
    • Are the responsibilities regarding data stewardship defined, assigned, documented, and communicated?
    • Does MessageBird encrypt the data?
    • How is access to customer data managed in MessageBird?
    • Is production data used for testing?
    • Bird Security Overview
    • What is MessageBird’s data retention strategy?
    • Where is data stored and processed?
  • data-protection
    • Can MessageBird services be used by customers operating in heavily regulated sectors (such as health
    • Did MessageBird appoint a Data Protection Officer (DPO)?
    • Does MessageBird collect sensitive data?
    • Does MessageBird have a Data Processing Agreement (DPA)?
    • Does MessageBird notify its customers in the event of data breaches?
    • Does MessageBird require a transfer mechanism to process EU citizens' data?
    • Does MessageBird share customer data with, or enable direct access by, any third-party?
    • Does MessageBird support data subjects requests?
    • How long does MessageBird retain personal data?
    • Is MessageBird Data controller or processor?
    • What are the legal grounds for the processing of personal data?
    • What does MessageBird provide as a service?
    • What kind of data does MessageBird collect?
    • What mitigating measures has MessageBird taken in relation to the invalidated Privacy Shield?
  • developer-faqs
    • How do I send text-to-speech messages via the API?
    • What is the difference between a live key and a test key?
  • email-platform-formerly-sparkpost
    • Add more IP addresses to your account
    • Billing frequencies and overages
    • Cancel your MessageBird Email (SparkPost) account
    • Choose the best email-sending package
    • Limits of free email sending accounts
    • Pay your MessageBird Email (SparkPost) invoice
    • Sending less than the monthly email sending limit Volume
    • Sending more than the monthly email sending limit
    • Volume limits on plan overages
  • email-to-sms
    • I am having trouble setting up Email to SMS
    • My Email to SMS did not deliver
    • Receiving Email to SMS
    • Sending Email to SMS to a group does not work
    • Sending Email to SMS
    • Setting up Email to SMS
  • faq
    • Benefits of Programmable Conversations
    • Can I create my own mix of communication channels and add other channels?
    • Can we integrate Conversations into our CRM software?
    • Do I need to purchase a number to publish SMS, Voice, and Webhook flows?
    • Does the Conversations API give automatic access to Whatsapp for Business?
    • Global coverage
    • How does the ‘Repeat’ attribute work?
    • How many flows can I make per number?
    • Is audio, video, chat, image and location sharing possible with Conversations?
    • Supported Languages by MessageBird Natural Language Processing
    • What are Available Variables?
    • What is Programmable Conversations?
    • What is a Continued Action?
    • What is an IVR menu?
    • Which communication channels are supported?
    • Why can’t I use Voice services due to my account currency?
  • faqs
    • Can my customers use the Omnichannel Widget on mobile?
    • What is domain whitelisting in the Omnichannel Widget?
    • Why can’t I see the Omnichannel Widget on my website?
  • flow-triggers
    • Learn how triggers work in Flow Builder
    • Setting up a flow triggered by a webhook in Flow Builder [video]
    • Triggering a flow from an incoming omnichannel message in Flow Builder [video]
    • Triggering a flow with an incoming voice call in Flow Builder [video]
  • get-started-with-the-omnichannel-widget
    • Display, hide or remove the Omnichannel Widget
    • How to create and manage multiple Omnichannel Widgets
    • How to install channels on the Omnichannel Widget
    • Inbox Agent statuses in Live Chat
    • Omnichannel Widget onboarding guide for Inbox
    • Preview my Omnichannel Widget before installing and enabling
    • Sending Emojis in Live Chat
  • getting-started
    • Abandoned Cart Recovery onboarding guide
    • Abandoned checkout best practices
    • Best Practices for SMS
    • Best Practices for WhatsApp Business
    • Best practices for your Knowledge Base datasets
    • Choosing an originator
    • Creating access keys
    • Currencies
    • Deleting your account
    • Email performance reporting with the Verify API
    • Getting Started with SMS FAQ's
    • Getting Started with WhatsApp FAQ's
    • Getting Whatsapp Opt-ins from Customers
    • Getting approval to send to restricted countries
    • Getting started with SMS
    • Google Business Messages FAQs
    • How can I get my namespace ID?
    • How do I start using WhatsApp Business?
    • How long can my WhatsApp channel remain unverified?
    • How to create a Google My Business account
    • How to get a number for the Verify API
    • How to see successful authentication metrics via the Verify logs
    • Requirements
    • How to set up Email as a channel for the Verify API
    • How to set up Entity Recognition in Flow Builder
    • How to set up Fill Form in Flow Builder
    • How to set up Google Business Messages as a channel
    • How to set up a balance warning + auto order
    • How to set up the Recognize Intent step
    • IVR
    • Length of an SMS
    • Mandatory 2FA Authentication for new and existing users
    • Message Templates guidelines
    • Number types
    • Picking a number for WhatsApp Business
    • Placing & receiving calls
    • Porting Numbers
    • Receiving Delivery Reports (DLRs)
    • Requesting Access for Restricted Countries
    • Restrictions for SMS Numbers
    • Setting up notification contacts
    • Start testing with the MessageBird WhatsApp Sandbox
    • Third party applications
    • Topping up balance
    • Using Entities in Flowbuilder to recognize timezones
    • Verified Caller IDs
    • Verifying your Facebook Business Account
    • Voice Number Restrictions
    • What does it mean to be a Verified WhatsApp Service Provider?
    • What features are supported by WhatsApp for Business?
    • What is Messagebird’s Abandoned Cart Recovery Solution?
    • WhatsApp Business Step-by-Step Onboarding
    • WhatsApp Channel Activation FAQ's
    • WhatsApp Channel Activation
    • WhatsApp phone number: From mobile app to API
    • WhatsApp: Why and how to get your customers to Opt-In?
    • When will customers receive the Abandoned Cart Recovery message?
    • Where do I find my Facebook Business ID?
    • Why do I need a service provider like MessageBird for WhatsApp Business solution?
    • Will verifying my Facebook Business Account get me an Official Business Account?
    • Working with WhatsApp Message Templates
  • hlrlookup
    • HLR Request failed or is incomplete
    • No Information in HLR response
    • The difference between Lookup and HLR
    • North-America toll free verification
    • Varying or Incorrect HLR Information
    • What are the different HLR statuses and their meanings?
  • how-to-guides
    • Create an omnichannel FAQ BOT with Flow Builder
    • Dealing with multimedia content in messages using Flow Builder
    • Forwarding calls using Flow Builder
    • Forwarding your SMS
    • How do I set the same flow for all my numbers (Default Flow)?
    • How to Call HTTP endpoint with SMS
    • How to add products in Meta Commerce Manager
    • How to automatically parse receipts in Flow Builder
    • How to build an IVR menu
    • How to create complex Regular Expressions (regex) conditions
    • How to forward calls to another phone number or SIP URI
    • How to forward incoming SMS to an email
    • How to search through Flow Builder Logs
    • How to set up Email OTP solution in Flow Builder
    • How to set up a Feedback Bot
    • How to set up a Flow to send outbound SMS
    • How to use Multiple WhatsApp Business Accounts - WABA's in FlowBuilder
    • Language Recognition with Flow Builder
    • Managing Meta Messenger Referrals in Flow Builder
    • Set up Telegram account masking
    • Set up a generic OAuth integration
    • Set up answering machine detection
    • Set up image recognition for WhatsApp
  • inbox-basics
    • How to log in to Inbox
    • Inbox onboarding guide
    • Setting up notifications for Inbox
  • inbox-for-good
    • Activate FAQ bots
    • Building an emergency Contact Center
    • Send live updates and notifications via SMS
    • Set up Interactive Phone Menus
  • inbox-reporting
    • Download Reports
    • Download reports in CSV format
    • Get to know Inbox reporting
    • Inbox reports glossary
    • Inbox reports in action
  • information-security-management-program
    • Does MessageBird have a security and privacy awareness program?
    • Does MessageBird have an Information Security Management Framework?
    • Does MessageBird have an incident response program?
    • Does MessageBird have an internal audit team?
    • Does MessageBird have any third party attestations for security?
    • Does MessageBird have documentation of their ISMS?
    • Is Management responsible for the security program?
    • What are the roles and responsibilities pertaining to security and privacy across MessageBird?
    • What is the security team at MessageBird?
  • infrastructure-security
    • Can MessageBird provide an overview of how its infrastructure is being secured?
    • Does MessageBird have a patch and vulnerability management program?
    • How are changes managed?
  • insights-reporting
    • Insights
  • instagram
    • How do I filter out Instagram story mentions?
    • How do I know if I'm eligible for Instagram?
    • I cannot find my Instagram channel after installation
    • I'm having issues when installing my Instagram channel
    • Inbound messages are not arriving to my Instagram channel
  • installing-channels
    • Adding Instagram as an Inbox channel
    • Getting started with Viber for Business
    • How to add a channel
    • How to connect and disconnect a channel from Inbox
    • How to find your Facebook Page ID
    • How to use WhatsApp Sandbox with Inbox
    • Install Facebook Messenger as an Inbox channel
    • Install LINE as an Inbox channel
    • Install SMS as an Inbox channel
    • Install Telegram as an Inbox channel
    • Install WeChat as an Inbox channel
    • Install WhatsApp as an Inbox channel
    • Install your Custom Email Domain as an Inbox channel
  • integrations
    • Connect and use Salesforce with Flow Builder
    • Connecting Inbox to Zendesk using Flow Builder
    • Updating HubSpot contacts with Inbox using Flow Builder
  • managing-inbox-admins-and-agents
    • Adding a new agent to Inbox
    • Deleting an agent
    • Import agents to Inbox using CSV
    • Inbox user roles and permissions
  • managing-inbox-contacts
    • Add a contact manually
    • Add a contact via a ticket
    • Import contacts via CSV file
    • Managing your Inbox contacts
  • messaging
    • Add an embeddable WhatsApp Button to your website
    • Do customers need to opt-in to receive WhatsApp messages from my business?
    • I want to connect my WhatsApp API phone number to my Facebook Page (Classic Pages)
    • Is there a limit to the number of WhatsApp messages I can send?
    • Is two-way messaging possible with WhatsApp?
    • Media Templates
    • Message Templates & Session Messages
    • Messaging Features & Restrictions
    • Messaging with WhatsApp FAQ's
    • Receive WhatsApp messages statuses via the API
    • What is the difference between Message Template and Template Message?
    • WhatsApp Campaigns delivery status report
    • WhatsApp messaging restriction toward Turkey
  • other-integrations
    • Can I use MessageBird with Zapier
    • How can I perform HLR Lookups?
    • How can I use the Short Message Peer-to-Peer (SMPP) network protocol?
    • How do I connect RSA SecurID (EMC) to MessageBird's SMS Gateway?
    • How do I connect SafeNet to MessageBird's SMS Gateway?
    • How do I connect SecurEnvoy to MessageBird's SMS Gateway?
    • How to set up multi-channel merchants notifications for Mollie
  • partner-accounts-api
    • Can Accounts be migrated into a Partner Network?
    • Can Child Accounts get invoiced separately?
    • Can the Partner Network be viewed in the Dashboard?
    • How is a Partner Account setup?
    • How is a Partner Network invoiced?
    • How is a Partner Network setup?
    • How many levels of Child Accounts can a Partner Network have?
    • What Services can a Partner Network use?
    • What is a Partner Account?
    • What is an example of a Partner?
    • What is the Partner Accounts API?
  • payment-billing
    • Add balance
    • Billing
    • Can I get account balance Refunded?
    • Do you offer post-pay contracts?
    • How can I change my order or invoice address?
    • How does SMS and Voice pricing work?
    • How to change the default payment method
    • How to set up Auto Top Up
    • Invoices
    • Managing Saved Payment Methods
    • Payment methods we support
    • Payment processing
    • Prepaid account billing
    • Pricing
    • Setting low balance notifications
    • Subscriptions
    • Suddenly getting billed by MessageBird
    • WhatsApp Conversation Based Pricing Changes 2023
    • Will I be charged VAT?
  • quickstarts-and-tutorials
    • Automate customer interactions using AI
    • Build an omnichannel FAQ BOT with Intent Recognition
    • How to automatically Parse Invoices in Flow Builder
    • How to set up appointment scheduling in Google Calendar using Flow Builder
    • Quickstart guide: Set up Computer Vision in Flow Builder
    • Set up an identity verification process flow with the Analyze Image step
  • receiving-sms
    • Forwarding your inbound SMS
    • I am receiving spam on my Virtual Mobile Number (VMN)
    • I did not receive an SMS on my Number
    • Managing opt-outs
    • Setting your account up to receive inbound SMS
    • Viewing your inbound SMS
    • Automatic SMS Subscriptions (Opt-in/Opt-out)
  • salesforce-marketing-cloud
    • Journey Builder setup guide
    • Journey Builder: Best practices and troubleshooting
    • Marketing Cloud Integration setup guide
    • Release history
    • Using WhatsApp rich-media templates
  • salesforce-sales-service-cloud
    • Configure the MessageBird for Salesforce app
    • Configuring business flows in Salesforce (optional)
    • Install the MessageBird for Salesforce app
    • MessageBird Conversations in the Contacts Page
    • MessageBird conversations on the Case page
    • Release history
    • Sync MessageBird conversations to Salesforce
  • salesforce
    • How to set up the MessageBird Salesforce Sales & Service Cloud integration
  • sending-sms
    • A2P vs
    • My SMS was delivered in multiple parts
    • My SMS was delivered multiple times
    • My SMS was delivered with a delay
    • My SMS was delivered with an overwritten sender ID (Changed Originator)
    • My SMS was not delivered
    • SMS Delivery Statuses
    • SMS Reporting
    • SMS Troubleshooting FAQ's
    • Scheduling your SMS
    • Sending SMS in bulk
    • Sending SMS
    • Setting a Validity Period for your SMS
    • Using Flash SMS
    • Using special characters, Unicode, and GSM-T charsets for sending SMS in different languages
    • Using templates & personalisation
  • set-up-inboxs-built-in-automations
    • Automated welcome message
    • Business hours
    • Create Follow-up actions in Inbox
    • Email notifications for Inbox tickets
    • Language recognition
    • Sentiment analysis for Inbox
    • Using Inbox automations
  • short-codes-keywords-sub-keywords
    • How long does it take for a Short Code to be provided?
    • In which countries can I get a Short code & Keyword?
    • Keywords & Sub Keywords
    • What can I do with a Keyword?
    • What is a short code?
  • sip-trunking
    • Configure your origination SIP Trunk
    • Configure your termination SIP Trunk
    • How to configure SIP Trunks on 3CX
    • How to set up an inbound SIP-Trunk
    • How to set up an outbound SIP-Trunk
    • MessageBird IP whitelist for voice calls
    • SIP Server & connection details
    • SIP Trunking with MessageBird
    • SIP Trunking
    • What is a SIP Trunk?
  • steps-catalogue
    • Fetching variable steps in Flow Builder
    • Format for 'Play a sound file' Step
    • How to use Verify with Flow Builder
    • Using Flow Builder to create a ticket in Inbox
    • Using Flow Builder to send Facebook (Meta) Messenger messages
    • Using Flow Builder to send WhatsApp messages
    • Using FlowBuilder to send Instagram Messages
    • Using database steps in Flow Builder
    • Using the "Reply to channel message" step in Flow Builder [video]
    • Using the "Send Conversation" message step in Flow Builder [video]
    • Using the "Wait for a response" step in Flow Builder [video]
  • subscriptions
    • Managing your Inbox Subscription Plan
  • support
    • Basic MessageBird troubleshooting and support tips
    • MessageBird Support Plans
  • terms-conditions
    • Terms & Conditions
    • What is MessageBird's Service Level Agreement (SLA)?
  • third-party-risk-management
    • How are vendors managed?
  • tickets
    • Get to know the lifecycle of an Inbox ticket
    • Hiding and deleting tags from agents
    • How to create and use Canned Replies
    • How to use variables in Canned Replies
    • Inbox Ticket Statuses
    • Replying and closing a ticket
    • Reviewing past tickets
    • Send ticket information to Slack with Actions
  • troubleshoot-a-flow
    • Export Flow Builder Logs
    • Flow Builder Logs
    • Issues forwarding incoming SMS via Flow Builder
    • My Flow is not working
    • My media file in my flow is not playing
    • Number not available for Flow
    • Set up alerts to monitor your flows
    • What errors can I get in the Flow Builder?
  • troubleshooting-voice
    • Call Information
    • Failed API Requests
    • Media file not playing
    • Voice Billing Details
    • Where can I find my Voice logs?
  • troubleshooting
    • API Issues
    • Cannot find templates submitted via Facebook Business Manager
    • Developer logs and errors
    • Error code when sending a WhatsApp Template Message via API
    • Failed Payments
    • How to delete orders and invoices
    • I am having login or authentication issues with the Old API
    • I am missing my delivery reports
    • I am not receiving notifications for Inbox tickets
    • I am receiving an error 500 in my dashboard
    • I can't initiate a conversation with a customer
    • I cannot add my VAT number
    • I cannot see the WhatsApp message in Inbox
    • I did not receive an SMS when trying to claim free test credits
    • I did not receive my account activation email
    • I don't see the Verify codes in my dashboard
    • I have launched my GBM but I do not see a ‘Message’ button
    • I have limited messaging options in my dashboard
    • I see an unknown item on my bank statement from MessageBird
    • Missing HLR results
    • My OTP codes sent via Email are getting in the spam folder
    • My WhatsApp Business API application is not approved
    • My WhatsApp Message Template is not sending
    • My automatic subscription charge was unsuccessful
    • My end users are not receiving their codes
    • My template application has been rejected
    • One of my agents has left the company
    • SMS errors & error codes
    • The Email channel is not working for my Verify requests
    • The owner of my Workspace is no longer with the company
    • Tickets not showing up in Inbox
    • What is the "quality rating" of a WhatsApp channel?
    • WhatsApp Account policy violations and enforcement
    • WhatsApp: Messaging Limits and Tier system
    • WhatsApp: Returning to the mobile app
    • Where can I find my MessageBird Workspace ID?
    • Whitelist MessageBird's IP addresses
  • use-cases
    • Automate the retrieval of call recordings and transcripts in Flow Builder
    • Automatically detect and translate the language in your customers' messages
    • Broadcast WhatsApp Message Templates with Flow Builder & Postman
    • Country recognition with Flow Builder
    • Create click to WhatsApp ads and link them to Flow Builder
    • Detect and extract text from images with Flow Builder
    • Fetching data during conversations with Flow Builder
    • How to Send WhatsApp Media & Text Templates Using Google Sheets
    • How to block SPAM contacts in Inbox
    • How to set up WooCommerce order notifications with Flow Builder
    • Import historical Shopify information to Inbox
    • Integrate Google signup form with WhatsApp through Flow Builder
    • Is reselling of WhatsApp for Business allowed?
    • Multi DTMF behaviour with Flow Builder
    • Use buttons to create interactive WhatsApp Template Messages
    • What are the use cases for WhatsApp Business?
  • using-different-channels-with-the-omnichannel-widget
    • How can my customers use Facebook Messenger with the Omnichannel Widget?
    • How can my customers use LINE with the Omnichannel Widget?
    • How can my customers use SMS with the Omnichannel Widget?
    • How can my customers use Telegram with the Omnichannel Widget?
    • How can my customers use Voice Calling with the Omnichannel Widget?
    • How can my customers use WhatsApp with the Omnichannel Widget?
  • using-gbm
    • How to send and receive Google Business Messages with Inbox
    • How to use Google Business Messages with Flow Builder
  • using-inbox
    • Using ticket rules in Inbox
  • using-live-chat
    • Getting started with Live Chat pop-up messages
    • Live Chat message statuses
    • Send, receive, and download attachments
    • Set up Conversation Bridging (Beta) in Live Chat
    • Set up Live Chat pop-up buttons
    • Show Omnichannel Widget URL as a Custom Attribute in Inbox
  • using-sms
    • SMS FAQ's
  • using-the-abandoned-cart-recovery-solution
    • Checkout events from Shopify
    • Managing your Webhooks
    • Specifying your audience and conditions
  • virtual-numbers
    • Buy a Virtual Mobile Number (VMN)
    • Can I port numbers to MessageBird?
    • In which countries can I get a Virtual Mobile Number (VMN)?
    • International 2-Way Messaging
    • National ID Number
    • Registration Number
    • SMS Number Restrictions
    • SMS Virtual Mobile Numbers (VMN)
    • Voice Numbers
    • What is the difference between a Shared and a Dedicated Number?
    • Why am I unable to buy a Number?
  • voice-calls
    • Billing & pricing
    • How many legs does a call have?
    • How to make an outbound call
    • How to receive a call
    • Masked transfer
    • Random Caller ID (CLI) on Voice calls
    • Recordings & transcriptions
    • What are the different call status and their meanings?
    • Where can I view my call details?
    • Number restrictions in China
  • voice-messages
    • How to send a Voice Message
    • What is the difference between a Voice Message and Voice Call?
Powered by GitBook
On this page
  • What is happening?
  • Useful resources
  • Key dates and what to be ready for
  1. payment-billing

WhatsApp Conversation Based Pricing Changes 2023

PreviousSuddenly getting billed by MessageBirdNextWill I be charged VAT?

Last updated 1 year ago

If you are a MessageBird customer that uses WhatsApp, you will know that part of your charges is made up of “vendor fees”. This is the amount that Meta charges us for usage incurred by you that we then pass on. For WhatsApp, this is called Conversations Based pricing.

Meta has announced some important changes to conversations-based pricing that will roll out over the next few months that include changes you may need to prepare for.

There will be no changes to any other charges you receive from MessageBird for using our services and APIs.

What is happening?

New price points for business-initiated conversations

Starting on June 1st, 2023, the current WhatsApp Conversations Based pricing model will be expanded from two chargeable conversation categories (business and user-initiated) to four. Business-initiated conversations will now fall under three categories:

  1. Utility conversations e.g. order updates, delivery updates, and other transactional use cases

  2. Authentication conversations e.g. one time passcodes (OTP) / account verification

  3. Marketing conversations e.g. promotions and offers

User-initiated conversations will be renamed to service conversations. In addition, conversations will only be charged at the service rate if you respond with free-form (non-templated) messages. Responding to customer inquiries with template messages will lead to a business-initiated conversation rate based on one of the three categories listed above.

The pricing for marketing conversations will get more expensive relative to business-initiated conversations today. The pricing for utility and authentication conversations will be slightly above the service rates.

New template categories

Currently, when creating a new WhatsApp template either through Facebook business manager, the , or via the you must categorize the template as either Marketing, OTP, or Transactional.

Enabling the introduction of the new business-initiated conversation categories will mean that Meta will be changing the categories supported when creating messaging templates. The new categories will be Marketing, Authentication, or Utility.

To support this MessageBird will only support these template categories when creating new templates via the Messagebird Dashboard or API from 15th March. Existing templates that use old categories will still be able to be edited using the old categories until 1st April 2023.

As part of using template categories to enforce more granular pricing Meta will also re-categorize templates based on the content used when creating the templates. On 1st April 2023, Meta will automatically migrate any templates with any old categories and re-categorize any templates that have content that doesn’t match the selected category.

If you feel your template is categorized incorrectly on 1st April 2023, you will have until 15th May 2023 to appeal the decision. If you have access to the WhatsApp business manager you will be able to appeal there. If you do not you will need to contact the support team.

Free conversations for service Conversations only

Currently, all WhatsApp business accounts are entitled to 1000 free conversations per month. This can be made up of business-initiated and user-initiated conversations e.g. 300 business initiated and 700 user-initiated. From June 1st 2023 business initiated conversations will no longer qualify as part of the 1000 free monthly conversations that you are currently entitled to. Only service conversations will qualify for the 1000 free monthly conversations.

Free entry point conversations for longer

From 1st March 2023 conversations that start from a free entry point (Click to WhatsApp ads) will be free for 72 hours instead of 24 hours. This means if a customer starts a conversation from a Facebook ad a business can respond with any type of WhatsApp message (including marketing templates) for free for 72 hours.

Multiple conversation windows are possible

One other change is - it will be possible to have multiple billable conversation windows open with a given customer if different template categories are used within a 24 period. Here are some examples:

  1. If a customer messages a business and the business responds with a free form (nontemplate message) the customer will be charged for one service-initiated conversation.

    1. If the business responds with a template message then the conversation will be charged at the business initiated (e.g. utility) not service initiated rate. This means that the conversation will also not qualify under 1000 free conversations.

    2. If the business responds with a free-form message followed by a template message the customer will be charged for two conversations; a service-initiated conversation and a business-initiated conversation (e.g. utility).

  2. Conversation charges will be based on template categories. When a template is delivered, it opens a new conversation of that category and incurs the charge of that conversation category, unless the template is delivered during an open conversation of that category.

    1. If a business sends two marketing templates in a row then the conversation charge will apply to the first template only

    2. If a business sends a marketing template followed by a utility template then the customer will be charged for a marketing conversation and a utility conversation

    3. If the business then follows up with another marketing template within 24 hours of the first marketing message this will be included in the original marketing conversation

Useful resources

Here are some useful resources prepared by Meta that also provide additional information:

Key dates and what to be ready for

All dates listed are in 2023

March 1st

  • Free entry point conversations (Click to WhatsApp ads) entitle customers to free conversations for 72 hours, increased from 24 hours. In this period any type of WhatsApp message can be sent without incurring further conversation charges.

March 15th

  • Templates created using any other category will still be available to edit as such until April 1st

April 1st

    • Only marketing, authentication, and utility will be accepted as valid categories when creating new WhatsApp templates through the WhatsApp business manager

    • Templates created with the old categories will automatically be migrated to new categories by Meta

    • Templates created with new categories may be re-categorized automatically by Meta if they determine the content of the template does not match the selected category

      • If a template with a new category was not created with the flag “allow_category_change” set to true the template will become rejected until; an appeal is successful, you change the template category, or resubmit the template with “allow_category_change” set to true

    • Templates that are re-categorized will have a new field called “previous category”

  • Title: WhatsApp template <name> for WhatsApp Account <wabaid> has been Rejected

May 1st

  • Meta will no longer support any old template categories. This change will have already been enforced by MessageBird on March 15th

May 5th

  • Any templates created with old categories will after April 1st be migrated to the new categories as above

May 15th

  • The appeals process for any templates that have been migrated to the new categories will close and appeals will no longer be possible

June 1st

  • The new Conversations Based pricing points will go live

  • 1000 free monthly conversations will only apply to user-initiated (service) conversations

For templates created with the new categories after 15th March if the “allow_category_change” flag is set to true then templates will remain approved if they are re-categorized. If this is set to false then the template will be rejected. See docs here for more details.

- this provides more details on some of the key events

- New rate cards that will apply from June 1st can be viewed here

Only marketing, authentication, and utility will be accepted as valid categories when creating new WhatsApp templates through the MessageBird dashboard or API. If you have an integration please make sure that you only use these categories when creating templates and are prepared for a template containing the new categories

If you subscribe to template and your template is rejected due to having an incorrect category set you will get a notification such as:

MessageBird dashboard
API
API
Launch timeline
Rate cards
API
notifications