> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Аутентификация в одно касание
> Используйте аутентификацию в одно касание с требуемым шаблоном и процессом проверки.
Аутентификация в одно касание позволяет пользователю поддерживаемого устройства Android нажать кнопку автозаполнения, чтобы передать код подтверждения в ваше приложение. Это избавляет от необходимости копировать код вручную, но по-прежнему требует интеграции с приложением и серверной проверки.
Источник: [официальный пример Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates/).
Выбор параметра шаблона в YCloud не выполняет автоматическую интеграцию в ваше Android-приложение.
## Подготовка интеграции для Android
Команде разработки приложения понадобятся:
| Элемент | Назначение |
| - | - |
| Имя пакета Android | Идентифицирует целевое приложение. |
| Хеш ключа подписи приложения | Идентифицирует подписанную сборку, которой разрешено получать код. |
| Конфигурация поддерживаемого приложения | Регистрирует разрешенные пары «имя пакета — хеш подписи» в шаблоне. |
| Обязательное рукопожатие (handshake) | Подтверждает готовность и право приложения на получение кода перед его доставкой. |
| Приемник кода и проверка на стороне бэкенда | Перехватывает результат и проверяет запрошенное действие. |
Используйте идентификаторы той сборки, которую действительно устанавливают клиенты. Отладочная (debug) и рабочая (production) сборки могут использовать разные ключи подписи, поэтому успешный локальный тест не гарантирует работу приложения, опубликованного в магазине.
Текущий контракт YCloud использует `supported_apps`. Устаревшие поля верхнего уровня `package_name` и `signature_hash` не рекомендуются к использованию; не применяйте их для новых интеграций.
## Создание шаблона
1. Выберите WABA и категорию **Authentication** .
2. Выберите вариант аутентификации в одно касание/автозаполнения (one-tap/autofill).
3. Укажите идентификаторы поддерживаемого Android-приложения и настройте обязательные параметры кнопки.
4. Настройте необязательные уведомления о безопасности и сроке действия.
5. Отправьте шаблон и дождитесь одобрения.
6. Подключите одобренный шаблон к логике запроса верификации в вашем приложении.
Для создания через API используйте тип кнопки OTP с `otp_type: "ONE_TAP"` и конфигурацией поддерживаемого приложения. Полное описание контракта см. в разделе [Управление шаблонами](/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-templates).
## Запуск клиентского сценария
Когда клиент запрашивает верификацию через WhatsApp, инициируйте обязательное рукопожатие на стороне приложения, отправьте одобренный шаблон аутентификации, получите код через поддерживаемое взаимодействие и подтвердите его соответствие активному запросу.
Передавайте один и тот же код в теле шаблона и в параметре URL-кнопки OTP. Шаблон передачи параметров при отправке описан в разделе [Аутентификация с копированием кода](/ru/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/copy-code-authentication#send-the-same-code-in-both-positions).
Связывайте код с соответствующей сессией и действием. Автозаполненное значение — это лишь введенные данные, а не решение об авторизации.
## Поддержка резервного сценария (fallback)
Клиент может получить возможность скопировать код вручную, если условия для автозаполнения не выполнены. Пользователи устройств не на базе Android не используют данную интеграцию с Android-приложением.
Протестируйте следующие сценарии:
* Корректно подписанное рабочее (production) приложение.
* Отладочная (debug) сборка или сборка с другим ключом подписи.
* Целевое приложение не установлено.
* Отсутствующее или неуспешное рукопожатие (handshake).
* Истекший или уже использованный код.
* Устройство не на базе Android.
Начиная с iOS 26 push-уведомления аутентификации WhatsApp могут предлагать встроенные подсказки на клавиатуре. Эта функция платформы не является подтверждением работоспособности интеграции для Android.
## План миграции на актуальный SDK
Текущее уведомление Meta продлевает срок вывода из эксплуатации метода рукопожатия `PendingIntent` до **15 октября 2026 года** и рекомендует выполнить миграцию на Android SDK для OTP. Проверьте существующие интеграции до наступления этого срока; ранее одобренный шаблон не обновляет код приложения автоматически.
Для реализации используйте [руководство по аутентификации Meta](https://developers.facebook.com/docs/whatsapp/business-management-api/authentication-templates/) и прикрепленные к нему инструкции по интеграции для Android.
Отслеживайте доставку сообщений, перехват кода и успешную верификацию отдельно. Если сообщения приходят, но отображается только действие копирования, проверьте идентификаторы приложения и выполнение условий рукопожатия, прежде чем изменять текст сообщения.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.