Changelog

2025-04-03

Сотрудники

1. Добавлена новая системная роль Партнёр (system_type=PARTNER). Права такие же, как у администратора, но без доступа к партнёрке. Эту роль имеют сотрудники партнёра, которым выдан доступ в клиентские компании.

2. Добавлены права для партнёрки "Создание клиента (partners_create_clients)", "Доступ к ЛК клиента (partners_access_client_companies)".

Партнёрка

1. Партнёры могут самостоятельно регистрировать клиентов (POST /partners/clients/).

2. Добавлены начисления за оплату подписок реферальных клиентов (GET /partners/finance/rewards/). reward_type=SUBSCRIPTIONS_REWARD.

2025-03-26

Партнёрка

1. В списке компаний (GET /partner_companies/) добавлены сортировки по id и названию клиента. Добавлены фильтры по статусам оплаты, типам подписки.

Общее

1. Введено ограничение на количество запросов на получение списка контактов и чатов (1 запрос в секунду). Используйте вебхуки для получения чатов и сообщений в них в реальном времени и сохраняйте id чатов для последующей отправки сообщений.

2025-03-13

Сообщения

1. Добавлен новый тип ошибки у сообщений: error_type=WABA_DIALOGS_LIMIT_EXCEEDED. Возникает при попытке отправить сообщения в канал WABA, если нет оплаченных диалогов.

Партнёрка

1. В счетах, выставляемых партнёром, добавлено поле client_amount — сумма, которую должен заплатить клиент партнёру без вычета партнёрской скидки.

2025-03-01

Партнёрка

1. Клиенты разделены на реферальных и партнёрских. У компаний добавлено поле partner_company_type=partner/referral.

2. Реферальные клиенты платят за себя сами. За партнёрских клиентов оплаты принимает партнёр. Подробнее в условиях партнёрской программы.

3. Метод получения профиля партнёра (GET /info) переименован в GET /profile/.

Общее

1. Раньше при отправке запросов на несуществующие адреса API отдавал статус 200 с телом {"status":"ok"}. Теперь отдаёт статус 404 с телом {"error_code":404,"error_name":"NOT_FOUND","message":"not found","detail":{}}.

2025-02-25

Рассылки

1. Исправлен фильтр тегов по условию "Не совпадает". В некоторых случаях он мог отфильтровывать больше записей, чем нужно.

2025-02-21

Подключения

1. Добавлена информация о подписках в список подключений (поле subscription)

2025-02-04

Сообщения

1. Исправлен тип сообщения у голосовых сообщений WhatsApp при отправке через API или личный кабинет. Было: AUDIO, стало: VOICE.

2025-02-01

Подписки

1. Добавлены тарифные планы у подписок (поле subscription_plan). Сейчас есть 4 тарифа: Бесплатный (FREE), Начальный (START), Стандартный (STANDARD), Продвинутый (ADVANCED).

2. Бесплатными стали подписки: Telegram Bot, Одноклассники, Эквайринги

3. У WABA только один тариф: Стандартный

4. У Telegram и WhatsApp по 3 тарифа: Начальный, Стандартный, Продвинутый

5. Сроки подписок больше не пересчитываются, если в них добавляются или убираются подключения.

6. Подписки больше нельзя поставить на паузу.

7. У подписок добавлено поле max_size - на сколько подключений оплачена подписка.

Подключения

1. То, сколько подключений можно создать в одном аккаунте, теперь зависит от количества оплаченных подключений. Раньше, чтобы создать подключение сверх лимита, нужно было обращаться в ТП, теперь нужно оплатить расширение подписки.

2. На тарифе "Начальный" можно создать только одно подключение.

3. После создания, подключение автоматически добавляется в подписку. Раньше нужно было делать это вручную.

Счета

1. Добавлен новый статус для счетов: CONFIRMED_WITH_ERRORS. Такой статус может быть, если автоматически применить оплату по счёту не получилось, и он отправлен на ручную обработку.

Сообщения

1. Добавлено поле subscription.subscription_planу списка источников чатов.

WhatsApp, Telegram

1. Введены ограничения в соответствии с тарифами.

