Changelog

2024-02-14

Сообщения

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

2024-01-25

Банки

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

Интеграции

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

2024-01-17

Банки

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

Сообщения

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

2023-12-18

Ошибки

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

2023-12-05

Сообщения

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

2023-11-22

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

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

2023-10-12

Сообщения

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

2023-10-09

Интеграции

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

Сообщения

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

2023-08-23

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

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

Подключения

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

2023-07-11

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

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

2023-05-17

Рассылки

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

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

  1. 1.
    Убрана возможность удалять теги. Удалены права tags_delete.
  2. 2.
    Добавлены права на управление рассылками: broadcasts_create, broadcasts_view, broadcasts_edit, broadcasts_delete.

2023-04-04

Интеграции

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

2023-03-30

Сообщения

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

2023-03-29

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

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

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

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

2023-03-16

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

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

2023-03-10

Сообщения

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

Банки

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

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

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

2023-03-01

Интеграции

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

2023-02-28

Подключения

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

2023-02-20

Telegram

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

2023-02-15

Интеграции

  1. 1.
    При получении интеграции с типом api больше не возвращается API-ключ.
  2. 2.
    Добавлена возможность сброса api-ключа у интеграции с типом api. Для этого необходимо отправить запрос PATCH /integrations/{id}, установив поле params->reset_api_key в true.
  3. 3.
    Удалён scope=telegram у интеграции с типом api. Теперь scope=connections даёт также доступ на подключение Telegram.

Приём оплат

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

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

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

  1. 1.
    templates: разбиты на templates_view, templates_create, templates_edit, templates_delete
  2. 2.
    connections: разбиты на connections_view, connections_edit, connections_create
  3. 3.
    integrations: разбиты на integrations_view, integrations_create, integrations_edit, integrations_delete
  4. 4.
    members: разбиты на members_view, members_add, members_edit, members_delete. Наличие members_view обязательно для всех ролей.
  5. 5.
    tags: разбиты на tags_view, tags_create, tags_edit, tags_delete
  6. 6.
    notifications: разбиты на notifications_view, notifications_create, notifications_edit, notifications_delete
  7. 7.
    subscriptions: разбиты на subscriptions_view, subscriptions_edit

Прочее

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

2023-02-03

Сообщения

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

2023-01-25

Подключения

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

2022-12-27

Вебхуки

  1. 1.
    Допустимые статусы ответов теперь: 200, 201, 202 (был только 200)
  2. 2.
    Отключена повторная отправка вебхуков при получении статусов 4xx
  3. 3.
    Добавлено замечание об обработке тела и заголовков ответа (они игнорируются)

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

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

2022-12-26

Подписки

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

Сообщения

  1. 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. 1.
    /sales/shops/, /sales/catalogs/, /sales/products/ для управления магазинами, каталогами, товарами, соответственно.
  2. 2.
    /files/products/images/ для загрузки картинок для товаров
  3. 3.
    Добавлены коды ошибок 23xxx
  4. 4.
    Добавлены новые права для ролей (подробнее ниже)
  5. 5.
    Добавлен новый тип сообщения: radist_order - корзина с товарами (пример ниже)

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

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

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

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

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

  1. 1.
    banks_invoice_view, banks_invoice_create: разбиение banks
  2. 2.
    messaging_chat_create: переименованное messaging
  3. 3.
    sales_shop_view, sales_shop_edit, sales_shop_create, sales_shop_delete: доступ к управлению магазинами
  4. 4.
    sales_catalog_view, sales_catalog_edit, sales_catalog_create, sales_catalog_delete: доступы к каталогам
  5. 5.
    sales_product_view, sales_product_edit, sales_product_create, sales_product_delete: доступы к товарам

Сообщения

  1. 1.
    Метод GET /messaging/files/ помечен устаревшим (deprecated). В сообщения с файлами добавлено поле url, ссылку теперь можно получать, не делая лишних запросов
  2. 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": ""
}
}