WhatsApp Gateway API - Frequently Asked Questions
Software developers and DevOps engineers are our target audience. To use our API, you need programming experience and the ability to follow the documentation step by step.
If you don't have technical experience, consider whether this API is the right fit before subscribing.
Thank you for your interest in our services.
First, subscribe to a plan that suits your needs. We recommend choosing a plan with the Trial option.
You'll receive a confirmation email with setup instructions. Read the entire email carefully.
Follow each and every step in order. Missing even one step will prevent the API from working.
Have fun!
Check both your INBOX and SPAM folders. Most customers who report this issue find the email in their SPAM folder.
If you have multiple email accounts, check all of them.
Contact us if you still can't find the email after checking thoroughly.
The most common cause is that you forgot to pre-register your number with the gateway. Follow these steps to register:
- Add the gateway's number (the secret number) to your phone's contacts.
- Open WhatsApp on your iPhone or Android phone.
- Send a "Hi" message to the gateway from your WhatsApp client.
- Wait for a confirmation message from the gateway.
Watch this video to understand how the gateway works:
The other recipients probably haven't registered with the gateway. Ask them to say "Hi" to the gateway from their WhatsApp client, just like you did.
After payment, you should receive an email with your CLIENT_ID and CLIENT_SECRET. If you don't receive it, contact us with your PayPal transaction ID.
Then follow the language-specific instructions to send your first message:
This video demonstrates how to send your first message:
No, not with the Forever Green plan. Pre-registration prevents spamming.
Think about it: when you receive an unsolicited message from someone not in your contacts, what do you do? You probably report it as SPAM. The same applies to your customers — pre-registration protects everyone.
No. We are against spamming. Please read the answer above to understand why pre-registration is required.
Yes, in some cases.
If you speak English, you and your users register by sending "Hi" to the gateway.
If you speak Arabic, Chinese, Dutch, French, German, Hebrew, Hindi, Indonesian, Italian, Japanese, Portuguese, Russian, Spanish or Ukrainian, you can register in your native language!
Just say one of the following: 嗨，你好，安安，こんにちは，ハイ，Ching, Ciao, Hai, Hallo, Hola, Hoi, Oi, Salut, Здравствуй, Привіт, नमस्ते, היי, ﻡﺮﺤﺑﺍ
Watch this video for a demo:
Yes, the Enterprise WhatsApp Gateway plan can help with this.
No. And you should be happy to hear this.
Imagine the opposite: if anyone could send messages using YOUR identity without your approval, that would be scary and could lead to serious problems.
However, if you have a new local SIM card without an existing WhatsApp account, we recommend that you consider our Enterprise WhatsApp Gateway plan.
To send WhatsApp messages to your users, you need to subscribe to a Forever Green plan.
See the comparison table below:
Trial Period
Forever Green Plan
Enterprise Solution
Auto-upgrade to Forever Green.
Auto-Renew option available.
Max is 12 months.
Here are the message size limits:
- Text: 800 characters max
- Image: 2 MB max
- Document (e.g. PDF): 3 MB max
Send yourself the text messages in the left column and see what you get:
Good job! (y)
Good job! 
This is bad! (n)
This is bad! 
Happy face :-)
Happy face 
Unhappy :-(
Unhappy 
Being naughty :-p
Being naughty 
No comment :-|
No comment 
Love you <3
Love you 
Smiling eyes ^_^
Smiling eyes 
If you don't send any message for 24 hours or more, the first message you send after that marks the beginning of your new 24-hour quota period.
The Enterprise WhatsApp Gateway plan can help you with higher limits.
Yes, the Enterprise WhatsApp Gateway supports two-way messaging.
Yes, we have added new APIs for images and documents. Check out these guides:
Note: These APIs are in Beta and may be unstable at times. Use at your own discretion.
Yes! Check out our guide to sending WhatsApp group messages.
It's possible. Although we make every effort to prevent spamming (which would surely cause our service to be banned), there's still a chance WhatsApp could block our gateway unexpectedly. If that happens, the gateway will stop working immediately.
We're glad you asked. Help us by NOT sending too many messages too often. We're on the same boat — if it sinks, we all drown.
As mentioned above, the gateway may have been blocked and we may have switched to a new gateway number. Contact us for details if this happens to you.
Check the status code and output from your REST API call. Take the remediation steps accordingly.
- Observe your daily quota.
- Wait 24 hours and your daily quota will be reset.
- You attempted to send a document/image but forgot to specify its content in your API call.
- Review your source code and specify the content.
- Check your destination number and make sure it includes the country code.
- If you still get this error after including the country code, contact us and we will investigate.
- Check your CLIENT ID and CLIENT Secret for typos.
- If you can't find any typo, your account has probably expired. Renew your account immediately.
Yes, you can cancel anytime. Canceling stops all future scheduled payments. Just contact us and we will give you further instructions.
We respond to all inquiries by email. If you don't receive a reply within 48 hours, you probably entered a wrong email address. Send your inquiry again with the correct email address.
By subscribing to our Services, you agree to these Terms and Conditions.