WhatsMate home page

Telegram Gateway API - Frequently Asked Questions

Question: I want to try our your API services. How should I proceed?

Thank you for your interest in our services.

First, you subscribe to a plan that suits your needs. We recommend you choose a plan with the Trial option.

Then, you will receive a confirmation email for your subscription. Read the instructions in the email entirely.

You need to follow and complete each and every step carefully and patiently. If you miss one of the steps, it won't work for you.

Have fun!

Question: I have just paid and subscribed to the service. Why didn't I get the confirmation email?

Look in both of your INBOX and SPAM folders of your email account. Most of our customers who had this issue found it in their SPAM folder.

Also, if you have more than one email accounts, make sure you check all of them.

Contact us if you still can't find the confirmation email after you have done all the above.

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 Telegram on your iPhone / Android phone.
  3. Send a "Hi" message to the gateway from your phone's Telegram.
  4. Expect a confirmation message from the gateway.

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

Question: I can send messages to my own Telegram account via the gateway. But I can't send messages to other people. Why?

That's probably because the "other people" did not register with the Telegram gateway. Ask them to say "Hi" to the gateway from their Telegram client like you did. If you are still confused, read the answer to the previous question.

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: What are the limits on the size of the text messages, images and documents (e.g. PDF) etc?

Here are the limits on the size of the message for different message types:

  • Text: 800 characters max
  • Image: 2 MB max
  • Document (e.g. PDF): 3 MB max

Question: Can I send out messages from a local number of my country?

Yes, the Enterprise Telegram Gateway should be able to help you. Contact us for details.

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

Yes, the Enterprise Telegram Gateway should be able to help you. Contact us for details.

Question: What do I get if I subscribe to a Premium / Enterprise plan?

If you want to send Telegram messages to your users, you need to first subscribe to a Premium plan.

See the table below to understand what the Premium plan and Enterprise Solution have to offer:


Premium Plan

Enterprise Solution
Target User
First-time and existing users
Corporate and business users
Max. # of messages per day
Max. # of recipients in TOTAL
Varies. Max is 12 months.
Auto-Renewal option available.
Varies. Minimum is a quarter.
Max is 12 months.
Sample Code provided
Receive text messages from individuals/groups by webhook
Use custom profile picture
Bring your own number
Email Support

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

It is unlikely - but still possible. Although we make every effort to prevent spamming (which will surely cause our service to be banned), there's still a chance that it could happen if some users abuse the shared gateway.

The Enterprise Solution can help reduce the likelihood because you are the only user of the dedicated gateway. Contact us for more details.

Question: My premium account has expired. What should I do?

Subscribe to one of the plans with your existing client ID. Your account will then be renewed.

Question: It gave me an error when I called the REST API. What was wrong?

Check the status code and the output from your REST API call. Take the remediation steps accordingly.

Status Code
Error message
Remediation Steps
You have consumed all the paid daily quota.
  1. Observe your daily quota.
  2. Wait 24 hours and your daily quota will be reset.
Document / Image cannot be empty.
  1. You attempted to send a document / an image but you probably forgot to specify its content in your API call.
  2. Review your source code and specify the content.
Destination number is invalid.
  1. Check your destination number and make sure that it includes the country code as well.
  2. If you still get this error after including the country code in your destination number, contact us and we will investigate this with you.
Invalid CLIENT ID / Secret
  1. Check your CLIENT ID and CLIENT Secret. You probably had a typo in them.
  2. If you can't find any typo in them, your account has probably expired. Renew your account immediately.

Question: I am on an Auto-Renewal subscription plan. Can I cancel my subscription?

Yes, you can cancel your subscription any time. By canceling your subscription, you stop all future payments that are scheduled to happen if you are on an Auto-Renewal plan. Just contact us and we will give you further instructions.

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

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