Sandbox environment
The sandbox allows you to test inbound/outbound messaging without purchasing a dedicated sender name. You can use this feature to test the product or API before paying or using it in a production environment.
To use the sandbox:
- Open Dashboard, select your organization from the list, and then in the left sidebar, choose Sandbox
- Add a phone number or email to the sandbox contacts list. You must set a phone number or email that you set up as
Start new conversation fromin the Messages app. Check this article to learn more about this setting. - Initiate a conversation in the sandbox sender name by pressing
Compose message in sandboxfrom your Mac or iPhone. Once the sandbox sender receives your message, it will try to match a contact with your sandbox list. Once it’s matched, this message will be assigned to your account.
While a contact is added to the sandbox list, all requests and webhooks will be force-redirected to the sandbox. Please don’t forget to remove your contact from the sandbox when you are ready for production.
Sandbox limitation
- You can add up to 5 contacts to your sandbox list.
- Sandbox works only with your default (first) organization in the account.
- As soon as the “sandbox” receives a message from a contact and matches it to your account, it will open a 24-hour messaging window. This window resets every time you receive an inbound message from the contact.
- The Sandbox cannot initiate a conversation with a random contact. For every outbound message to a new contact, that contact must first send a message to the sandbox - as confirmation that the recipient is under your management.
- Group chats are not supported.
Please note: when you have finished working with a sandbox, you should remove your contacts from the sandbox list. Otherwise, all requests related to contacts in this list will be forcibly redirected to the sandbox.
Don’t use sandbox messaging in a production environment or for junk. If you will abuse it, we reserve the right to restrict your sandbox access.