messengers Business API

Официальный канал для интеграции с messengers.
Быстрый старт, защита от блокировки, не нужно держать телефон включенным.

Подключить messengers API

Удобный для разработчиков API для интеграции с CRM, ботами и т.п.

Официальные рассылки и боты
Отправляйте утвержденные рассылки от имени вашей компании без риска блокировки
Кнопки в сообщениях
Добавьте интерактивные кнопки к сообщению: клиент ответит вам в одно нажатие
Максимальная скорость доставки
Никаких задержек — скорость отправки и приема до 100 сообщений в секунду

Цена

Ежемесячная подписка
2900/месяц

Моментальный доступ к messengers API

Никаких скрытых платежей

Дарим 1000 диалогов *

*
Каждый месяц, а далее, плата за каждый диалог взимается согласно:
Cтоимости диалоговых сессий в Chat API

Базовый конструктор лендинг-ботов

Служба поддержки

Визуальный конструктор ботов *

*
Временная акция
Выбрать
Ежегодная подписка
2400/месяц

Моментальный доступ к messengers API

Никаких скрытых платежей

Дарим 1000 диалогов *

*
Каждый месяц, а далее, плата за каждый диалог взимается согласно:
Cтоимости диалоговых сессий в Chat API

Базовый конструктор лендинг-ботов

Служба поддержки

Визуальный конструктор ботов *

*
Временная акция
Выбрать
Лучшая цена

Быстрая и понятная самостоятельная активация учетной записи

Отправить шаблон (инициировать диалог)

messengers ограничивает содержание текстов сообщений, с помощью которых можно начать разговор с клиентом или продолжить разговор через 24 часа после последнего сообщения клиента. Это сообщение должно быть заранее утвержденным шаблоном. За отправку шаблона взимается плата, так как это инициирует диалог. Если клиент ответил вам, вы можете общаться с ним бесплатно в течение 24 часов с момента получения ответа. Читать подробнее.

$data = [
    'phone' => '79995253422', // Receivers phone
    'template' => 'template_name', // Template name
    'namespace' => 'namespace_of_template', // Namespace of template
    'language' =>  ['code' => 'en', 'policy' => 'deterministic'], // Language parameters
];
$json = json_encode($data); // Encode data to JSON
// URL for request POST /message
$token = '83763g87x';
$instanceId = '777';
$url = "https://api.chat-api.com/instance{$instanceId}/sendTemplate?token={$token}";
// Make a POST request
$options = stream_context_create(['http' => [
        'method'  => 'POST',
        'header'  => 'Content-type: application/json',
        'content' => $json
    ]
]);
// Send a request
$result = file_get_contents($url, false, $options);
var request = require('request'); //bash: npm install request
// URL for request POST /message
const token = '83763g87x';
const instanceId = '777';
const url = `https://api.chat-api.com/instance${instanceId}/sendTemplate?token=${token}`;
var data = {
    phone: '79995253422', // Receivers phone
    template: "template_name",
    namespace : "namespace_of_template",
    language: {
        code: "en",
        policy: "deterministic"}
};
// Send a request
request({
    url: url,
    method: "POST",
    json: data
});
// URL for request POST /message
const token = '83763g87x';
const instanceId = '777';
const url = `https://api.chat-api.com/instance${instanceId}/sendTemplate?token=${token}`;
let data = {
    phone: '79995253422', // Receivers phone
    template: "template_name",
    namespace : "namespace_of_template",
    language: {
        code: "en",
        policy: "deterministic"}
};
// Send a request
$.ajax(url, {
    data : JSON.stringify(data),
    contentType : 'application/json',
    type : 'POST'
});
curl \
-d '{"phone": "79995253422","template": "template_name", "namespace" : "namespace_of_template", "language": { "code": "en", "policy": "deterministic"}}' \ # Phone and template parameters
-H "Content-Type: application/json" \ # Headers
-X POST \ # Type = POST
"https://api.chat-api.com/sendTemplate?token=83763g87x" # URL for request POST /message

Отправить сообщение

Если диалог был инициирован клиентом, то вы можете отвечать обычным сообщением. Этот диалог так же является оплачиваемым, если вы ответили клиенту. Вы можете общаться с ним бесплатно в течение 24 часов с момента ответа. Читать подробнее про Диалоговую модель тарификации.

