ym88659208ym87991671
Добавляем токены для обращения к сервисам | Документация для разработчиков

Добавляем токены для обращения к сервисам

Обновлено 23 января 2024

Чат-боты могут обращаться в различные сервисы для обмена данными. При этом для аутентификации запросов чат-боту необходимы токены.

Для повышения безопасности токены хранятся и используются в чат-ботах в зашифрованном виде. Токены хранятся в глобальных переменных, которые передаются в соответствующих блоках и сервисах. Например, в качестве параметров запросов сервиса http, если вы разрабатываете сценарий в Code.

Добавлять и изменять токены могут только администраторы проекта. Пользователи могут просматривать список токенов чат-бота и копировать переменные, в которых хранятся токены.

Вы можете использовать собственные токены для хранения сертификатов и ключей, которые используются при выполнении http-запросов (блок HTTP-запрос или сервис http).

Системные токены добавляются автоматически при подключении соответствующих сервисов.

Добавление собственных токенов

Используйте переменные с токенами в параметрах запросов и заголовках в блоке HTTP-запрос.

Чтобы добавить собственный токен:

  1. Откройте проект и перейдите в раздел Токены:

    • Если вы разрабатываете сценарий в Graph выберите НастройкиТокены.
    • Если вы разрабатываете сценарий в Code выберите НастройкиРедакторТокены.
  2. Выберите вкладку Мои токены.

  3. Нажмите кнопку Добавить.

  4. В окне Добавить токен заполните следующие поля:

    • В поле Имя переменной укажите имя переменной, в которой будет храниться токен. Переменную можно использовать в любом месте сценария. Максимальная длина имени переменной — 40 символов. Имя может содержать только цифры от 0 до 9, латинские буквы верхнего и нижнего регистров (Aa-Zz), и нижнее подчеркивание _.

    Имя переменной должно быть уникальным.

    • В поле Значение укажите необходимый токен. Максимальная длина токена — 1024 символа.
    • В поле Описание можно указать дополнительную информацию о токене.
  5. Нажмите кнопку Добавить.

Токен будет добавлен в список токенов чат-бота.

В собственных токенах можно сохранять app_key и app_secret необходимые для аутентификации запросов к проектам Platform V, созданным в других пространствах.

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

Просмотр системных токенов

Чтобы просмотреть системные токены:

  1. Откройте проект и перейдите в раздел Токены:

    • Если вы разрабатываете сценарий в Graph выберите НастройкиТокены.
    • Если вы разрабатываете сценарий в Code выберите НастройкиРедакторТокены.
  2. Выберите вкладку Системные токены.

Откроется список системных токенов, сгруппированных по типу сервиса. Системные токены нельзя удалить.

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.