Sending messages in the messengers Business API. The /contacts method

As the most popular messenger on the planet with almost 2 billion audiences, audiences have a vast base of potential customers, so messengers Business API is attractive to many as a tool for commercial mailings. At the same time, Comp has its vision of working with the messenger and introduces number of restrictions and rules that must be considered when conducting mailings. Let's figure out how to send messages in the messengers Business API properly.

Compliance with messengers and Comp trade Policy

First of all, it is necessary to note the messengers trade policy. If your messages violate the policy’s requirements and disseminate information prohibited by Comp, the news will not be sent, and the account may be banned. You can challenge the Comp decision by filling out this form.

In addition, Comp assumes that you must obtain consent from the client to send him messages, ideally in the form of a written agreement, but in practice, almost no one enters into such an agreement. For our part, we recommend building communication with customers so that they can express their consent and interest in communicating with you, as well as refuse if they are not interested in your mailings.

If complaints are received about your messages, this may lead to a drop in the rating of the number. Read more about it here.

Message templates are the first step to contacting a client

You can't just write a message to a client in messengers using MESAPI; before that, you need to compose a template message, which, after Comp approval, can be sent to the client.


You can use our "Quick Templates" for this. Quick messages are an alternative to template messages for those who do not want to waste time creating them. When you send text messages outside the 24-hour dialog box, we automatically turn them into templates using pre-approved variables. To use them, it is enough to use the /SendMessage function.

Back in early 2022, template messages could have been rejected due to their excessive "advertising", Comp required MESAPI partners to maintain a less commercial approach to communicating with customers, but everything changed very quickly, at the moment Comp approves almost all templates, except for those that clearly violate the messenger's trade policy.

A template message can be created using the /addTemplate method of our MESAPI documentation.

And also through the built-in constructors in the personal account Chat API and Comp-business manager.

You can learn more about how to work with templates and how to use them here, and how to send files through them here.

Checking the number using the /contacts method before sending a message

Before sending a template message, if you have not had any communication with the user before, you need to check with the /contacts method. This method contains the number (verifies) on the ability to send messages and returns the status of the number along with the ID. Only after activating the /contacts method does it becomes possible to send a template message. Without this step, your messages won't be sent.


This rule also has exceptions. If you use our quick messages via /SendMessage to open the dialog, then we will automatically use /contacts to check the number, that is, you do not need to worry about checking contacts before sending, we will do it for you.

Now for more details

Send a POST request /v1/contacts, after which you will have the opportunity to enter the numbers of interest. It is better to determine the contact database in advance and send them in one request, since too frequent use of the /contacts method can lead to dissatisfaction with Comp, but more on this below. You can enter numbers in any format, while Comp advises you to specify numbers with a «+» and indicating the country and city code separated by spaces:

Next, the API will return you the ID of the number along with the statuses; there are four of them in total:

1 – "Valid" – everything is fine, the number is available for communication;
2 – "Processing" – the data is still being processed;
3 – "Invalid" - a number that is not available for communication;
4 – "Failed" – something went wrong.
Use the provided messengers ID to send template emails.

Important limitations:

- Comp promises to ban messengers Business API users who check numbers but do not send messages. You use this method only for contacts to whom the mailing will be sent, and we advise you to exercise reasonable caution in the number of numbers being checked.

- Comp currently does not have the ability to notify about changes in the status of the number, so this method will have to be used on an ongoing basis. Verification of numbers using the \contact method must be carried out once every 7 days. If you skip this period, it will be impossible to send messages to the numbers.

- You can use /contacts through our testing tools, but the request to check the message array will not be available.

Write to us if you have any questions about working with messengers Business API , we will be happy to help you. You can find out all the latest news on the work of the service in our telegram channel.

The original article.

Was this article helpful?

Your opinion will be used to improve the content of the article

The Most Multifunctional API Provider

Chat API has been operating since 2015 and is one of the first and largest providers in Eastern Europe.

Here are some curious and important figures:

  • We have tremendous expertise in docker container management at scale with an SLA of 99.5+%;
  • Chat API involves in its work more than 200 servers, with the ability to quickly connect another 100;
  • 3200 cores and 25 terabytes of RAM;
  • 200+ methods and features that keep adding;
  • Highload system, Up Time servers 99.9%;
  • Support 24\7;
Get access to the API