Salebot.pro
Search…
API конструктора
Какие запросы поддерживает конструктор и как их выполнять.
Запросы выполняются методом POST на URL, типа: https://chatter.salebot.pro/api/{api_key}/{action} Где: api_key ключ доступа к API, который получается в настройках проекта (Рисунок 1)
Рисунок 1
Получить ключ доступа можно с использованием переменной #{api_key}. В ней хранится актуальный сгенерированный ключ доступа. Не забудьте перед использовнаием сгенерировать токен.
При копировании url запроса с этой страницы подставляется пробел, который необходимо при вызове удалить.
Пример неправильно скопированной ссылки:
https://chatter.salebot.pro /api/callback
Пробел после .pro не так просто заметить. С ним запрос не будет выполняться
При отправке запроса методом GET не используйте запрещенные символы. Изучите правильное формирование GET запросов.
post
https://chatter.salebot.pro
/api/<api_key>/callback
Запуск бота
post
https://chatter.salebot.pro
/api/<api_key>/vk_callback
Запуск бота по идентификатору пользователя ВКонтакте
post
https://chatter.salebot.pro
/api/<api_key>/whatsapp_callback
Запуск бота по номеру Whatsapp
post
https://chatter.salebot.pro
/api/<api_key>/ok_callback
Запуск бота по идентификатору пользователя Одноклассников
post
https://chatter.salebot.pro
/api/<api_key>/tg_callback
Запуск бота по идентификатору Telegram
post
https://chatter.salebot.pro
/api/<api_key>/message
Отправка сообщения клиенту
post
https://chatter.salebot.pro
/api/<api_key>/assign_to_user'
Определение клиента сотруднику
post
https://chatter.salebot.pro
/api/<api_key>/broadcast
Массовая отправка сообщений
Универсальный webhook
Перечисленные методы теперь могут быть запущены как POST, так и GET запросом.
callback
vk_callback
ok_callback
whatsapp_callback
message
whatsapp_message
Раньше в наших методах были жестко прописаны параметры, по которым запускались выполнения методов для подписчиков (например client_id и vk_id) и это накладывало некоторые ограничения для использования их со сторонними сервисами.
Теперь вы можете указать, в каком параметре запроса сэйлбот будет искать идентификатор пользователя: для этого используется параметр с префиксом value_, например value_user_id и value_group_id.
А еще метод отправки колбека callback, теперь можно запустить передав электронный адрес (client_email) или телефон (client_phone) клиента.
Методы allback, vk_callback, ok_callback и whatsapp_callback не привязаны к именам параметра. Вы можете указать, в каком параметре будет находиться номер телефона, email или id-клиента.
Это удобно, когда вы настраиваете прием вебхука с какого-то сайта.
Чтобы указать, в какой переменной лежит client_id, необходимо передать параметр value_client_id, в котором указать название параметра с этим значением.
Чтобы указать, в какой переменной лежит phone, необходимо передать параметр value_phone, в котором указать название параметра с этим значением.
Чтобы указать, в какой переменной лежит email, необходимо передать параметр value_email, в котором указать название параметра с этим значением.
Чтобы указать, в какой переменной лежит user_id, необходимо передать параметр value_user_id, в котором указать название параметра с этим значением.
Чтобы указать, в какой переменной лежит group_id, необходимо передать параметр value_group_id, в котором указать название параметра с этим значением.
Как можно заметить, название параметра, в котором лежит имя, отличается припиской value_
Параметры отправки сообщения
attachment_type может принимать значения: image, video, link, file, audio
При отправке вложения параметр message необязателен
buttons - определяет кнопки, которые будут прикреплены к сообщению. Формат кнопок аналогичен расширенным настройкам кнопок. Возможны два варианта передачи кнопок: с указанием подсказки для мессенджеров без кнопок и без нее.
Пример параметра buttons:
1
"buttons": {"hint": "Этот текст будет отображен в вотсапе",
2
"buttons": [
3
{"type": "reply",
4
"text": "Расскажи об услугах",
5
"line": 0, "index_in_line": 0},
6
7
{"type": "reply",
8
"text": "Стоимость услуг",
9
"line": 0,
10
"index_in_line": 1},
11
12
{"type": "reply",
13
"text": "Контакты",
14
"line": 1, "index_in_line": 0},
15
16
{"type": "reply",
17
"text": "Оставить заявку",
18
"line": 1, "index_in_line": 1}
19
]
20
}
Copied!
post
https://chatter.salebot.pro
/api/<api_key>/whatsapp_message
Отправка сообщения в Whatsapp
post
https://chatter.salebot.pro
/api/<api_key>/save_variables
Присвоение переменных
get
https://chatter.salebot.pro
/api/<api_key>/get_variables?client_id=
Получение переменных
get
https://chatter.salebot.pro
/api/<api_key>/get_clients
Получение списка клиентов
get
https://chatter.salebot.pro
/api/<api_key>/get_history?client_id=
Получение истории сообщений
get
https://chatter.salebot.pro
/api/<api_key>/clear_history?client_id=
Очистить историю сообщений
get
https://chatter.salebot.pro
/api/<api_key>/connected_channels
Получить список подключенных мессенджеров к проекту
get
https://chatter.salebot.pro
/api/<api_key>/online_chat_client_id?recipient=
Получить id клиента из Онлайн-чата
Где взять recipient? На сайте, где размещен онлайн чат "Salebot.pro" при помощи JS получите свойство SaleBotPro.recipient_id
post
https://chatter.salebot.pro
/api/<api_key>/load_clients
Загрузка клиентов в систему
platform_id - номер телефона
group_id можно получить методом Получить id клиента для работы с API на сайте
client_type - тип мессенджера, откуда пришел клиент. Принимает значения:
Переменные
Salebot.pro
get
https://chatter.salebot.pro
/api/<api_key>/whatsapp_client_id?phone=
Получение client_id по номеру Whatsapp
get
https://chatter.salebot.pro
/api/<api_key>/find_client_id_by_phone?phone=
Получение client_id по номеру телефона
get
https://chatter.salebot.pro
/api/<api_key>/find_client_id_by_email?email=
Получение client_id по email
get
https://chatter.salebot.pro
/api/<api_key>/find_client_id_by_var?var=&val=
Получение client_id по значению переменной
post
https://chatter.salebot.pro
/api/<api_key>/find_client_id_by_platform_id
Получение client_id поз начению platform_id
Пример параметров: {"platform_ids": ["571830542", "256865200"]}
Получение сообщений на Webhook URL, указанный в настройках проекта
Каждое входящее или исходящее сообщение будет приходить следующий json POST запросом:
1
{
2
'id': идентификатор сообщения в системе,
3
'client': {
4
'id': идентификатор клиента в системе,
5
'recepient': идентификатор клиента в мессенджере,
6
'client_type': тип мессенджера,
7
'name': имя клиента,
8
'avatar': аватар клиента,
9
'created_at': дата создания клиента,
10
'tag': ключ подписки,
11
'group': бот, к которому привязан клиент,
12
},
13
'message': текст сообщения,
14
'attachments': массив ссылок на файлы
15
'message_id': id блока, из которого было отправлено сообщение
16
'project_id': идентификатор проекта,
17
'is_input': 1 если сообщение от клиента, 0 если оно от бота,
18
'delivered': 1 если сообщение успешно отправлено, 0 если произошла ошибка отправки,
19
'error_message': текст ошибки отправки сообщения
20
}
Copied!
Если запрос вернул ошибку, повторной отправки не будет. Если сервер возвращает ошибки, уведомления продолжат отправляться несмотря на это.
get
https://chatter.salebot.pro
/api/<api_key>/vk_subscribers
Получение списка подписчиков на бота Вконтакте
get
https://chatter.salebot.pro
/api/<api_key>/check_insta_subscription
Проверка, подписан ли человек на аккаунт в Instagram
get
https://chatter.salebot.pro
/api/<api_key>/check_whatsapp
Проверка, есть ли Whatsapp на номере телефона
get
https://chatter.salebot.pro
/api/<api_key>/get_messages
Получение списка блоков из схемы бота
post
https://chatter.salebot.pro
/api/<api_key>/add_to_list
Добавить клиентов в список
post
https://chatter.salebot.pro
/api/<api_key>/remove_from_list
Удалить клиентов из списка
Если Вам нужны дополнительные методы, свяжитесь со службой поддержки
post
https://chatter.salebot.pro
/api/<api_key>/set_order_state
Перенос сделки в состояние SalebotCRM
Last modified 29d ago
Copy link
Contents
post
Запуск бота
post
Запуск бота по идентификатору пользователя ВКонтакте
post
Запуск бота по номеру Whatsapp
post
Запуск бота по идентификатору пользователя Одноклассников
post
Запуск бота по идентификатору Telegram
post
Отправка сообщения клиенту
post
Определение клиента сотруднику
post
Массовая отправка сообщений
Универсальный webhook
Параметры отправки сообщения
post
Отправка сообщения в Whatsapp
post
Присвоение переменных
get
Получение переменных
get
Получение списка клиентов
get
Получение истории сообщений
get
Очистить историю сообщений
get
Получить список подключенных мессенджеров к проекту
get
Получить id клиента из Онлайн-чата
post
Загрузка клиентов в систему
get
Получение client_id по номеру Whatsapp
get
Получение client_id по номеру телефона
get
Получение client_id по email
get
Получение client_id по значению переменной
post
Получение client_id поз начению platform_id
Получение сообщений на Webhook URL, указанный в настройках проекта
get
Получение списка подписчиков на бота Вконтакте
get
Проверка, подписан ли человек на аккаунт в Instagram
get
Проверка, есть ли Whatsapp на номере телефона
get
Получение списка блоков из схемы бота
post
Добавить клиентов в список
post
Удалить клиентов из списка
post
Перенос сделки в состояние SalebotCRM