> ## 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.

# Верификация через WhatsApp

Использование WhatsApp для доставки одноразового пароля (OTP) для помощи в аутентификации пользователей.

Отправляйте OTP-сообщения через WhatsApp на устройство пользователя. Этот опыт похож на получение OTP по SMS, и даже на телефонах Android код OTP можно получить непосредственно из англоязычного сообщения WhatsApp, что позволяет пользователям получить код, не выходя из приложения.

## Преимущества верификации через WhatsApp

Как канал верификации он обладает теми же преимуществами, что и SMS, и не зависит от инфраструктуры местного оператора. Это означает, что сообщения WhatsApp могут быть получены в местах, где есть Wi-Fi, но слабый или отсутствующий сотовый сигнал (например, в отдалённых районах или в самолётах). WhatsApp обычно быстрее SMS и использует сквозное шифрование, обеспечивая дополнительную безопасность.

WhatsApp также предлагает больше преимуществ безопасности: каждый пользователь WhatsApp идентифицируется уникальным номером телефона, указанным при создании аккаунта. WhatsApp использует собственный набор мощных инструментов противодействия мошенничеству для верификации этих номеров. Это означает, что часть работы по аутентификации вы передаёте WhatsApp.

Во многих странах WhatsApp дешевле SMS и может помочь сэкономить, не тарифицируя неотправленные сообщения. В Индии, Индонезии и Южной Америке мы рекомендуем использовать WhatsApp как предпочтительный канал верификации, поскольку он может повысить общую конверсию верификации и стоит дешевле.

Теперь используйте YCloud verification вместо построения с нуля, начните отправлять OTP немедленно — без ограничений по количеству сообщений и отраслям — и отправляйте через предварительно одобренные общие номера WhatsApp.

## Настройка верификации через WhatsApp

1. Используйте API отправки кода верификации, указав канал как WhatsApp.
2. Проверьте верификацию так же, как для любого другого канала. [Справочный API](/api-reference/verify/start-a-verification)

## Тарификация верификации через WhatsApp

Стоимость отправки сообщений зависит от страны, куда отправлено сообщение верификации, дополнительных сборов нет. WhatsApp тарифицирует только успешные сообщения — вы не платите за неудачные или недоставленные.

[💰️ Подробнее о ценах на WhatsApp.](https://www.ycloud.com/price)

## Лучшие практики внедрения WhatsApp OTP

### Дизайн пользовательского интерфейса

Использование WhatsApp для отправки OTP — это новый подход, и мы приводим рекомендации по UI:

| Вариант дизайна | Подходящие сценарии |
| - | - |
| <p>По умолчанию отправлять OTP через WhatsApp<br />Немедленно отправлять по SMS, если WhatsApp не сработал (скорее всего, потому что целевой номер ещё не зарегистрировал личный аккаунт WhatsApp).</p> | Ваша аудитория преимущественно в странах с высоким покрытием WhatsApp, таких как Индонезия, Индия, Бразилия и Колумбия. |
| Предоставить кнопки выбора каналов получения OTP-сообщений, позволяя пользователям самим выбрать канал получения OTP. | Ваша аудитория в странах с недостаточным покрытием WhatsApp, или ваше приложение охватывает много стран. |

<img src="https://mintcdn.com/lchnan/Z2X3BzyqaivSGKDr/product-assets/59ffc651fe-image-491.webp?fit=max&auto=format&n=Z2X3BzyqaivSGKDr&q=85&s=e4fa96cbc62b0356a0739d04d8031ae9" alt="Скриншот продукта YCloud" width="2880" height="2160" data-path="product-assets/59ffc651fe-image-491.webp" />

OTP по умолчанию отправляется через WhatsApp. При неудаче он немедленно повторно отправляется по SMS.

<img src="https://mintcdn.com/lchnan/6CxA7mK2t7klNAOL/product-assets/abe06bb28a-653b8ca2a8195.webp?fit=max&auto=format&n=6CxA7mK2t7klNAOL&q=85&s=de56598292c8fead52a644068f389228" alt="Предоставьте кнопки выбора каналов получения OTP-сообщений" width="2880" height="2160" data-path="product-assets/abe06bb28a-653b8ca2a8195.webp" />

*Предоставьте кнопки выбора каналов получения OTP-сообщений*

## Проверьте, установлен ли у пользователя WhatsApp

Чтобы улучшить пользовательский опыт и использовать WhatsApp по умолчанию, вы можете определить, установлен ли WhatsApp на том же устройстве, где запущено ваше приложение. Пример реализации обнаружения WhatsApp на Android:

```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
fun PackageManager.isPackageInstalled(packageName: String): Boolean {
  return try {
    getPackageInfo(packageName, PackageManager.GET_ACTIVITIES)
    true
  } catch (e: NameNotFoundException) {
    false
  }
}

fun isWhatsAppInstalled : Boolean() {
    val whatsAppPackageName = "com.whatsapp"
    val whatsAppBusinessPackageName = "com.whatsapp.w4b"
    return getPackageManager().isPackageInstalled(whatsAppPackageName) || getPackageManager().isPackageInstalled(whatsAppBusinessPackageName)
}
```

## Вопросы и ответы

<Accordion title="Почему WhatsApp — хороший канал для доставки OTP?">
  За последние несколько лет мы стали свидетелями появления нового канала сообщений — WhatsApp. У него более 2 миллиардов пользователей в 180 странах, и он быстро распространяется в разных странах. Каждый пользователь WhatsApp идентифицируется уникальным номером телефона, указанным при создании аккаунта, что означает, что WhatsApp может напрямую заменить SMS для всех сценариев верификации, включая регистрацию, вход и транзакции.
</Accordion>

<Accordion title="Как работает верификация через WhatsApp?">
  Если вы знакомы с API верификации для отправки SMS OTP, вам просто нужно изменить обязательный параметр канала с SMS на WhatsApp в API-запросе. Как и в случае с SMS, предварительно одобренное шаблонное OTP-сообщение отправляется через общий номер телефона, поддерживаемый YCloud.
</Accordion>

<Accordion title="Могу ли я использовать свой бренд и номер телефона для отправки OTP-сообщений в WhatsApp вместо использования «универсального отправителя» YCloud?">
  В настоящее время невозможно задать ваш бренд и номер телефона в качестве отправителя. Однако название вашего бренда будет включено в тело WhatsApp-сообщения. Использование универсального отправителя WhatsApp от YCloud для верификации имеет одно из главных преимуществ — возможность использовать общий номер WhatsApp от YCloud. У него следующие преимущества:

  * Начните с максимального лимита сообщений с самого начала
  * Избегайте потенциальных препятствий в бизнес-политиках WhatsApp, например для приложений знакомств и криптовалютных продуктов. Однако вы всё равно должны соблюдать политику допустимого использования YCloud.
</Accordion>

<Accordion title="Какой продукт YCloud использовать: Verification WhatsApp API или WhatsApp Programmable Messaging API?">
  Если ваш сценарий — доставка OTP, мы настоятельно рекомендуем использовать YCloud Verification WhatsApp API, так как это специально созданное для этого решение. Если вы хотите разрабатывать более персонализированные сценарии обмена сообщениями с помощью WhatsApp, вы можете выбрать [WhatsApp Programmable Messaging API](/api-reference/whatsapp-messages/enqueue-a-message).
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.