Changelog

[Будущие изменения]

Партнёрка

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

  2. Будут переработаны уведомления (будет удобнее подписываться на уведомления по своим клиентам).

  3. Будут переработаны реквизиты партнёра (будет можно работать с реквизитами, не подключая себе подписки, партнёрские реквизиты будут отделены от клиентских).

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": ""
  }
}

Last updated