Подключения

Общее

Swagger: https://api.radist.online/v2/docs#/Connections

Необходимые права доступа (scopes) для работы с API: connections

Подключение/connection - сущность, содержащая параметры для соединения с внешним сервисом (telegram/whatsapp/tinkoff/amocrm и т.п.)

Замечания

• Через API нельзя удалить подключения. Для удаления необходимо обратиться в поддержку. Имейте в виду, что при удалении также удаляются связанные сущности. Например, при удалении терминала банка, будут удалены все выставленные счета. При удалении мессенджера, будут удалены все чаты и история переписки.

• Редактирование параметров доступно не для всех типов подключений. Например, подключения AMOCRM/BITRIX управляются полностью на нашей стороне.

• Чтобы подключение работало, оно должно быть в оплаченной подписке.

Примеры

Подключение Telegram

Подключение происходит в несколько шагов:

1. Создание сессии для авторизации

2. Авторизация

3. Ввод пароля двухфакторной авторизации (если есть)

4. Создание подключения

Подключение через сканирование QR-кода

1. Создаём сессию авторизации https://api.radist.online/v2/docs#/Telegram/TelegramInitializeSession

Создание сессии

POST /telegram/init

{"auth_type": "qr"}


Response:
{
  "session_id": "fc9132a1-3992-4b57-a9d3-102e17438ae7",
  "status": "waiting_for_qr",
  "qr_login": {
    "url": "tg://login?token=AQLZrYtmQM3kCsDhxpI8zLlKnBvHu8_4sX7d8AaRCI6PGA",
    "expires": "2024-07-08T09:14:01Z",
    "qr_code": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAM0AAADNAQAAAAAzx8nEAAABq0lEQVR42u1YMY6DQBAztwUlT9ifhI8hgXQfCz/hCZRboMzZA2lOSneKi8sWqyVbxMzYXi+IV6Phs/Xvt3YAXRw1Hpg3ThOfMUf7wsvx51uCMUes8R1xJwLBqPnb22FM6NedhVi1CtYFnQsGq8HOLGBdzDBYiKW2zgYjuXEAN5TNyA0pZZ8qCXJOHqXkIEXbKIJgeGr57dWo+fp97GVLgrBHYWkKC7GRGwSkiQ5iaMpR07kwipidAI27B8ZjWKp8ozaoGg6l8PX555NWi1Q7CVUYlCJiHmg3dUbStXCDSjlbcfl40eniMHN1gdXAQHZSulv/gOuETQOdL9+w2FeJnpyUTKfKqYSlKWJnp0JcxywfHb6R1UAJ3AYJllrtLb6xiJ0hfUAwlkylHhc9owaQIrHAUOy5synJiNQMrdRh5kKgUD5oJbE6zFyWcR+OStXydBn3qzOe9FXoG3QueVh4InFmUfkGT5eeyaP6bm1nEsTpXL351jY/uWGhqK5LurCRrC3D8eqrhrR6ZOiApynJDbqo5JJY8mDxKKXkHVaWMSkOmnzj89Hps/V76weB4g+4/HjcLwAAAABJRU5ErkJggg=="
  }
}

1. Отображаем пользователю QR-код для сканирования

2. Периодически (например, раз в 5 секунд) опрашиваем статус сессии: https://api.radist.online/v2/docs#/Telegram/TelegramSendLoginRequest

Проверка статуса

POST /telegram/login
{
  "session_id": "fc9132a1-3992-4b57-a9d3-102e17438ae7",
  "code": null,
  "password": null
}

1. Если в ответ снова получили сессию со status=waiting_for_qr и qr-код изменился, показываем новый код пользователю.

2. Если в ответ получили сессию со status=waiting_for_password, то показываем пользователю поле ввода пароля для 2FA. Этого шага может не быть, если 2FA отключена.

Передача пароля

POST /telegram/login
{
  "session_id": "fc9132a1-3992-4b57-a9d3-102e17438ae7",
  "code": null,
  "password": "radist"
}

Response:
{
  "session_id": "fc9132a1-3992-4b57-a9d3-102e17438ae7",
  "status": "authenticated",
  "qr_login": null
}

1. После того, как получили сессию со status=authenticated, можно создавать подключение: https://api.radist.online/v2/docs#/Connections/ConnectionsCreateConnection

Создание подключения

POST /connections/
{
  "name": "demo",
  "type": "telegram",
  "params": {
    "session_id": "fc9132a1-3992-4b57-a9d3-102e17438ae7"
  }
}

Response:
{
  "id": 12345,
  "name": "demo",
  "radist_token": "4bdb7858-cd5e-4d61-b544-c56b3382ab9b",
  "last_status": {
    "status_type": "good",
    "status_subtype": "normal"
  },
  "integrations": [],
  "subscription_id": 12,
  "type": "telegram",
  "params": {
    "user_id": "12345678",
    "username": null,
    "phone": "[phone]",
    "group_chats_enabled": false
  }
}

