База Знаний CleverApp
  • Главная
  • Обзор платформы
    • Краткий обзор платформы CleverApp и создание первого бота
    • Автоподстановка переменных в текст бота
    • Валидация — проверка введенных данных
    • Основная информация контакта
    • Политика обработки персональных данных в боте
    • Работа с датами и временем
    • Арифметические операции в боте
    • Доступ к боту и проекту | Права и роли
    • Пополнение и списание баланса с внутреннего счета контакта
    • Массовое удаление контактов
    • Как удалить аккаунт с платформы CleverApp
  • Часто задаваемые вопросы
  • Тарифы и оплата
  • Партнерская программа платформы CleverApp
  • Создание чат-ботов (блоки платформы CleverApp)
    • Простые блоки
      • Блоки “Простое сообщение” и “Цепочка сообщений”
      • Блок “Назначить тег”
      • Блок “Удалить тег”
      • Блок “Заявка”
      • Блок “Сценарий”
      • Блок “Условие”
      • Блок “Переключатель”
      • Блоки “Этап сделки” и “Ответственный за сделку”
      • Блоки “Запрос номера телефона” и “Запрос Email”
      • Блок “Таймер”
      • Блок “Задержка”
      • Блок “Удалить переменную”
      • Блок “Старт”
    • Уведомления
      • Блок "Заявка"
      • Блок "Уведомление для контакта"
      • Блок "Отправить сообщение"
      • Блок "Отправить быстрое сообщение"
      • Блок "Письмо на Email"
    • Списки и таблицы
      • Блок “Чтение записей из списка”
      • Блок “Чтение записи из списка”
      • Блок “Добавление записи в список”
      • Блок “Проверка существования записи в списке”
      • Блок “Бронирование записи из списка”
      • Блок “Чтение строк из таблицы”
    • Платежи
    • Магазин
      • Блок "Чтение записей из списка"
      • Блок "Чтение записи из списка"
      • Блок “Корзина”
      • Блок “Список заказов”
    • Рассылка
    • Голосования
      • Блок “Регистрация участника голосования”
      • Блок “Голосование за участника”
      • Блок “Лидеры голосования”
    • Интеграции
      • Блок "Заказ на GetCourse"
      • Блок “Запись в Google Таблицу”
      • Блок “Проверка существования записи в Google Таблице”
      • Блок “Чтение списка из Клиентской Базы”
      • Блок “Чтение записи из Клиентской Базы”
      • Блок “Отправить контакт в группу JustClick”
      • Блок “Отправить контакт в группу Flowell”
      • Блок “HTTP запрос”
      • Блок “Исходящий Webhook”
    • Специальные
      • Блок “Назначить тег”
      • Блок “Удалить тег”
      • Блок “Сценарий”
      • Блок “Условие”
      • Блок “Переключатель”
      • Блок “Бронирование записи из списка”
      • Блоки “Запрос номера телефона” и “Запрос Email”
      • Блок "Письмо на Email"
      • Блок "Операция над переменной"
      • Блок “Удалить переменную”
      • Блок "A/B-тестирование"
      • Блок “Старт”
      • Блок "Удалить пользователя из бота"
      • Блок “Встроенный бот Телеграм”
      • Блок "Входящий Webhook"
      • Блок “HTTP запрос”
      • Блок “Интерпретатор JavaScript”
      • Блок “Исходящий Webhook”
      • Блок "Распределение по группам"
    • Enterprise блоки
    • Меню слева
      • Сценарий
      • Сообщения
      • Каналы
      • Авторассылки
      • Настройки
      • CRM
      • Списки
      • Бронирование
      • Статистика
  • Кнопки меню со встроенными ссылками
  • Меню в боте Telegram
  • Мессенджеры и соц. сети
    • Telegram
      • Создаем чат-бот и подключаем к каналу Telegram
      • Настройки в BotFather
      • Прямые ссылки на дополнительные сценарии в Телеграм
      • Инлайн-кнопки меню со встроенными ссылками
      • Инлайн-кнопки меню со встроенными ссылками на Web App приложение
      • Как передать права на Telegram-бота в @BotFather?
      • Подмена предыдущего сообщения в чате Telegram-бота
      • Business-аккаунт Telegram
      • Администрация канала или группы
    • Viber
      • Создаем чат-бот и подключаем к каналу Viber
      • Инлайн-кнопки меню со встроенными ссылками
    • WhatsApp
      • Создаем чат-бот и подключаем к каналу Whatsapp
      • Меню для WhatsApp
    • ВКонтакте
      • Создаем чат-бот и подключаем к каналу ВКонтакте
      • Инлайн-кнопки меню со встроенными ссылками
    • ТамТам
      • Создаем чат-бот и подключаем к каналу ТамТам
  • Авторассылки
    • Создание авторассылки
    • Гибкие фильтры авторассылок в CleverApp
    • Отложенная отправка сообщений
  • Магазин в Telegram
    • Импорт товаров в списки
    • Блоки “Чтение записей/записи из списка”
    • Постоплата и адрес доставки в корзине
    • Блок “Встроенный бот Телеграм” – Создание меню для магазина в Telegram
  • Аналитика
    • Встроенная CRM
    • UTM-метки
    • Статистика заявок и посетителей
    • Конверсии связей в сценариях
  • Интеграции
    • CRMCA
    • Клиентская база
    • amoCRM
    • Битрикс24
    • Платежные системы
      • Прием платежей и интеграция с ЮKassa
      • Прием платежей на ЮMoney
      • Прием платежей и интеграция с Robokassa
      • Прием платежей и интеграция с Cloudpayments
      • Прием платежей и интеграция c Prodamus
      • Прием платежей и интеграция с bePaid
      • Прием платежей и интеграция с LiqPay
      • Прием платежей и интеграция с JustClick
      • Прием платежей и интеграция с Flowell
      • Прием платежей и интеграция c Crypto Pay
    • Google Таблицы
    • SMS провайдеры
      • Интеграция с SMS.RU
      • Интеграция с SMS.to
      • Интеграция с SMSala
    • ERESH
    • GetCourse
    • YCLIENTS
    • Make
    • Integromat
    • Postback (постбек)
    • Интеграция CleverApp и ChatGPT
  • Конструктор Мини-лендингов
  • Форма "Захват телефона"
  • Конструктор Виджетов
  • Создание реферальной системы в Telegram
  • Создание бота с ChatGPT
  • JavaScript решения
  • Для разработчиков
    • Документация и работа с API
      • Основы
      • Аккаунт
      • Контакты
        • Счета
        • Счета в криптовалюте
        • Реферальная система
        • Теги
        • Пользовательские переменные
      • Списки
        • Элементы списка
      • Сообщения
      • Рассылка
      • Примеры реализации API интеграций
    • JavaScript API
      • Основы
      • Переменные
      • Функции
        • Пользовательские переменные
          • getContactVariable()
          • setContactVariable()
          • deleteContactVariable()
        • Теги
          • hasContactTag()
          • setContactTag()
          • deleteContactTag()
        • Глобальные переменные
          • getGlobalVariable()
          • setGlobalVariable()
          • deleteGlobalVariable()
        • Общие функции
          • sendMessage()
          • goToBlock()
          • disableContinue()
          • setContactById()
          • setContactByTelegramId()
          • setContactByViberId()
          • setContactByVkId()
          • setContactByWhatsAppPhone()
      • Блок "Входящий Webhook"
      • Блок "HTTP-запрос"
      • Блок "Интерпретатор JavaScript"
  • Полезное
    • Самозанятые
      • Как стать самозанятым?! Инструкция
    • Лайфхаки
      • Для Telegram
        • Гиперссылка в тексте бота
        • Скрытый текст в боте
  • Личный кабинет
  • Обновления платформы
  • Написать в поддержку
Powered by GitBook
On this page
  • Отправить сообщение
  • Отправить сообщение по внешнему ID
  • Отправить сообщение WhatsApp
  1. Для разработчиков
  2. Документация и работа с API

Сообщения

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

POST https://app.cleverapp.pro/api/v1/sendMessage

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

Query Parameters

Name
Type
Description

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

Name
Type
Description

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 может принимать следующие значения:

  • whatsapp

  • telegram

  • viber

  • icq

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

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

Лимиты

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

Мессенджер

Количество сообщений за 10 сек.

WhatsApp

1

Telegram

10

Viber

10

ICQ

10

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

POST

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

Request Body

Name
Type
Description

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-го сообщения в секунду.

PreviousЭлементы спискаNextРассылка

Last updated 2 years ago