Налаштування бот-акаунта
Створення бот-акаунта — це важливий крок у вашій подорожі розробки з yurba.js. Цей посібник проведе вас через процес налаштування вашого бот-акаунта та отримання необхідних токенів аутентифікації.
Розуміння бот-акаунтів на Yurba.one
Важлива інформація
Наразі Yurba.one не надає спеціальні ендпоінти для бот-додатків. Натомість вам потрібно створити звичайний користувацький акаунт, який служитиме вашим ботом. Цей підхід є тимчасовим і може змінитися в майбутніх версіях API.
Навіщо використовувати окремий акаунт?
Хоча технічно ви могли б використовувати свій особистий акаунт для розробки бота, ми наполегливо рекомендуємо створити окремий акаунт з кількох причин:
- Безпека: Тримає ваш особистий акаунт окремо від діяльності бота
- Організація: Полегшує управління налаштуваннями і даними, специфічними для бота
- Безпечність: Зменшує ризик для вашого основного акаунта під час розробки та тестування
- Професіоналізм: Надає чисту, виділену ідентичність для вашого бота
Створення вашого бот-акаунта
Крок 1: Реєстрація акаунта
Оберіть один із цих способів реєстрації:
Варіант A: Пряма реєстрація
- Перейдіть на yurba.one/register
- Заповніть форму реєстрації інформацією про вашого бота
- Використовуйте будь-яку електронну адресу для вашого бота (наприклад,
mybot@domain.com)
- Ви також можете використовувати тимчасову електронну пошту, але тоді рекомендується додати вашу справжню електронну пошту як
резервну електронну поштув налаштуваннях
- Оберіть ім'я користувача, яке чітко ідентифікує його як бота
- Завершіть процес реєстрації
Варіант B: Реєстрація через Google OAuth
- Відвідайте yurba.one/login
- Натисніть "Увійти через Google"
- Використовуйте Google акаунт, призначений для вашого бота
- Завершіть OAuth потік
Кращі практики для бот-акаунтів
- Використовуйте описові імена користувачів (наприклад,
WeatherBot,ModeratorBot) - Завжди додавайте в кінець посилання (@) закінцення
_bot - Встановіть чітке зображення профілю, яке представляє функцію вашого бота
- Напишіть біографію, яка пояснює, що робить ваш бот
Крок 2: Конфігурація акаунта
Після реєстрації налаштуйте ваш бот-акаунт:
- Налаштування профілю
- Напишіть чіткий опис призначення вашого бота
Отримання вашого токена аутентифікації
Токен аутентифікації — це ключ вашого бота для доступу до Yurba API. Обробляйте його з надзвичайною обережністю.
Доступ до налаштувань токена
- Перейдіть до налаштувань безпеки
- Перейдіть до Налаштування → Безпека
- Скопіюйте токен з сесій
- Зберігайте його безпечно
Критичне попередження про безпеку
Ніколи не діліться своїм токеном ні з ким! Ваш токен надає повний доступ до вашого бот-акаунта. Обробляйте його як пароль і зберігайте безпечно, використовуючи змінні середовища або безпечні файли конфігурації.
Розуміння токенів Yurba
Формат токена
Токени Yurba дотримуються специфічного формату:
- Префікс: Завжди починаються з
y. - Довжина: Зазвичай 32-34 символи загалом
- Символи: Алфавітно-цифрові символи
Приклади форматів:
y.RT0ZALrC4tUwU7WmEGvq5XdlsRjpMlrL
y.lSRjyiajBHC3EoZ8lLbYDnBpwXiPN9u3Приклади токенів
Показані вище токени є лише прикладами і були деактивовані перед публікацією.
Що робити, якщо ваш токен скомпрометовано?
Якщо ви підозрюєте, що ваш токен був скомпрометований:
Негайні дії
- Відкликайте токен
- Перейдіть до Налаштування → Безпека
- Натисніть "Зупинити сесії"
- Це негайно деактивує скомпрометований токен
WARNING
Також, коли ви входите в акаунт, створюється новий токен. Рекомендується
також видалити його, оскільки може бути запущений скрипт, який копіює всі токени. Увійдіть в акаунт знову - цей токен точно не буде доступний нікому, крім вас
Відновлення акаунта
Якщо ви втратили доступ до вашого бот-акаунта:
Скидання пароля
- Використовуйте стандартний процес скидання пароля
- Перевірте електронну пошту, пов'язану з вашим бот-акаунтом
Звернення до підтримки
- Якщо скидання пароля не спрацьовує, зверніться до підтримки Yurba.one
- Надайте доказ власності акаунта
- Поясніть, що це бот-акаунт