2025-01-17

Банки

1. Добавлена поддержка НДС 5%, 7%, 5/105, 7/107.

2024-12-03

Вебхуки

1. Повторная отправка вебхуков теперь происходит раз в 1, 3, 10, 30, 60 минут, а не раз в минуту.

2024-12-02

Подписки

1. Добавлена информация по работе с подписками, счетами и реквизитами.

2024-11-07

Чаты

1. При создании чата в WABA/WhatsApp убрана проверка наличия аккаунта на номере. Больше не будут отдаваться ошибки 15001: MESSAGING_UNABLE_TO_VALIDATE_PHONE & 15003: MESSAGING_PHONE_NO_WHATSAPP. Теперь чат можно создать и отправить в него сообщение, даже если на номере нет аккаунта. Проверка в последнее время работала нестабильно и мешала создавать чаты.

2024-10-31

WABA 🎃

1. Добавлена возможность заполнить профиль и настроить стартовые сообщения. Подробнее.

2024-10-29

Партнёрка

1. К реквизитам добавлены поля: КПП, БИК, номер расчётного счёта, тип организации (ИП/ООО): kpp, bic, current_account, type

2. Добавлен партнёрский баланс

3. Добавлена возможность вывода партнёрских вознаграждений с баланса

2024-09-04

Сообщения

1. У сообщений добавлены поля error_type, error_text. Также они добавлены в вебхуки.
2. Добавлена возможность отправить сообщение с кнопками для Telegram Bot (поле markup в запросе на отправку сообщения).

2024-08-22

Подключения

1. Добавлена возможность удалять подключения. Добавлен permission=CONNECTIONS_DELETE. Автоматически это разрешение выдано администраторам аккаутов.

Сообщения

1. Добавлена возможность отправлять шаблоны с переменными в кнопках для WABA (см. поле button_params).

Партнёрка

1. Переработаны уведомления. Теперь можно просмотреть все свои каналы уведомлений, и выбрать, от каких клиентов получать уведомления.

2. Обновлены сообщения, отправляемые партнёрам. Теперь должно быть понятнее, к какому конкретно клиенту относятся уведомления.

2024-07-16

Продажи

1. Открыт API для работы с продуктами, каталогами, магазинами.

Интеграции

1. У интеграции API добавлен scope=sales для работы с продажами.

Чаты

1. Метод проверки доступности чата для WABA теперь также учитывает возможность отправки первым нешаблонного сообщения.

2024-07-04

Интеграции

1. У интеграции API удалён scope=limits. Используйте scope=connections, если вам нужно видеть лимиты создания подключений.

Партнёрка

1. В методе PATCH /partner_companies/{partner_company_id} в теле запроса переименовано поле is_locked -> payments_locked

2. Переработаны реквизиты партнёра. Теперь они отделены от клиентских реквизитов.

Подключения

1. У подключений Telegram исправлено поле params.phone. Раньше оно могло отдаваться без знака + в начале. Теперь всегда отдаётся с плюсом.

2024-06-17

Партнёрка

1. Открыт публичный доступ к партнёрскому API. В настройки интеграции с API добавлен scope=partners.

Шаблоны WABA

1. Добавлены методы /messaging/templates/waba_templates/— методы для управления WABA-шаблонами. Можно создавать новые шаблоны, отправлять их на модерацию и удалять шаблоны.

Сообщения

1. В ответе метода GET /messaging/waba_templates/ удалено поле rejected_reason.

2024-04-25

Партнёрка

1. Добавлен API партнёров: https://api.radist.online/v2/docs#/Partners
2. У компании добавлен флаг is_partner, если компания партнёрская

3. У ролей компании добавлены новые права: partners_view, partners_edit

2024-04-19

Сотрудники

1. В методе PATCH /members/{id} в ответе могли возвращаться неверные значения в полях login, email, display_name. Теперь всё возвращается верно.

2. В методе DELETE /members/{id} изменён код ответа с 200 на 204. Метод больше не возвращает тело.

2024-04-11

Подключения

