Сообщения

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

POST https://watbot.ru/api/v1/sendMessage

Этот метод позволяет отправить сообщение по ID контакта.

Query Parameters

Name	Type	Description
file	string	URL на файл.
image	string	URL на картинку.
contact_id	integer	ID контакта.
text	string	Сообщение.

200 Сообщение успешно отправлено.

{
    "success": true
}

403 Доступ запрещен.

422 Переданные данные некорректны.

429 Превышен лимит отправки сообщений.

501 Отправка для мессенджера еще контакта не реализована.

Отправить сообщение по внешнему ID

POST https://watbot.ru/api/v1/sendMessage

Этот метод позволяет отправить сообщение по номеру телефона или по внешнему ID контакта в мессенджере или социальной сети.

Query Parameters

Name	Type	Description
file	string	URL на файл.
image	string	URL на картинку.
bot_id	integer	ID бота контакта
contact_external_id	string	Номер телефона или внешний id контакта в мессенджере.
messenger	string	ID мессенджера.
text	string	Сообщение.

200 Сообщение успешно отправлено.

{
    "success": true
}

403 Доступ запрещен.

422 Переданные данные некорректны.

429 Превышен лимит отправки сообщений.

Поле messenger может принимать следующие значения:

• whatsapp

• telegram

• viber

• vk

• max

В поле contact_external_id можно передавать номер телефона не только для мессенджера WhatsApp но и для других, если к контакту привязан номер. Привязка номера может произойти при первом платеже вашего клиента или с помощью специального блока — "Запрос номера телефона".

Ваш contact_external_idдолжен быть в контактах у бота, для этого напишите боту с нужного мессенджера. Отправка на произвольный номер возможна только через мессенджер WhatsApp через метод sendMessageToWhatsApp (см. ниже).

Лимиты

Для отправки сообщений установлены следующие ограничения:

Мессенджер	Количество сообщений за 10 сек.
WhatsApp	1
Telegram	10
Viber	10
Max	10

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

POST https://watbot.ru/api/v1/sendMessageToWhatsApp

Этот метод позволяет отправить сообщение на WhatsApp по номеру телефона.

Request Body

Name	Type	Description
bot_id	integer	ID бота контакта.
phone	string	Номер телефона
text	string	Сообщение
name	string	Имя контакта, необходимо отправлять когда вы пишите данному контакту в первый раз

200

{
    "data": {
          "id": 1,
          "phone": "79991234567",
          "name": "Иван Иванов",
          "messenger": "whatsapp",
          "created_at": "2019-05-10T10:38:28+00:00"
    }
}

Ограничение: не больше 1-го сообщения в секунду.