Выбрать курс
- Приложение для Битрикс24 "Лаборатория роботов"
- Приложение для Битрикс24 "Сквозная аналитика 2.0"
- Приложение для Битрикс24 "Уничтожитель дубликатов"
- Приложение для Битрикс24 "Межпортальные задачи"
- Приложение для Битрикс24 "Немой чат-бот"
- Приложение для Битрикс24 "Доходы и расходы CRM"
- Приложение для Битрикс24 "Продуктивный Jivosite"
264
/
330
Получить список клиентов Б24 (облако)
Активити (робот) "Получить список клиентов Б24 (облако)" предназначено для использования в роботах и может быть полезно в следующих сценариях:
- Получение списка облачных порталов клиентов из партнёрского кабинета;
- Фильтрация по адресу портала, лицензии, языку и датам;
- Отбор по датам регистрации, привлечения, активности и последней покупки;
- Работа с реферером и почтой для аналитики и рассылок;
- Постраничный просмотр больших выборок;
- Выбор одной записи из страницы по номеру строки;
- Синхронизация данных портала с CRM и учётными системами;
- Контроль подписки Market24 по клиенту облака;
- Связка с купонами и лицензиями в отчётах;
- Автоматические уведомления при появлении записи по фильтру.
Как работает активити (робот):
- Запрос к партнёрскому API (clients.cloud.list) с partner_id и partner_core;
- Параметры filter_* преобразуются в фильтр запроса (portalUrl, licenseCode, lang, диапазоны дат и др.);
- Из массива list выбирается одна запись, у которой индекс совпадает с row_rec минус 1 в логике перебора;
- Блок market24 раскладывается в list_market24_subscription и list_market24_dateTo;
- При пустом ответе math_search_results = N;
- Возвращаются параметры навигации по списку.
- Запрос к партнёрскому API (clients.cloud.list) с partner_id и partner_core;
- Параметры filter_* преобразуются в фильтр запроса (portalUrl, licenseCode, lang, диапазоны дат и др.);
- Из массива list выбирается одна запись, у которой индекс совпадает с row_rec минус 1 в логике перебора;
- Блок market24 раскладывается в list_market24_subscription и list_market24_dateTo;
- При пустом ответе math_search_results = N;
- Возвращаются параметры навигации по списку.
Описание параметров активити (робота)
| Название поля | Описание и примеры использования |
|---|---|
| Идентификатор партнера | Обязательный ID партнёра. Пример: {=Variable:PARTNER_ID}. |
| Секретный ключ партнера | Обязательный ключ partner_core. Пример: {=Variable:PARTNER_CORE}. |
| Номер записи | Номер строки в массиве list для возврата (согласуйте с индексацией ответа API). |
| Адрес портала | Необязательный filter_portalUrl — URL портала клиента. |
| Лицензия, язык | filter_licenseCode, filter_lang. |
| Срок действия, даты | filter_dateToFrom, filter_dateToTo; даты создания, привлечения, активности, продаж — пары filter_*From / filter_*To. |
| Реферер, почта | filter_referer, filter_email. |
| Номер страницы | filter_page для постраничной выборки. |
| Запускать от имени | Пользователь с достаточными правами, рекомендуется администратор. |
| Устанавливать текст статуса, текст статуса | Отображение статуса шага в истории бизнес-процесса. |
| Ожидать ответа, период ожидания | Параметры ожидания ответа приложения в роботе. |
Примеры использования активити (робота)
| Описание примера | Решение |
|---|---|
| Первая запись списка | partner_id, partner_core, row_rec = 1, без фильтров. |
| Поиск по домену портала | filter_portalUrl = «https://client.bitrix24.ru», row_rec = 1. |
| Клиенты с активностью за квартал | filter_lastActivityDateFrom и filter_lastActivityDateTo в границах квартала, filter_page = 1, row_rec = 1. |
| Фильтр по почте | filter_email = {=Variable:EMAIL}, row_rec = 1. |
| Страница каталога партнёра | filter_page = {=Variable:PAGE}, row_rec = 1 для чтения первой строки страницы. |
| Уточнение по лицензии | filter_licenseCode = {=Variable:LICENSE}, row_rec = 1. |
| Новые порталы за период | filter_openDateFrom, filter_openDateTo — диапазон регистрации. |
| Аналитика реферера | filter_referer заполнен из переменной кампании, row_rec = 1. |
| Проверка результата | После шага условие по math_search_results = Y для продолжения ветки. |
| Язык интерфейса | filter_lang = ru или en в зависимости от сегмента. |
Возвращаемые параметры данного активити (робота):
- list_id, list_portalUrl, list_lang;
- даты: list_dateTo, list_regDate, list_affDate, list_lastActivityDate, list_lastSaleDate;
- list_referer, list_coupon, list_email, list_contact;
- list_licenseId, list_licenseCode;
- list_market24_subscription, list_market24_dateTo;
- навигация: list_totalCount, list_pageCount, list_pageNumber, list_pageSize;
- math_search_results — Y или N.
- list_id, list_portalUrl, list_lang;
- даты: list_dateTo, list_regDate, list_affDate, list_lastActivityDate, list_lastSaleDate;
- list_referer, list_coupon, list_email, list_contact;
- list_licenseId, list_licenseCode;
- list_market24_subscription, list_market24_dateTo;
- навигация: list_totalCount, list_pageCount, list_pageNumber, list_pageSize;
- math_search_results — Y или N.
Важно: Уточняйте у документации партнёрского API точный смысл индексов list и номера страницы, чтобы row_rec указывал на нужную запись.