1. У подключений с типом waba добавлен параметр waba_auto_templates_enabled. Если его включить (передать waba_auto_templates_enabled=true), то у подключения будет автоматически создан шаблон с пустым параметром и любые текстовые сообщения, отправленные вне 24-часового окна, будут автоматически отправлены с использованием этого шаблона.

Контакты/чаты

1. Добавлены аватарки для чатов WABA. Сейчас поддерживаются аватарки для: WhatsApp, WABA, Telegram, Telegram Bot.

2024-03-19

Ошибки

1. Когда API возвращает 429 код ответа, в теле ответа теперь валидный JSON.

2024-03-14

Сообщения

1. Добавлены групповые чаты для Telegram. Сейчас поддерживаются чаты с не более чем 1000 участников.

2024-02-14

Сообщения

1. Добавлены групповые чаты для WhatsApp.

2. В вебхуки о сообщениях добавлено поле chat с информацией о чате (в т.ч. с признаком is_group) и авторами сообщений.
3. В модели сообщений добавлено поле author с информацией об отправителе, если сообщение отправлено в групповой чат.

4. У чатов добавлен флаг is_group, показывающий, является ли чат групповым.

2024-01-25

Банки

1. Добавлена новая платёжная система - Юкасса (yookassa). Добавлены связанные с ней сущности: подписки, лимиты, терминалы.

Интеграции

1. Добавлена новая интеграция: юкасса+amoCRM.

2024-01-17

Банки

1. Изменен ответ в методе GET/banking/terminals/. Параметр subscription_id удалён. Он был помечен устаревшим в марте 2023.

Сообщения

1. Метод GET /messaging/files/ удалён. Он был помечен устаревшим в декабре 2022.

2023-12-18

Ошибки

1. Когда API возвращает 500 код ответа, в теле ответа теперь валидный JSON.

2023-12-05

Сообщения

1. Для сообщений с типом radist_order (корзина, полученная из Telegram Shop) к товарам в корзине добавлено поле image_url — ссылка на картинку.

2023-11-22

Контакты/чаты

Добавлено поле avatar_url — ссылка на аватар. Сейчас поддерживаются аватарки для: WhatsApp (не WABA), Telegram, Telegram Bot.

2023-10-12

Сообщения

1. При отправке сообщений добавлен код ошибки 15011 (MESSAGING_FILE_URL_NOT_SUPPORTED). Возвращается, если передана неверная ссылка на файл.

2023-10-09

Интеграции

1. Добавлены 2 новые интеграции: Telegram Bot + amoCRM, Telegram Bot + Bitrix24

Сообщения

1. При отправке сообщений добавлен код ошибки 15010 (MESSAGING_WABA_TEMPLATE_NOT_FOUND). Возвращается, если попытаться отправить несуществующий шаблон WABA.

2023-08-23

Товары для WhatsApp Business API

1. Добавлено сообщение с типом waba_order - корзина, отправленная в WhatsApp. Пример доступен в разделе Webhooks

Подключения

1. У подключений с типом waba добавлены поля: facebook_catalog_enabled - показывает, включены ли каталоги для номера; facebook_business_id - id бизнеса в Facebook Business Manager; waba_business_id - id waba-аккаунта в WhatsApp Manager.

2023-07-11

Чаты, оплаты, WABA-диалоги

1. Добавлена возможность пополнять баланс диалогов из кабинета Radist.Online. Клиент может выбрать, платить в 360Dialog (нужна карта нероссийского банка), либо платить в Radist.Online.

2. Ранее чаты блокировались только при истечении срока диалоговой сессии, теперь блокируются и при достижении нулевого баланса диалогов.

3. Чтобы проверить, доступна ли отправка сообщения в конкретный чат, используйте этот метод.

2023-05-17

Рассылки

1. Добавлен раздел /broadcasts/ в API. Есть возможность отправить рассылку, уазав список телефонов/юзернеймов получателей, либо отфильтровав по тегам существующие в кабинете контакты.

Ролевая модель

1. Убрана возможность удалять теги. Удалены права tags_delete.

2. Добавлены права на управление рассылками: broadcasts_create, broadcasts_view, broadcasts_edit, broadcasts_delete.