// URL для запроса GET /messages
        $token = '83763g87x';
        $instanceId = '777';
        $url = 'https://api.chat-api.com/instance'.$instanceId.'/messages?token='.$token;
        $result = file_get_contents($url); // Отправим запрос
        $data = json_decode($result, 1); // Разберем полученный JSON в массив
        foreach($data['messages'] as $message){ // Распечатаем каждое сообщение
            echo "Отправитель:".$message['author']."<br>";
            echo "Сообщение: ".$message['body']."<br>";
        }
var request = require('request');// npm install request
        var token = '83763g87x';
        var instanceId = '777';
        var url = `https://api.chat-api.com/instance${instanceId}/messageы?token=${token}`;
        request(url, function (error, response, body) { // Выполним GET запрос на URL
            if (error) return console.error('HTTP Error', error);
            // Декодируем ответ
            var data = JSON.parse(body);
            // Для каждого сообщения
            for (var i = 0; i < data.messages.length; i++) {
                var message = data.messages[i];
                console.log(message.author + ': ' + message.body); //Выведем его в консоль
            }
        });
var token = '83763g87x';
        var instanceId = '777';
        var url = `https://api.chat-api.com/instance${instanceId}/message?token=${token}`;
        $.get(url, function (data) { // Выполним GET запрос на URL
            for (var i = 0; i < data.messages.length; i++) { // Для каждого сообщения
                var message = data.messages[i];
                console.log(message.author + ': ' + message.body); //Выведем его в консоль
            }
        });
# Всего лишь GET запрос
        curl "https://api.chat-api.com/instance777/messages?token=83763g87x"

Установить Webhook

Получайте уведомления о личных сообщениях через входящие http запросы на ваш сервер.

// Сначала установите webhook согласно
        // документации например на http://ваш.сайт/incoming_message.php

        // Декодируем пришедший по webhook JSON
        $data = json_decode(file_get_contents('php://input'), true);
        foreach($data['messages'] as $message){ // Распечатаем каждое сообщение
            // Здесь уже обработайте каждое сообщение:
            // Добавьте в базу данных или сразу ответьте
        }
// Сначала установите webhook согласно
        // документации например на http://ваш.сайт/incoming_message.php

        // Подключим Express JS и Body Parser для того чтобы принять JSON POST
        var app = require('express')();
        var bodyParser = require('body-parser');
        app.use(bodyParser.json());

        // Теперь напишем обработик для
        app.post('/got_messages', function (req, res) {
            var data = req.body; // Получили новые сообщения в body
            for (var i = 0; i < data.messages.length; i++) { // Для каждого сообщения
                var message = data.messages[i];
                console.log(message.author + ': ' + message.body); //Выведем его в консоль
            }
            res.send('Ok'); //Ответим хоть что-нибудь, лишь бы код 200 был
        });

        app.listen(80);

Управление профилем аккаунта

Вы можете просматривать и редактировать свой профиль messengers. Однако если вы хотите изменить отображаемое имя аккаунта, существует несколько правил.

$data = [
    'address' => '79995253422', // Телефон получателя
    'description' => 'Best Company', // Сообщение
    'email' => '', // mail Организации
    'vertical' => '' // Отрасль
];
$json = json_encode($data); // Закодируем данные в JSON
// URL для запроса POST /message
$token = '83763g87x';
$instanceId = '777';
$url = 'https://api.chat-api.com/instance'.$instanceId.'/me?token='.$token;
// Сформируем контекст обычного POST-запроса
$options = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => 'Content-type: application/json',
    'content' => $json
]
]);
// Отправим запрос
$result = file_get_contents($url, false, $options);

FAQ

Что такое messengers Business API (MESAPI)?

Для связи вашего бизнеса с клиентами в messengers вам необходим API шлюз или интерфейс, который будет посредником между вашим решением (CRM-система, чат бот, чат платформа или что-то другое) и пользователями мессенджера. Таким интерфейсом и является официальное решение от Comp - messengers Business API.
Узнать больше об официальном messengers Business API от Chat API можно в этой статье.

Преимущества messengers Business API

