Introduction
Getting Started
Send API
Management API
ChatApps Groups
Webhooks Configuration API
Chat Apps - Callbacks Reference
Chat Apps - Additional Information

Before you get started, please contact your account manager to ensure that your account has access to this product and that the following points have been managed:

  1. You will need a new subAccountId to use this API endpoint - it can’t be an existing SMS SubAccount.

  2. In order to use your existing channels such as WhatsApp, Messenger, WeChat, Line, Viber, Zalo, Google RCS… we will have to configure them for you.

  3. The Fallback Mechanism has to be setup by Wavecell. You need to define which channels you want to use (in which order) and the time between each channel is triggered.

Once this is done, you can use the following API endpoints. The API key is available in the Customer Portal.

Authentication

  • Wavecell ChatApps API uses an ApiKey Bearer Token authentication method.
    • You can generate tokens from your customer portal https://app.wavecell.com/
    • You need to include the following header in your requests: Authorization: Bearer {apiKey}
      • NB: (replace the {apiKey} placeholder with the key generated from the customer portal)

If you haven’t created your account, please go to Wavecell website https://wavecell.com to sign up.

URL

  • The Wavecell subaccountid to use is defined in the URL where you send your POST request as shown below:

    https://api.wavecell.com/chatapps/v1/{subAccountId}/message/single

You must replace {subAccountId} in the URL above with the subaccountid that you want to use.

API Rate Limiting

To protect the platform from being overloaded and maintain a high quality of service to all customers, Wavecell enforces API rate limits for its Chat-Apps API.

The rate limit model consists of a per-second request limit applying to every API endpoint. The limit is set to 5,000 requests/second per subaccount with no maximum daily quota.

Tip: If you need to submit a high volume of messages in a short period for bulk scenarios, make sure to use the endpoint allowing to send Chat-Apps messages by batch instead of the single endpoint: it allows you to submit up to 10,000 messages in a single request.