2023-04-04

Интеграции

1. Изменены параметры у интеграции waba_amocrm. Теперь можно не указывать status_id, а указать только pipeline_id. В таком случае новые сделки будут создаваться в неразобранном указанной воронки.

2023-03-30

Сообщения

1. Увеличена максимальная допустимая длина подписи (caption) у файлов: 256 -> 1024

2023-03-29

Настройки компании

1. Добавлены поля timezone, payment_currency: часовой пояс компании (в соответствии с IANA time zone database) и валюта для оплаты подписок (на данный момент только RUB).

Ролевая модель

1. Добавлены права company_settings_view, company_settings_edit: дают доступ на просмотр и редактирование раздела настроек компании в кабинете.

2023-03-16

Права интеграции API

1. Если у интеграции есть доступ к сообщениям, теперь также выдаётся доступ к шаблонам

2023-03-10

Сообщения

1. Изменен ответ в методе /messaging/chats/sources/. Параметр subscription_id помечен устаревшим и в скором времени будет удалён. Добавлены параметры subscription.id и subscription.paid_until.

Банки

1. Изменен ответ в методе /banking/terminals/. Параметр subscription_id помечен устаревшим и в скором времени будет удалён. Добавлены параметры subscription.id и subscription.paid_until.

Ролевая модель

1. Исправлена ошибка, когда при создании новой компании, у администратора могло не быть прав banks_invoice_view & banks_invoice_create.

2023-03-01

Интеграции

1. Изменены параметры у интеграций с типами whatsapp_amocrm, retie_whatsappchatapi_amocrm. Теперь можно не указывать status_id, а указать только pipeline_id. В таком случае новые сделки будут создаваться в неразобранном указанной воронки.

2023-02-28

Подключения

1. В подключениях платёжных систем (тинькофф, сбербанк, модульбанк, bePaid, PayKeeper) добавлен параметр invoice_lifetime_minutes - срок действия ссылки на оплату в минутах. Допустимые значения: от 30 минут до 43200 минут (30 дней).

2023-02-20

Telegram

1. Удалена опция force_sms при запросе кода авторизации. С 18 февраля Telegram отправляет коды только в приложение.

2023-02-15

Интеграции

1. При получении интеграции с типом api больше не возвращается API-ключ.

2. Добавлена возможность сброса api-ключа у интеграции с типом api. Для этого необходимо отправить запрос PATCH /integrations/{id}, установив поле params->reset_api_key в true.

3. Удалён scope=telegram у интеграции с типом api. Теперь scope=connections даёт также доступ на подключение Telegram.

Приём оплат

1. В paykeeper корректно передаётся имя клиента, если в запросе POST /banging/invoices/ был заполнен client_name

Ролевая модель

Изменены права

1. templates: разбиты на templates_view, templates_create, templates_edit, templates_delete

2. connections: разбиты на connections_view, connections_edit, connections_create

3. integrations: разбиты на integrations_view, integrations_create, integrations_edit, integrations_delete

4. members: разбиты на members_view, members_add, members_edit, members_delete. Наличие members_view обязательно для всех ролей.

5. tags: разбиты на tags_view, tags_create, tags_edit, tags_delete

6. notifications: разбиты на notifications_view, notifications_create, notifications_edit, notifications_delete

7. subscriptions: разбиты на subscriptions_view, subscriptions_edit

Прочее

1. members_view - является обязательным правом для всех ролей

2023-02-03

Сообщения

1. Максимальная длина параметров в теле WABA-шаблонов (waba_template->body_params) увеличена со 128 до 8192.

2023-01-25

Подключения

1. Для подключений с типом bepaid удалено поле params->erip. Оно ни на что не влияло. Включить/отключить поддержку ЕРИП можно в личном кабинете bePaid.

2022-12-27

Вебхуки

1. Допустимые статусы ответов теперь: 200, 201, 202 (был только 200)

2. Отключена повторная отправка вебхуков при получении статусов 4xx

3. Добавлено замечание об обработке тела и заголовков ответа (они игнорируются)

Прочие изменения