- Свободная рассылка сообщений. Без риска бана, без необходимости держать включенным телефон;
- Быстрое подключение. Не нужно верифицировать бизнес, приступить к работе с номером почти сразу;
- До 100 000 сообщений в сутки с одного номера;
- 1000 бесплатных диалогов в месяц;
- Интерактивные кнопки в сообщениях для быстрого включения клиента;
- Зеленая галочка и имя компании в профиле messengers после согласования с Comp;

Chat API предоставляет официальный messengers Business API?

Мы успешно помогаем налаживать общение с клиентами в messengers с 2015 года, предоставляя доступ к функциональному API, чат ботам, чат платформам.
Начиная с 2020 года мы стали подключать пользователей к messengers Business API через официального партнера Comp messengers API 360Dialog. Наше решение одно из самых доступных и функциональных в работе. Попробуйте и оцените сами.

Как подключиться?
Chat API подключает к messengers Business API через официального провайдера Comp. Подключение происходит моментально с помощью нового подхода к регистрации с отложенной верификацией.

После регистрации вы сразу же можете начать тестировать работу номера и настраивать интеграцию, а верификация компании, утверждение отображаемого имени и согласование с политикой Comp проходит параллельно активному доступу к API.

Порядок подключения:

Подробная инструкция по подключению номера представлена в статье “Моментальное подключение номера messengers Business API”. Ниже представлен общий порядок и подход к регистрации MESAPI номера.

- Создайте новый MESAPI проект в личном кабинете Chat API;
- Заполните форму регистрации;
- Привяжите карту и оформите подписку;
- Сгенерируйте API KEY. Укажите API KEY в Вашем личном кабинете Chat API;
- На этом этапе вы уже сможете работать с номером, отправлять и получать сообщения, но с небольшими ограничениями. Чтобы расширить возможности номера нужно верифицировать свой бизнес. Подробно о верификации в этой статье.
- Наслаждайтесь работой официального messengers Business API.

Сколько времени занимает подключение?

С помощью нового подхода в регистрации (через регистрацию с отложенной верификацией) вы получаете доступ к messengers Business API практически моментально.

Какие номера подойдут для messengers Business API?

Для работы с messengers Business API подходят любые номера, главное, чтобы они при этом:

1 - Имели возможность принимать сообщения\звонки для верификации;

2 - Не были заблокированы в messengers.

Можно использовать и стационарный номер, но для работы с ним нужна IP телефония, если у Вас установлена IVR система, то ее нужно отключить при прохождении процедуры верификации номера.

Если номер уже подключен к messengers Business API через другого провайдера API, то такой номер также можно перенести в Chat API с помощью процедуры эмиграции номера.

Узнать больше об особенностях выбора номера для messengers Business API можно в этой статье.

Важно! Номер, подключенный к messengers Business API, не может функционировать в приложениях messengers. Перед началом подключения номера, ваш аккаунт в messengers нужно удалить. Подробнее в статье "Можно ли сохранить номер messengers или messengers Business App при переходе на messengers Business API?"

Может ли физическое лицо получить messengers Business API?

Comp Business Manager - это инструмент для работы с бизнесом, поэтому, чтобы получить FBID (необходимый параметр для подключения MESAPI), нужно иметь юр.лицо или статус индивидуального предпринимателя.

Как получить зеленую галочку в messengers?

Предоставление зеленой галочки и статуса “Официального бизнес партнера” определяет сам Comp и выставляет следующие критерии:

- Верификация в Comp Business Manager;
- Доступ к messengers Business API и соответствие политикам Comp;
- Двухфакторная аутентификация в Comp Business Manager;
- Второй и выше уровень доверия к номеру MESAPI;
- Известный и узнаваемый бренд.

Советы, инструкции и подводные камни детально описали в этой статье. Мы бесплатно помогаем получить зеленую галочку всем нашим клиентам.

Сколько стоит подключение messengers Business API?

Стоимость работы с номером MESAPI подразделяется на два сегмента:

1 - ежемесячная оплата хостинга номера - 3900 рублей в месяц или 3250 рублей, если подписка оформляется на год.

2 - плата за открытые диалоги с клиентом, подробнее об этом в статье Диалоговая модель учета сообщений messengers Business API. Краткий обзор.

