WhatsMate home page

WhatsMate Telegram Gateway API - Frequently Asked Questions




🎯 Question: Who can use your API services? Who is your target audience?

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.


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

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!


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

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 them all.

Contact us if you still can't find the email after checking thoroughly.


💬 Question: I wanted to send myself a message but didn't receive anything. Why?

The most common cause is that you forgot to pre-register your number with the gateway. Follow these steps to register:

  1. Add the gateway's number (the secret number) to your phone's contacts.
  2. Open Telegram on your iPhone or Android phone.
  3. Send a "Hi" message to the gateway from your Telegram client.
  4. Wait for a confirmation message from the gateway.

Watch this video to understand how the gateway works:


💬 Question: I can send messages to myself but not to other people. Why?

The other recipients probably haven't registered with the gateway. Ask them to say "Hi" to the gateway from their Telegram client, just like you did.


🔑 Question: I just made a subscription. Where's my CLIENT_ID and CLIENT_SECRET?

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:


🔒 Question: Can I send messages to people who haven't pre-registered with the gateway?

No, 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.


📢 Question: Can I use your API for marketing campaigns (bulk promotional messages to strangers)?

No. We are against spamming. Please read the answer above to understand 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 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 the following video for a demo:


📏 Question: What are the limits on the size of text messages, images and documents?

Here are the limits for different message types:

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


📍 Question: Can I send messages from a local number in my country?

Yes, the Enterprise Telegram Gateway can help you. Contact us for details.


📥 Question: Can my application both send and receive messages?

Yes, the Enterprise Telegram Gateway supports two-way messaging. Contact us for details.


⭐ Question: What do I get with Premium vs Enterprise plans?

To send Telegram messages to your users, you need to subscribe to a Premium plan.

See the comparison below:


 




Premium Plan


Enterprise Solution
 
Target User
First-time and existing users
Corporate and business users
 
Max. # of messages per day
200
2000
 
Max. # of recipients in TOTAL
50
1000
 
Expiry
Varies. Max is 12 months.
Auto-Renewal option available.
Varies. Minimum is a quarter.
Max is 12 months.
 
Sample Code provided
       
Receive messages via webhook
 
Custom profile picture
 
Bring your own number
 
Email Support
 

⚠️ Question: Will the gateway be banned by Telegram?

It's unlikely but possible. Although we make every effort to prevent spamming, there's still a chance if some users abuse the shared gateway.

The Enterprise Solution reduces this risk because you're 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 be renewed.


❌ Question: I got an error when calling the REST API. What was wrong?

Check the status code and error message. Take the remediation steps accordingly.


Status Code
Error message
Remediation Steps
 
469
You have consumed all the paid daily quota.
  1. Observe your daily quota.
  2. Wait 24 hours and your daily quota will be reset.
 
470
Document / Image cannot be empty.
  1. You attempted to send a document/image but forgot to specify its content.
  2. Review your source code and specify the content.
 
471
Destination number is invalid.
  1. Check your destination number and make sure it includes the country code.
  2. If you still get this error after including the country code, contact us and we will investigate.
 
474
Invalid CLIENT ID / Secret
  1. Check your CLIENT ID and CLIENT Secret for typos.
  2. If there's no typo, your account has probably expired. Renew immediately.

🛑 Question: I'm on an Auto-Renewal plan. Can I cancel my subscription?

Yes, you can cancel anytime. Canceling stops all future scheduled payments. Just contact us and we will give you further instructions.


📧 Question: I sent an inquiry but never received a reply. Why?

We respond to all inquiries by email. If you don't receive a reply within 48 hours, you may have entered a wrong email address. Send your inquiry again with the correct email address.


Need more help? Contact our support team | ⏱️ Response time: 24-48 hours