ChatmaidChatmaid DevelopersChatmaid Dev
Docs
DashboardStart Building
Get Started

Environments

Single-host model, key-based environment behavior, and go-live path.

Base URL

  • https://developers-api.chatmaid.net

All integration endpoints are under /v1, for example: https://developers-api.chatmaid.net/v1/messages/send.

Integration host: https://developers-api.chatmaid.net.

Behavior Differences

  • Use sk_test_* keys for sandbox behavior and sk_live_* keys for production behavior.
  • Environment is inferred from API key prefix. Do not send environment in request body or query.
  • Sandbox simulates message delivery status progression. Test keys work without a subscription.
  • Production sends real WhatsApp messages via connected numbers. Live keys require an active subscription.
  • Webhook payload structure is identical across both environments.
Environment Isolation
Never reuse production API keys in sandbox or test keys in production. Keep keys and webhook endpoints separated by environment.

Go-Live Checklist

  1. Validate full flow using sk_test_* keys.
  2. Keep the same API host and switch credentials to sk_live_* keys.
  3. Point webhooks to production receiver endpoints and verify signatures.
  4. Monitor initial traffic for rate limits and delivery failures.
On This Page