The sandbox is a way for you to try out the WhatsApp Business API even without access to the production setup. The sandbox gives you an experience of most of the features and functionalities of the WhatsApp Business API. Please note that the purpose of the sandbox is testing, and it should not be used for sending messages to your customers.
This document covers:
A sandbox account can be created via your Business Manager account. See the Create a WhatsApp Business API Sandbox Account Help Center article for instructions.
It should take about 30 minutes for the sandbox to be activated. Once it has been activated, the Settings tab of the sandbox account will show the details of sandbox phone number, the hosted WhatsApp Business API Client URL, and the username and password. Also displayed are the date and time that the sandbox will expire.
You can set up one sandbox per Business Manager, and each sandbox is only active for 30 days. If you need to continue testing after that, you can request a new sandbox when the old one expires.
Please note that anything sent using the sandbox is not end-to-end encrypted as WhatsApp hosts the WhatsApp Business API client.
You can use the sandbox to try the Messaging and Account Management features of the WhatsApp Business API. There are two set of tools for testing these functionalities:
The login information for both of these is the username and password found under the sandbox's Settings tab.
The sandbox is created with a random default password for the admin user. If you would like to change the password, you will need to use the Login-Admin template found under 00-Users in Postman and follow the first login procedure.
The Settings tab will continue to display the original password once you have changed the password due to restrictions in the system, but you will need to use the new password when you wish to login.
You can use the WhatsApp Business API sandbox to send and receive messages with up to 5 phone numbers. These numbers need to opt-in to the sandbox in order to receive messages. At this time, only 5 numbers can join a sandbox. After 5 numbers have opted-in, any additional numbers you try to add won't receive any messages or trigger callbacks.
To opt-in a number, send Join from the phone number to the sandbox's phone number, which is found in the sandbox's Settings tab in the Business Manager. You can stop receiving messages from a sandbox by sending Leave to the sandbox number.
Please note that the WhatsApp Business API Sandbox's Web Business Tool currently only works in Chrome.
Once a number has opted-in to the sandbox, you will see it in the Messaging tab of the Web Business Tool, and the 2. Try the API section will reveal the various messaging types available to you: Template, Text, Document, and Media.
Any messages sent thru the Web Business Tool will be displayed in the right side column under the Messaging tab. Please note that only the last 50 messages will be displayed at a time; they are also not retained in the Web Business Tool long term and will disappear if the page is refreshed.
The Web Business Tool has a selection of test template message types for you to send including account balance, booking confirmation, ordering notification, and a blank template. The account balance, booking confirmation, and order notification templates are already populated with example text, variables, and default values. These pre-defined templates are only available with the
en language setting.
You can test sending freeform text messages by doing the following:
You can test sending document files by doing the following:
You can test sending photos by doing the following:
Postman is a third-party tool that WhatsApp has developed an API collection for in order to make sending API calls easier.
You need to use the namespace and element information of the example template messages in the Web Business Tool to send a test template message from Postman using the Send-HSM-Messagetemplate under 04-Messages.
See the Sending Message Templates documentation for more information on the fields involved in sending template message API calls.
Use the Send-Text-Message template found under 04-Messages to send test text messages.
See the Sending Text Messages documentation for more information on the fields involved in sending text message API calls.
To send document and media messages, you must first upload the file you wish to send in the message using the Upload-Media template under 06-Media. The response will include the ID you need to send the message using either the Send Image-Message-JPEG or Send-Doc-Message-PDF template under 04-Messages.
See the Sending Media Messages documentation for more information on the fields involved in sending media message API calls.
Using Account Settings you can set your account's About information and profile picture. You can also set Business information such as address, description, email address, and website URL.
In Postman, you can find the Profile and Business Profile templates under 01-Settings.
Application Settings affects the the behavior of the WhatsApp Business API Client allowing you to set things like intervals, webhooks, and auto-download settings.
In Postman, you can find the Application and Two-Step Verification templates under 01-Settings.
See the /v1/settings/application endpoint documentation for more information.
Please note that the default URL displayed in the Webhooks URL field allows the Web Business Tool to display the messages you send and receive in the Messaging tab, so we do not recommend changing it if you are relying on the Web Business Tool for your testing.
Due to the nature of the WhatsApp Business API Sandbox, there are some features that are not available or are restricted. The features that are not available in the sandbox include:
Feature restrictions include:
contactsendpoint at a time.