Каждый месяц вы начинаете с 1000 бесплатными диалогами.

Подробнее о формировании цены и порядке оплаты мы писали в этой статье.

Отмена подписки. Правило резервного месяца.

Обратите внимание на, возможно не самое справедливое, но обязательное правило взаиморасчетов, которое декларирует провайдер API. Для простоты мы назвали это правило «Резервного месяца».

В случае, если Вы решите отказаться от messengers Business API и удалите номер, то порядок расчетов будет следующим:
- Во-первых, денежные средства за месяц, в котором был удален номер, будут списаны в полном объёме, даже если Вы удаляете номер в первых числах месяца.
- Во-вторых, за месяц, следующим после месяца, в котором был удален номер, также будут списаны деньги, как за полностью рабочий messengers Business API период.

Мы тоже считаем, что это не совсем честно, сейчас эта процедура обсуждается и ,мы надеемся, в скором времени может быть изменена, мы обязательно об этом уведомим.

Если Вы отменяете подписку или на карте оказывается недостаточно средств, то номер блокируется до выяснения обстоятельств.

Шаблоны сообщений

Это одобряемые Comp форма и содержание сообщений, которые используются для открытия диалога с клиентом. Подробнее об этом в этой статье

Диалоговое окно в 24 часа

Это временный отрезок, который начинается с момента инициации общения и заканчивается по истечению 24-х часов после первого доставленного клиентского сообщения в диалоге. Все сообщения внутри 24-х часового окна бесплатны и свободны от использования шаблонов.

messengers Business App и messengers Business API

Эти понятия часто путают. messengers Business App – это приложение для бизнеса, которое обладает расширенным функционалом по работе с самим приложением messengers. messengers Business API – это интерфейс или шлюз, который позволит Вам автоматизировать и оптимизировать общение с пользователями с помощью ботов или операторов, подключенных к messengers через CRM системы или иные платформы.

Display name

Это отображаемое в messengers имя пользователя или компании. Подробнее об этом в этой статье.

Регистрация с отложенной верификацией

Новый подход к регистрации клиентов в MESAPI. Характерен тем, что Вы сразу получаете активный номер. Подробнее об этом в этой статье.

image

Что говорят наши клиенты

Доверие тысячи разработчиков

Ribhu

Omni-channel for hotels

Хороший интерфейс и автономия. Я могу создать аккаунт сам с нуля, заплатить с карты и начать работать с messengers. Не нужно никому писать по электронной почте, и все шаги автоматизированы. Это круто!

Мария

Агенство недвижимости

Во-первых, нам понравилась отзывчивость с которой к нам отнеслись - нам очень помогли в интеграции Chat API с CRM. Во-вторых, это многофункциональность сервиса, которая понравилась нашим программистам. Мы продолжаем работать с Chat API и рады нашему совместному росту

João Ignácio

Software Architect and Development Manager

Я считаю, что сервис отличный, всегда работает, а служба поддержки на связи всякий раз, когда нам это нужно. Что очень хорошо, так это то, что некоторые из моих запросов, касающихся проблем и улучшений, были приняты во внимание и реализованы там, где это возможно.

Alejandro

CEO

При выборе API я в первую очередь ориентируюсь на стабильность и гибкость - эти качества очень важны для меня. Мой выбор был сделан в пользу Chat API. Я работаю уже почти год, все мне подходит. И мне нравится, что ваш API очень легко использовать, создавать ботов и прочее.

Дмитрий

Бухгалтерская служба, разработчик

Большинство сервисов не предоставляли той гибкости, которая нам была необходима при оптимизации общения с нашими клиентами. Chat API - решение, которое нам больше всего подошло. Просто, удобно, доступно. Также мне нравится дружелюбная служба поддержки и что она отвечает достаточно быстро. Крепкий и хороший продукт.

Цена и подключение

2900 рублей в месяц за подключенный messengers Business API номер.
От 5-ти номеров цена станет ниже. При подключении большего количества номеров могут быть согласованы индивидуальные условия.
В стоимость входит техническая поддержка, первые тысячу диалогов в месяц и все возможности официального API.

Подключи официальный messengers Business API