Подключение через код в чате Telegram

1. Создаём сессию авторизации https://api.radist.online/v2/docs#/Telegram/TelegramInitializeSession

Создание сессии

POST /telegram/init

{
  "auth_type": "code",
  "phone": "[phone]"
}


Response:
{
  "session_id": "08661526-6318-4694-bbcd-c9634616ade4",
  "status": "waiting_for_code"
}

1. Показываем пользователю поле для ввода кода

2. Когда получили код, авторизуемся: https://api.radist.online/v2/docs#/Telegram/TelegramSendLoginRequest

Проверка статуса

POST /telegram/login
{
  "session_id": "08661526-6318-4694-bbcd-c9634616ade4",
  "code": 44472
}

1. Если в ответ получили сессию со status=waiting_for_password, то показываем пользователю поле ввода пароля для 2FA. Этого шага может не быть, если 2FA отключена.

Передача пароля

POST /telegram/login
{
  "session_id": "08661526-6318-4694-bbcd-c9634616ade4",
  "code": 44472,
  "password": "radist"
}

Response:
{
  "session_id": "08661526-6318-4694-bbcd-c9634616ade4",
  "status": "authenticated"
}

1. После того, как получили сессию со status=authenticated, можно создавать подключение: https://api.radist.online/v2/docs#/Connections/ConnectionsCreateConnection

Создание подключения

POST /connections/
{
  "name": "demo",
  "type": "telegram",
  "params": {
    "session_id": "08661526-6318-4694-bbcd-c9634616ade4"
  }
}

Response:
{
  "id": 12345,
  "name": "demo",
  "radist_token": "4bdb7858-cd5e-4d61-b544-c56b3382ab9b",
  "last_status": {
    "status_type": "good",
    "status_subtype": "normal"
  },
  "integrations": [],
  "subscription_id": 12,
  "type": "telegram",
  "params": {
    "user_id": "12345678",
    "username": null,
    "phone": "[phone]",
    "group_chats_enabled": false
  }
}

Повторная авторизация

В некоторых случаях может быть необходимо повторить авторизацию. Например, если в приложении Telegram принудительно завершили сессию, которую открыл наш сервис.

Это делается аналогично тому, как происходит первое подключение (см. примеры выше), только при создании сессии для авторизации нужно обязательно передать connection_id и после успешной авторизации не нужно создавать новое подключение.

Создание сессии

POST /telegram/init
{
  "auth_type": "qr",
  "connection_id": 44378
}

Response:
{
  "session_id": "9bc32742-94d5-4ff1-98c8-0239c3ae43f0",
  "status": "waiting_for_qr",
  "qr_login": {
    "url": "tg://login?token=AQJ1s4tmLweHr81U7_dHuP2F71vbNCREIR9mHZb48bABOQ",
    "expires": "2024-07-08T09:37:57Z",
    "qr_code": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAM0AAADNAQAAAAAzx8nEAAABvElEQVR42u1YMY6EMAwcjiIlT8hP4GNIQcrH4Cd5AmUKtL6xvXfFSdutcHGbAgXSjOyZyRjIq9XxOfr3RyeA4RxFHigN83TxHUX6F16utx8pjCJyKKZDriw71mzfboexIh0nC8EaNJZkzSxOFIyxyT5VwcCSBMLgbsfYsJxR1TBuVEnCkiQjSAg3TClrZkn8EaMUX7VpSZSi5anl+6shh3YBahmz8TSkKbkvtK++yIauSuFrQFM2mH0RBrU6Uy5enNsFm5P5+EAsJl1EVMNkaval7FRAiur+ptTWZ6yQB9nZBwV0BChFRE2L+lgcwaWAAmBcoDRA5yIg8rS2EMFSKelw+9oy24NsZL0fRiYxR9HEY7ugalw57aaPaXPnwhJh5oVKIYKkeYOAgBRBUWXnPonH0PSbCQNij/qG+jgfIEt6CDdEgGmjhStZLRLvES662Z0iHgcf3h4JCYGMoaL2pUkwiKK2/H4rfsezRxKTRc3R1cyNpzG+IX6hGTE1DccMjzqnmJVSLmZfMU3xqY089UjMzgQOj9oPZKNozICg3CBPGcqr7kqLyaLPqY1zSm0/U0KQb3x+On2O/h59A0RWFuNAeCv9AAAAAElFTkSuQmCC"
  }
}

Подключение Telegram Bot

Подключение

Необходимо создать подключение с типом telegram_bot, передав API ключ от бота: https://api.radist.online/v2/docs#/Connections/ConnectionsCreateItem

Пример запроса

