Articles on: API Services

Sandbox environment

The sandbox allows you to test inbound/outbound messaging without using your credits or purchasing a dedicated sender name. You can use this feature to test the API before paying or using it in a production environment.

Messages sent within the Sandbox will always contain technical information at the end of each message.

To use the sandbox, you need to add a phone number or email as a sandbox contact in the Dashboard -> Conversation API -> Settings, then initiate a conversation with the sandbox sender name by pressing Compose message in sandbox from your Mac or iPhone.

You must set a phone number or email that you set up as Start new conversation from in the Messages app. Check this article to learn more about this setting.

In this case, all your requests for this contact will be force-marked as the sandbox. Sandbox works only with one-to-one messaging. With group chats, this feature may be unstable (most likely you will able to accept inbound messages but not reply there).

Please note that when your implementation is ready to use in a production environment, you may need to remove the specified contact from the sandbox list. Otherwise, all requests related to this contact will continue to be processed in the sandbox.

Don't use sandbox messaging in a production environment. If you will abuse it, we reserve the right to restrict your sandbox access.

It is strongly recommended that you first init a conversation in the sandbox, and only then reply to a message through API. This way you will be able to reproduce the full cycle of 2-way conversation as it would be in a production environment. If you successfully sent an outbound message first without receiving an inbound message before, this does not mean that it will work exactly the same in a production environment.

Updated on: 24/10/2024

Was this article helpful?

Thank you!