1. В методе /messaging/templates у шаблона с типом waba_interactive уменьшена максимальная длина текста в заголовке (header->text) со 128 символов до 60 в соответствии с ограничениями WhatsApp

2022-12-26

Подписки

1. Исправлена ошибка, из-за которой метод удаления реквизитов DELETE /subscriptions/requisites/{id} мог падать с 500 ошибкой

Сообщения

1. Добавлено поле file_url в сообщения с типом waba_template. Больше не нужно запрашивать ссылку на файл методом /messaging/files/

Пример

{
    "message_id": "043caa20-6f73-452b-9a5c-f9f92a40da44",
    "source_message_id": "gBGGeRclMZhPAgmwRQ5wU_93808",
    "chat_id": "79000000000",
    "direction": "outbound",
    "message_type": "waba_template",
    "created_at": "2022-12-23T07:46:49.336461+00:00",
    "delivered_at": "2022-12-23T07:46:51+00:00",
    "read_at": null,
    "error_at": null,
    "text": null,
    "file": null,
    "image": null,
    "audio": null,
    "video": null,
    "voice": null,
    "waba_template": {
      "text": "Добрый день. Встреча по поводу 1 перенесена на 2. Подробная информация и расписание во вложении.\nКоманда Radist.Online",
      "template_locale": "ru",
      "template_name": "test_media_document_1",
      "media_header": {
        "format": "document",
        "file_name": "document_pdf.pdf",
        "file_size": 6489,
        "file_mime_type": "application/pdf",
        "file_url": "https://example.org/f1929c3f-2291-42fb-9932-690172f98c12/document_pdf.pdf"
      },
      "buttons": []
    },
    "waba_interactive": null,
    "radist_order": null
  }

2022-12-16

Добавлены разделы и методы для работы с продажами

1. /sales/shops/, /sales/catalogs/, /sales/products/ для управления магазинами, каталогами, товарами, соответственно.

2. /files/products/images/ для загрузки картинок для товаров

3. Добавлены коды ошибок 23xxx

4. Добавлены новые права для ролей (подробнее ниже)

5. Добавлен новый тип сообщения: radist_order - корзина с товарами (пример ниже)

Ролевая модель

Начата переработка ролевой модели. Права станут более подробными, с доступами не к разделам целиком, а к определённым операциям в разделах.

Удалены права:

1. banks: давало доступ на выставление счетов

2. messaging: давало доступ на создание чатов

Добавлены права:

1. banks_invoice_view, banks_invoice_create: разбиение banks

2. messaging_chat_create: переименованное messaging

3. sales_shop_view, sales_shop_edit, sales_shop_create, sales_shop_delete: доступ к управлению магазинами

4. sales_catalog_view, sales_catalog_edit, sales_catalog_create, sales_catalog_delete: доступы к каталогам

5. sales_product_view, sales_product_edit, sales_product_create, sales_product_delete: доступы к товарам

Сообщения

1. Метод GET /messaging/files/ помечен устаревшим (deprecated). В сообщения с файлами добавлено поле url, ссылку теперь можно получать, не делая лишних запросов

2. Добавлено сообщение с типом radist_order

Пример radist_order

{
  "message_id": "20fa8a9c-daa6-4934-8171-0dc40fe5da49",
  "source_message_id": "281",
  "chat_id": "126241266",
  "direction": "inbound",
  "message_type": "radist_order",
  "created_at": "2022-12-14T10:03:40.469520+00:00",
  "delivered_at": null,
  "read_at": null,
  "error_at": null,
  "text": null,
  "file": null,
  "image": null,
  "audio": null,
  "video": null,
  "voice": null,
  "waba_template": null,
  "waba_interactive": null,
  "radist_order": {
    "currency": "RUB",
    "amount": 550,
    "items": [
      {
        "name": "Test 1",
        "price": 100,
        "quantity": 3,
        "product_id": 36,
        "sku": "test1"
      },
      {
        "name": "Test 2",
        "price": 250,
        "quantity": 1,
        "product_id": 37,
        "sku": "test1"
      }
    ],
    "comment": ""
  }
}