Подключения
Подключение/connection - сущность, содержащая параметры для соединения с внешним сервисом (telegram/whatsapp/tinkoff/amocrm и т.п.)
- Через API нельзя удалить подключения. Для удаления необходимо обратиться в поддержку. Имейте в виду, что при удалении также удаляются связанные сущности. Например, при удалении те рминала банка, будут удалены все выставленные счета. При удалении мессенджера, будут удалены все чаты и история переписки.
- Редактирование параметров доступно не для всех типов подключений. Например, подключения AMOCRM/BITRIX управляются полностью на нашей стороне.
Сначала необходимо запросить код для авторизации в Telegram. Для этого необходимо отправить запрос, указав номер телефона : https://api.radist.online/v2/docs#/Telegram/TelegramSendCodeRequest
Пример ответа
{
"session_id": "string",
"phone_code_hash": "string"
}
❗Сохраните полученные в ответ
session_id & phone_code_hash.После получения кода от пользователя необходимо создать подключение: https://api.radist.online/v2/docs#/Connections/ConnectionsCreateItem
Пример запроса
{
"name": "ЛЮБОЕ НАЗВАНИЕ",
"type": "telegram",
"params": {
"phone": "+79000000000", // телефон клиента
"phone_code_hash": "значение с предыдущего шага",
"session_id": "значение с предыдущего шага",
"code": 12345, // код, который пришёл в SMS или в приложении
}
При получении ответа с кодом ошибки
17003 (необходима двухфакторная авторизация) необходимо запросить у пользователя пароль и снова отправить запрос на создание подключения, но добавив в параметры поле password.В некоторых случаях может быть необходимо повторить авторизацию. Например, если в приложении Telegram принудительно завершили сессию, которую открыл наш сервис.
Необходимо запросить код, передав в параметрах id подключения: https://api.radist.online/v2/docs#/Telegram/TelegramSendCodeRequest
В ответ так же придут
session_id и phone_code_hash.Затем необходимо отправить запрос на авторизацию: https://api.radist.online/v2/docs#/Telegram/TelegramSendLoginRequest
{
"connection_id": 12345,
"code": 123456, // код, пришедший в SMS или в приложении
"phone_code_hash": "string" // значение с предыдущего шага
}
Если на номере включена двухфакторная авторизация, то в ответ будет получена ошибка с кодом
17003 (необходима двухфакторная авторизация). Нужно будет повторить запрос, добавив пароль в поле password:{
"connection_id": 12345,
"code": 123456, // код, пришедший в SMS или в приложении
"phone_code_hash": "string", // значение с предыдущего шага
"password": "string" // пароль от 2FA
}
Необходимо создать подключение с типом
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-код и отсканировать его.
Необходимо создать подключение с типом
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-ключ может возникнуть по разным причинам:
- В настройках группы сбросили ключ
- Ключ давно не использовался и стал неактивен
Для его обновления можно использовать метод: https://api.radist.online/v2/docs#/Connections/ConnectionsUpdateItem
Last modified 1mo ago