Документація

Вхід через Google, Facebook і Telegram

Де взяти ключі в кабінеті кожного сервісу, куди їх вставити в магазині та чому кнопка може не з'явитися.

На цій сторінці

Покупець може увійти в магазин через Google, Facebook або Telegram — однією кнопкою, без пароля. Кнопки з'являються у вікні входу та на сторінці входу, щойно ви ввімкнули сервіс і вставили його ключі.

Ключі ви отримуєте в кабінеті самого сервісу: це безкоштовно й займає 10–15 хвилин. Нижче — покроково для кожного сервісу.

Де вставляти ключі

«Вітрини та контент» → «Вітрини» → ваша вітрина → вкладка «Реєстрація та вхід» → блок «Вхід через сервіси».

У кожного сервісу там три речі:

  • перемикач — чи показувати кнопку на вітрині;
  • поля для ключів — сюди ви вставляєте те, що видав сервіс;
  • адреса повернення з кнопкою «Скопіювати» — її ви вставляєте в кабінет сервісу. На цю адресу сервіс повертає покупця в магазин після входу.

Адреса повернення виглядає так: https://ваш-магазин.com/account/social/google/callback. Копіюйте її кнопкою, а не набирайте вручну: сервіс звіряє адресу посимвольно, і зайва скісна риска чи /uk/ на початку призведуть до відмови.

Вхід через сервіси працює лише на справжньому домені з https. На тестовій адресі на кшталт shop.local Google і Telegram покупця не пропустять.

Google

  1. Відкрийте Google Cloud Console і увійдіть своєю поштою Google. Угорі оберіть проєкт або створіть новий — наприклад, «Магазин».
  2. Відкрийте «APIs & Services» → «OAuth consent screen» (екран згоди). Тип користувачів — External. Заповніть назву магазину, пошту для зв'язку й логотип, якщо хочете. Збережіть.
  3. На тому ж екрані натисніть «Publish app». Поки застосунок не опубліковано, увійти зможуть лише адреси, які ви вручну додали до тестових.
  4. Відкрийте «APIs & Services» → «Credentials» → «Create credentials» → «OAuth client ID». Тип застосунку — Web application.
  5. У полі «Authorized redirect URIs» натисніть «Add URI» і вставте адресу повернення з блоку Google у магазині.
  6. Натисніть «Create». Google покаже Client ID і Client secret.
  7. У магазині, в блоці Google: Client ID вставте в поле «Ідентифікатор застосунку», Client secret — у «Секретний ключ». Увімкніть перемикач і збережіть вітрину.

Google передає магазину ім'я та підтверджену пошту покупця. Телефону в Google немає — магазин запитає його під час оформлення замовлення.

Facebook

  1. Відкрийте Meta for Developers і увійдіть своїм обліковим записом Facebook. Якщо ви тут уперше, Meta попросить зареєструватися як розробник — це безкоштовно.
  2. «Мої застосунки» → «Створити застосунок». У виборі сценарію позначте вхід через Facebook (автентифікація користувачів). Назвіть застосунок так само, як магазин.
  3. У застосунку відкрийте налаштування «Вхід через Facebook» і в полі «Дійсні URI переспрямування для OAuth» вставте адресу повернення з блоку Facebook у магазині. Збережіть.
  4. Відкрийте «Налаштування застосунку» → «Основне». Вкажіть посилання на політику конфіденційності магазину — без нього Meta не опублікує застосунок.
  5. Там само візьміть ID застосунку та Секрет застосунку (натисніть «Показати»).
  6. Переведіть застосунок у режим «Опубліковано» (Live). У режимі розробки увійти зможете лише ви та люди, яких ви додали до застосунку.
  7. У магазині, в блоці Facebook: ID застосунку вставте в «Ідентифікатор застосунку», Секрет застосунку — у «Секретний ключ». Увімкніть перемикач і збережіть вітрину.

Facebook передає ім'я та пошту, якщо покупець дозволив її показувати. Пошту, яку Facebook не підтвердив, магазин не використовує для входу в уже наявний кабінет — це захист від чужих облікових записів.

Telegram

Вхід через Telegram працює через доповнення «Telegram: бот»: спершу встановіть його та під'єднайте бота магазину токеном із BotFather. Ключі для входу — це не токен бота, а окрема пара.

  1. У Telegram відкрийте @BotFather і оберіть бота магазину: /mybots → ваш бот.
  2. Bot Settings → Web Login → OpenID Connect Login. Перемикання незворотне: цей бот пускатиме людей у магазин за стандартом OpenID.
  3. Вкажіть домен магазину й адресу повернення з блоку Telegram у магазині, якщо BotFather їх запитає.
  4. BotFather видасть Client ID (число) і секретний ключ.
  5. У магазині, в блоці Telegram: Client ID — в «Ідентифікатор бота», ключ — у «Секретний ключ входу». Увімкніть перемикач і збережіть вітрину.

Позначка «Просити номер телефону» попросить Telegram показати покупцеві запитання, чи готовий він поділитися номером. Відмова входу не заважає, а згода одразу заповнює телефон у кабінеті.

Телефон після входу через сервіс

Соцмережі не передають телефон, а магазину він потрібен для доставки. Типово магазин питає його під час оформлення замовлення й сам зберігає в кабінет. Якщо хочете питати одразу після входу, увімкніть у тому ж блоці «Просити телефон одразу після входу».

Якщо кнопка не з'явилася

  • Перемикач вимкнено або не заповнено одне з полів ключів — під блоком сервісу тоді видно рядок «Ключі не заповнені».
  • Вітрину не збережено після вставлення ключів.
  • Сервіс відповідає «redirect_uri_mismatch» чи «URL заблоковано» — адреса повернення в кабінеті сервісу не збіглася з адресою з магазину. Скопіюйте її ще раз кнопкою та вставте повністю.
  • Google пише «доступ заблоковано» всім, крім вас — застосунок не опубліковано (крок 3 у розділі Google).
Оновлено 25 вересня 2026