Sandbox Mode is a restricted testing environment for new channels. It allows users to test certain API functionalities before subscribing to a plan. Unlike Production Mode, Sandbox Mode limits the channel’s interactions to a single designated contact.

Limited Testing

Test API with one contact

7-Day Trial

Free testing period

Easy Upgrade

Subscribe to remove limits

​
How Sandbox Works

Channel Creation

When creating a new channel, users can choose between Sandbox Mode and Production Mode via a switch button in the form.

Contact Assignment

If Sandbox Mode is selected, the user must provide a phone number. The channel can only interact with this one predefined contact.

Trial Period

The trial period for Sandbox Mode lasts 7 days. After 7 days, the channel and its data are automatically deleted if no subscription is purchased.

Subscription Benefits

Subscribing to a plan automatically removes the Sandbox restrictions and transitions the channel to Production Mode.

​
API Limitations in Sandbox Mode

Endpoint Restrictions

  • Only specific API endpoints are allowed
  • Any request requiring contact_id must match the preassigned phone number
  • Requests to unauthorized endpoints will be rejected

Allowed Endpoints

  • All endpoints that do not include contact_id will be rejected
  • Endpoints that include contact_id will be allowed only if the provided phone number matches the sandbox.phoneNumber

​
Error Handling in Sandbox

​
How to Transition to Production

Subscribe to a Plan

To remove Sandbox restrictions, the user must subscribe to a paid plan.

Automatic Transition

Upon successful subscription, the channel transitions to Production Mode.

Unlimited Contacts

The predefined contact limitation is lifted, allowing you to interact with any number of contacts.

​
Best Practices

Initial Testing

Use Sandbox Mode for initial integration testing.

Assigned Contact

Test only with the assigned contact to prevent issues.

Verify Features

Before going live, ensure all necessary features work as expected.

​
Frequently Asked Questions

Ready to test the CrunchzApp WhatsApp API? Create a Sandbox channel to start experimenting with our API features before committing to a subscription plan.