{
  "name": "demo",
  "params": {
    "bot_token": "1738456161:AAERS_R5S2cly6u4DkWY0oeTq4zWWu54lxw"
  },
  "type": "telegram_bot"
}

Пример ответа

{
  "id": 12345,
  "name": "demo",
  "radist_token": "12bbecfc-5701-4d60-ba61-d6bf2a346870",
  "last_status": null,
  "integrations": [],
  "subscription_id": 618,
  "type": "telegram_bot",
  "params": {
    "bot_id": "1738456161",
    "bot_username": "demo_bot"
  }
}

Подключение WhatsApp

Авторизация, подключение

Необходимо создать подключение с типом whatsapp: https://api.radist.online/v2/docs#/Connections/ConnectionsCreateItem

Пример запроса

{
  "name": "some name",
  "type": "whatsapp"
}

Пример ответа

{
  "id": 6271,
  "name": "some name",
  "radist_token": "a091b49b-055b-4e62-a913-19544b829c64",
  "last_status": {
    "status_type": "bad",
    "status_subtype": "whatsapp_qr_not_scanned"
  },
  "integrations": null,
  "subscription_id": 616,
  "type": "whatsapp",
  "params": {
    "phone": null,
    "qr_url": "https://services.radist.online/whatsapp/qr/Vw9WE5XjWyK3"
  }
}

После этого необходимо отобразить пользователю QR-код, чтобы он отсканировал его в мобильном приложении WhatsApp. Сделать это можно двумя способами:

1. Отдать пользователю ссылку из params->qr_url

2. Также код можно получить этим методом: https://api.radist.online/v2/docs#/Connections/ConnectionsGetWhatsappInstanceStatus

Время жизни кода ограничено (около 30 сек). Возможно потребуется отсканировать его несколько раз.

{
  "status": "qr",
  "qr_code": "data:image/png;base64,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"
}

Для переподключения достаточно запросить новый QR-код и отсканировать его.

Подключение MAX

Первое подключение

1. Создаём сессию авторизации: https://api.radist.online/v2/docs#/Max%20personal/Max%20personalInitializeSession

Создание сессии

POST /max_personal/init
{
  "phone": "[phone]"
}


Response:
{
  "session_id": "08661526-6318-4694-bbcd-c9634616ade4",
  "status": "waiting_for_code"
}

1. Показываем пользователю поле для ввода кода

2. Когда получили код, авторизуемся:

https://api.radist.online/v2/docs#/Max%20personal/Max%20personalSendLoginRequest

Проверка статуса

POST /max_personal/login
{
  "session_id": "08661526-6318-4694-bbcd-c9634616ade4",
  "code": "44472"
}

Response:
{
  "session_id": "08661526-6318-4694-bbcd-c9634616ade4",
  "status": "authenticated"
}

1. После того, как получили сессию со status=authenticated, можно создавать подключение: https://api.radist.online/v2/docs#/Connections/ConnectionsCreateConnection

Создание подключения

POST /connections/
{
  "name": "demo",
  "type": "max_personal",
  "params": {
    "session_id": "08661526-6318-4694-bbcd-c9634616ade4"
  }
}

Response:
{
  "id": 12345,
  "name": "demo",
  "radist_token": "4bdb7858-cd5e-4d61-b544-c56b3382ab9b",
  "last_status": {
    "status_type": "good",
    "status_subtype": "normal"
  },
  "integrations": [],
  "subscription_id": 12,
  "type": "max_personal",
  "params": {
    "user_id": "12345678",
    "phone": "[phone]"
  }
}

Подключение Одноклассников

Первое подключение

Необходимо создать подключение с типом odnoklassniki, передав API ключ от группы: https://api.radist.online/v2/docs#/Connections/ConnectionsCreateItem

Пример запроса

{
  "name": "ok demo",
  "type": "odnoklassniki",
  "params": {
    "ok_api_key": "tkn1YMi1UuraOrb5DpqmD9TYEFAabPg3mlaRHK4hfusrud5oVIee0LlAxNJ7jJA33FQR1:CLEQNMJGDIHBABABA"
  }
}

Пример ответа

{
  "id": 6272,
  "name": "ok demo",
  "radist_token": "73def00f-22fa-4541-a5c1-a15eb347a959",
  "last_status": {
    "status_type": "good",
    "status_subtype": "normal"
  },
  "integrations": null,
  "subscription_id": 617,
  "type": "odnoklassniki",
  "params": {
    "group_id": "group:59129296584917"
  }
}

Изменение API-ключа

Необходимость изменить API-ключ может возникнуть по разным причинам:

• В настройках группы сбросили ключ

• Ключ давно не использовался и стал неактивен

Для его обновления можно использовать метод: https://api.radist.online/v2/docs#/Connections/ConnectionsUpdateItem