Сообщения
Отправить сообщение
POST https://app.cleverapp.pro/api/v1/sendMessage
Этот метод позволяет отправить сообщение по ID контакта.
Query Parameters
file
string
URL на файл.
image
string
URL на картинку.
contact_id*
integer
ID контакта.
text
string
Сообщение.
{
"success": true
}{
"message": "Forbidden"
}{
"message": "The given data was invalid.",
"errors": {
"contact_id": [
"Поле contact id обязательно для заполнения, когда messenger \/ bot id \/ contact external id не указано."
],
"text": [
"Поле text обязательно для заполнения, когда ни одно из image \/ file не указано."
],
"image": [
"Поле image обязательно для заполнения, когда ни одно из text \/ file не указано."
],
"file": [
"Поле file обязательно для заполнения, когда ни одно из text \/ image не указано."
],
"messenger": [
"Поле messenger обязательно для заполнения, когда contact id не указано."
],
"bot_id": [
"Поле bot id обязательно для заполнения, когда contact id не указано."
],
"contact_external_id": [
"Поле contact external id обязательно для заполнения, когда contact id не указано."
]
}
}{
"error": "Достигнут лимит отправки сообщений для whatsapp"
}{
"error": "На данный момент не реализована отправка сообщений в мессенджер контакта (icq)"
}Отправить сообщение по внешнему ID
POST https://app.cleverapp.pro/api/v1/sendMessage
Этот метод позволяет отправить сообщение по номеру телефона или по внешнему ID контакта в мессенджере или социальной сети.
Query Parameters
file
string
URL на файл.
image
string
URL на картинку.
bot_id*
integer
ID бота контакта
contact_external_id*
string
Номер телефона или внешний id контакта в мессенджере.
messenger*
string
ID мессенджера.
text
string
Сообщение.
{
"success": true
}{
"message": "Forbidden"
}{
"message": "The given data was invalid.",
"errors": {
"contact_id": [
"Поле contact id обязательно для заполнения, когда messenger \/ bot id \/ contact external id не указано."
],
"text": [
"Поле text обязательно для заполнения, когда ни одно из image \/ file не указано."
],
"image": [
"Поле image обязательно для заполнения, когда ни одно из text \/ file не указано."
],
"file": [
"Поле file обязательно для заполнения, когда ни одно из text \/ image не указано."
],
"messenger": [
"Поле messenger обязательно для заполнения, когда contact id не указано."
],
"bot_id": [
"Поле bot id обязательно для заполнения, когда contact id не указано."
],
"contact_external_id": [
"Поле contact external id обязательно для заполнения, когда contact id не указано."
]
}
}{
"error": "Достигнут лимит отправки сообщений для whatsapp"
}Поле messenger может принимать следующие значения:
whatsapptelegramvibericq
В поле contact_external_id можно передавать номер телефона не только для мессенджера WhatsApp но и для других, если к контакту привязан номер. Привязка номера может произойти при первом платеже вашего клиента.Ваш contact_external_idдолжен быть в контактах у бота, для этого напишите боту с нужного мессенджера. Отправка на произвольный номер возможна только через мессенджер WhatsApp через метод sendMessageToWhatsApp (см. ниже).
Ваш contact_external_idдолжен быть в контактах у бота, для этого напишите боту с нужного мессенджера. Отправка на произвольный номер возможна только через мессенджер WhatsApp через метод sendMessageToWhatsApp (см. ниже).
Лимиты
Для отправки сообщений установлены следующие ограничения:
Мессенджер
Количество сообщений за 10 сек.
1
Telegram
10
Viber
10
ICQ
10
Отправить сообщение WhatsApp
POST
Этот метод позволяет отправить сообщение на WhatsApp по номеру телефона.
Request Body
bot_id
integer
ID бота контакта.
phone string
string
Номер телефона
text
string
Сообщение
name
string
Имя контакта, необходимо отправлять когда вы пишите данному контакту в первый раз
{
"data": {
"id": 1,
"phone": "79991234567",
"name": "Иван Иванов",
"messenger": "whatsapp",
"created_at": "2019-05-10T10:38:28+00:00"
}
}Ограничение: не больше 1-го сообщения в секунду.
Last updated