--- title: "Rocket Chat WhatsApp Sandbox Guide" slug: "whatsapp-sandbox" description: "Test WhatsApp integrations with Rocket Chat sandbox. Experiment securely before full deployment to improve collaboration and customer messaging." status: "update" updated: 2026-10-30T01:21:09Z published: 2026-10-30T01:21:09Z canonical: "docs.rocket.chat/whatsapp-sandbox" excludeFromExternalSearch: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.rocket.chat/llms.txt > Use this file to discover all available pages before exploring further. # WhatsApp Sandbox ![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Enterprise.svg) The WhatsApp Sandbox App provides a secure environment for testing Rocket.Chat's integration with WhatsApp, using the 360dialog sandbox. This allows you to send both regular and template messages from your workspace to your customers on WhatsApp. Similar to the [WhatsApp Cloud app](/v1/docs/whatsapp-cloud-app), the sandbox app lets you experiment freely without risking your business data or disrupting ongoing operations. > This app is for testing only and not intended for production use. For production, use the official [WhatsApp Cloud App](/v1/docs/whatsapp-cloud-app). ## Prerequisites - A Rocket.Chat workspace with [Omnichannel](/v1/docs/omnichannel) enabled. Omnichannel [agents](/v1/docs/omnichannel-users#omnichannel-agents) and [managers](/v1/docs/omnichannel-users#omnichannel-managers) must also be assigned. - From 7.0, the WhatsApp Sandbox App requires a subscription add-on. [Contact the sales team](https://go.rocket.chat/i/get-addons) to get the required add-on. ## Install WhatsApp Sandbox App To install the WhatsApp Sandbox app, - Click **Marketplace** ![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot 2025-12-23 130453.png) > **Explore**. - Search for the **Whatsapp Sandbox** app. - Click **Install** and accept the needed permissions. You receive a message from `whatsapp-sandbox.bot` with setup instructions. > - If you don’t have the required add-on, a warning is displayed for you to contact sales to get the add-on. > - To get support, please run the `/whatsapp-sandbox support` command. ## Get the Test API key from 360Dialog To use the WhatsApp Sandbox App, you'll need a test API-KEY from 360dialog. To obtain the API-KEY: - Send a WhatsApp message with the content "START" to **4930609859535**, or use this [link](https://wa.me/4930609859535?text=START). - Alternatively, scan this [QR Code](https://docs.360dialog.com/docs/waba-messaging/sandbox#id-1.-get-a-test-api-key). You’ll receive your Test API-KEY, linked to the WhatsApp number you used. With this key, you can start using the 360dialog WhatsApp Sandbox. > [!NOTE] > For more details, refer to the [official documentation](https://docs.360dialog.com/docs/whatsapp-api/sandbox) on 360dialog Sandbox and its [limitations](https://docs.360dialog.com/docs/waba-messaging/sandbox#limitations). ## Configure WhatsApp Sandbox app After installing the app in your workspace, you can update the app settings according to your requirements. To do this, follow these steps: 1. On the **App Info** page of the app, go to the **Settings** tab. 2. Enter the values for the following fields: | Field | Description | | --- | --- | | **WhatsApp Sandbox API KEY******* | The [API KEY provided](/v1/docs/whatsapp-sandbox#get-the-test-api-key-from-360dialog) by 360Dialog for the sandbox environment. | | **Default department** | The default department to handle all conversations from WhatsApp Sandbox. | | **Welcome Message** | Enter the first message that your customers receive automatically when they message you. | | **Conversation Finished Message** | Enter the message that your customers receive automatically when an agent closes the conversation. | | **Service Unavailable Message** | Enter the message that your customers receive automatically when no agent is available for the conversation. | | **Agents Display Info** | Select the agent information that would be added to every agent's message. The options are as follows: - **None**: No agent information is displayed. - **Name**: The agent’s name is displayed in the conversations. - **Username**: The agent’s username is displayed in the conversations. | | **Allow Quote Messages** | If this option is enabled, agents can see the message when the contact quotes or replies to a message on WhatsApp. | | **Message Status Endpoint URL** | Enter an endpoint URL where you want to receive the status of outgoing messages. | | **Filter Message Status** | Select the statuses you want to receive at the **Message Status Endpoint URL** endpoint based on the message type. The options are as follows: - **All**: Receive the status of all messages. - **Regular Messages**: Receive the status of regular messages. - **Template Messages**: Receive the status of template messages only. By default, the value is **All**. | | **Allow List options for Quick Replies** | If this option is enabled, then messages with more than three quick reply options will be rendered as list options. Note that the maximum limit for list options is ten. By default, this option is enabled. | | **Custom label for all List Option button******* | Enter the custom label message you want to display on all quick reply options that are sent as a list. By default, the message is **Show Options**. | 1. Click **Save Changes**. After saving the API key, you can begin [sending WhatsApp messages](/v1/docs/whatsapp-sandbox-agents-guide) to the sandbox number from your linked phone number. The messages are delivered to your workspace and are ready for [agents](/v1/docs/omnichannel-users#omnichannel-agents) to respond. ## App slash commands The WhatsApp Sandbox app has a list of shortcuts to ease usage. Run the slash command `/whatsapp help` to see the list of shortcuts and their functions: - **/whatsApp-sandbox view-templates**: List the available [template messages](/v1/docs/whatsapp-sandbox#send-a-template-message) in the sandbox environment. - **/whatsapp-sandbox send-template:** Send a [template message](/v1/docs/whatsapp-sandbox#send-a-template-message) to a contact. - **/whatsapp-sandbox support:** Get support information - **/whatsapp-sandbox help:** See the help menu ## API endpoints The available endpoints are displayed on the **Details** tab of the **App Info** page. ### Incoming message The `POST incoming` endpoint is used by the app to receive messages from WhatsApp. You generally don’t need to take action with this endpoint. ### Send a template message You must use the `POST templateMessage` endpoint to send template messages to contacts. For more details, refer to the [developer guide on sending template messages in Rocket.Chat](https://developer.rocket.chat/v1/docs/whatsapp-business-template-messages). There are only three pre-defined template messages available on WhatsApp Sandbox. Templates cannot be created or modified. Consult the [360dialog documentation](https://docs.360dialog.com/docs/waba-messaging/sandbox#id-5.-send-a-template-message-optional) to learn more. ### Get the sidebar icon You can use the `GET get-sidebar-icon` endpoint to get the WhatsApp conversation room icons displayed in the **Chats in Progress** section on the left-hand menu. For example, the request looks like this: ```bash curl -X GET https://{workspace-url}/api/apps/public/87cf50f2-2db4-4e05-a8fd-135ad24f9c08/get-sidebar-icon ``` ## Uninstall WhatsApp Sandbox app To delete the WhatsApp Sandbox app from your workspace, - Click **Marketplace** ![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot 2025-12-23 130453.png) **> Installed**. - Click th**e kebab menu** against the **WhatsApp Sandbox** app. - Select **Uninstall**. - Click **Yes** to confirm the uninstallation.