WhatsMate home page

WhatsApp Gateway API - Frequently Asked Questions

Question: I wanted to send myself a message. But even after I ran the sample code, I didn't receive anything. Why?
The most common cause is that you forgot to pre-register your number with the gateway. Do the following to register:
  1. Add the gateway's number (i.e. the secret number) to your phone's contact.
  2. Open WhatsApp on your iPhone / Andoird phone.
  3. Send a "Hi" message to the gateway from your phone's WhatsApp.
  4. Expect a confirmation message from the gateway.

Watch the following video to understand how the gateway works:

Question: I just made a donation. Where's my CLIENT_ID / CLIENT_SECRET?

Thanks for your donation. But you don't need any personalized CLIENT_ID or CLIENT_SECRET. Just use what's already in the sample code. Simple, isn't it?

You do need to follow the instructions patiently and carefully. Most people fail to send messages because they don't follow the instructions.

Language-specific instructions:

This video demonstrates what you need to do to send your first message:

Question: Can I send messages to people who have not pre-registered with the gateway?

No. This is by design. The goal is to prevent spamming.

Imagine this: When you receive an unsolicited message from a person not in your contact list, what would you do? You would probably get angry and report it to WhatsApp as SPAM. Makes sense?

Now, if you were allowed to send messages to anyone without pre-registration, the recipients of your message (i.e. your customers) would very likely do the same thing, i.e. get angry and report your message as SPAM. You don't want to make your customers angry, do you? That's why pre-registration is required.

Question: Can I register in my native language?

Yes, in some cases.

If you speak English, you and your users register with the gateway by sending a "Hi" message to the gateway.

If you speak Arabic, Chinese, Dutch, French, German, Hebrew, Hindi, Indonesian, Italian, Japanese, Portuguese, Russian, Spanish or Ukrainian, you can do so in your native language now!

Just say one of the following: 嗨, 你好, 安安, こんにちは, ハイ, Ching, Ciao, Hai, Hallo, Hola, Hoi, Oi, Salut, Здравствуй, Привіт, नमस्ते, היי, ﻡﺮﺤﺑﺍ

Watch the following video for a demo:

Question: I have consumed all the trial quota. What should I do to continue sending messages?

Subscribe to a Forever Green plan now. It's the lowest-cost solution that allows you to send WhatsApp messages after the trial period.

See the table below to understand the differences between the trial plan and the Forever Green plan:


Trial Plan

Forever Green Plan
Target User
First-time users of the API
First-time and Existing users of the API
Max. messages per day
Bonus Month for New User
After you send 1000 messages. Upgradable to "Forever Green".
Depends on your subscription type. Longest is 12 months. Renewable.
Email Reminder before Expiry
Email Support
Sample Code provided

Question: I need to send more than 40 messages per day. What can I do?

The Enterprise Gateway may be able to help you.

Question: My application needs to both send and receive messages. Can I do that?

Unfortunately, the WhatsApp gateway does not allow you to do that.

However, if you can switch to Telegram from WhatsApp, our Telegram gateway will allow you to both send and receive messages to/from your users who use Telegram. Check out our Telegram Gateway API for more details. Alternatively, you can contact us for more details.

Question: Can I send multimedia messages such as images, locations, etc?

No. The WhatsApp gateway only supports the sending of text messages at present.

However, if you can switch to Telegram from WhatsApp, our Telegram gateway will allow you to send multimedia messages to your users who use Telegram. Check out our Telegram Gateway API for more details. Alternatively, you can contact us for more details.

Question: Can I send messages to a WhatsApp group?

No. The gateway only supports the sending of text messages to individuals.

Question: I ran my program to send myself a message but nothing happened. Why?

Make sure you have already registered with the gateway. Refer to the answer to the very first question for more details.

If you have already registered, make sure you specify the correct destination number (i.e. your own WhatsApp number including the country code) in your source code.

If you have checked all the above, give it some time because it can take up to 10 minutes for the gateway to process the messages in the queue.

We strongly recommend that you consider switching to Telegram from WhatsApp. It's more reliable, more robust and more powerful. Contact us with your donation reference number and we will give you more details.

Question: Will the gateway be banned/blocked by WhatsApp?

It is possible. Although we make every effort to prevent spamming (which will surely cause our service to be banned), there's still a chance that WhatsApp can block our gateway for no reason. If that happens, our gateway will stop working immediately.

Question: Is there an API for me to query for the gateway's status?

Yes. The API reference has the details.

Question: What can I do to help minimize the possibility of getting the gateway banned by WhatsApp?

We are glad that you asked. You can help us by NOT sending too many messages too often. We are on the same boat after all. If the boat sinks, all of us drown.

Question: The gateway worked for me last week. But I can't get my messages out now. Why?

As mentioned above, the gateway might have been blocked and we may have switched to a new gateway number. Contact us for more details if it happens to you.

Question: I just need a way to send out instant notitications. What's your recommendation?

Given the possibility that WhatsApp may ban our gateway's number for no reason, we recommend our users consider switching to Telegram (it's another instant messaging technology. Just like WhatsApp. But it's more reliable and powerful.). When you do, our Telegram Gateway API will be able to help you.

Question: I sent in an inquiry via the Contact-us form. But I never receive a reply. Why?

We respond to all inquiries. If you don't receive a reply within 24 hours, it's likely that you might have left a wrong email address. Send in your inquiry again with a correct email address.