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

# Verificação via WhatsApp

Usando o WhatsApp para entregar uma senha de uso único (OTP) para ajudar na autenticação de usuários.

Envie mensagens OTP via WhatsApp para o dispositivo do usuário. Essa experiência é semelhante a receber um OTP por SMS e, mesmo em celulares Android, o código OTP pode ser recuperado diretamente da mensagem do WhatsApp em inglês, permitindo que os usuários recebam o código sem sair do aplicativo.

## Benefícios da verificação por WhatsApp

Como canal de verificação, tem as mesmas vantagens do SMS e não é afetado pela infraestrutura da operadora local. Isso significa que as mensagens do WhatsApp podem ser recebidas em áreas onde há Wi-Fi, mas o sinal da rede móvel é fraco ou inexistente (como áreas remotas ou em aviões). O WhatsApp geralmente é mais rápido que o SMS e tem criptografia de ponta a ponta, oferecendo segurança adicional.

O WhatsApp também oferece mais vantagens de segurança: cada usuário do WhatsApp pode ser identificado pelo número de telefone único fornecido ao criar uma conta. O WhatsApp usa seu próprio conjunto de ferramentas robustas antifraude para verificar esses números de telefone. Isso significa que você terceiriza parte do trabalho de autenticação para o WhatsApp.

Em muitos países, o WhatsApp é mais barato que o SMS e pode ajudar você a economizar dinheiro sem cobrar por mensagens não enviadas. Na Índia, Indonésia e América do Sul, recomendamos o uso do WhatsApp como canal de verificação preferido, pois ele pode melhorar sua taxa geral de conversão de verificação e é mais barato.

Agora, use a verificação do YCloud em vez de construí-la do zero. Comece a enviar OTP imediatamente, sem restrições de quantidade de mensagens ou de setor, e envie por meio de números de telefone compartilhados do WhatsApp previamente aprovados.

## Configurando a verificação por WhatsApp

1. Use a API de envio de código de verificação, com o canal especificado como WhatsApp.
2. Verifique o código como em qualquer outro canal. [API de referência](/api-reference/verify/start-a-verification)

## Preços da verificação por WhatsApp

O custo de envio de mensagens varia conforme o país para o qual a mensagem de verificação é enviada, e não há taxas adicionais. O WhatsApp só cobra por mensagens bem-sucedidas, e você não paga por mensagens com falha ou não entregues.

[💰️ Veja os preços do WhatsApp para mais detalhes.](https://www.ycloud.com/price)

## Melhores práticas para implementar OTP no WhatsApp

### Design da interface do usuário

Usar o WhatsApp para enviar OTP é uma abordagem nova, e fornecemos algumas sugestões de design de UI:

| Opção de design | Cenários aplicáveis |
| - | - |
| <p>Envio padrão de OTP via WhatsApp<br />Enviar via SMS imediatamente se o WhatsApp falhar (provavelmente porque o número de telefone de destino ainda não registrou uma conta pessoal do WhatsApp).</p> | Seu público está principalmente em países com alta cobertura de WhatsApp, como Indonésia, Índia, Brasil e Colômbia. |
| Fornecer opções de botão para canais de recebimento de mensagens OTP, permitindo que os usuários escolham seu próprio canal de recebimento de OTP. | Seu público está em países com cobertura insuficiente do WhatsApp ou seu aplicativo abrange muitos países. |

<img src="https://mintcdn.com/lchnan/Z2X3BzyqaivSGKDr/product-assets/59ffc651fe-image-491.webp?fit=max&auto=format&n=Z2X3BzyqaivSGKDr&q=85&s=e4fa96cbc62b0356a0739d04d8031ae9" alt="Captura de tela do produto YCloud" width="2880" height="2160" data-path="product-assets/59ffc651fe-image-491.webp" />

O OTP é enviado por padrão via WhatsApp. Se falhar, é reenviado por SMS imediatamente.

<img src="https://mintcdn.com/lchnan/6CxA7mK2t7klNAOL/product-assets/abe06bb28a-653b8ca2a8195.webp?fit=max&auto=format&n=6CxA7mK2t7klNAOL&q=85&s=de56598292c8fead52a644068f389228" alt="Fornecer opções de botão para canais de recebimento de mensagens OTP" width="2880" height="2160" data-path="product-assets/abe06bb28a-653b8ca2a8195.webp" />

*Fornecer opções de botão para canais de recebimento de mensagens OTP*

## Verifique se o usuário tem o WhatsApp instalado

Para melhorar a experiência do usuário e usar o WhatsApp como padrão, você pode determinar se o usuário tem o aplicativo WhatsApp instalado no mesmo dispositivo em que seu aplicativo é executado. Aqui está um exemplo de implementação para a detecção do WhatsApp no 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)
}
```

## Perguntas e respostas

<Accordion title="Por que o WhatsApp é um bom canal para entrega de OTP?">
  Nos últimos anos, testemunhamos a ascensão de um novo canal de mensagens: o WhatsApp. Ele tem mais de 2 bilhões de usuários em 180 países e está se espalhando rapidamente por diversos países. Cada usuário do WhatsApp é identificado pelo número de telefone único fornecido ao criar uma conta do WhatsApp, o que significa que o WhatsApp pode substituir diretamente o SMS em todos os casos de uso de verificação, incluindo registro, login e transações.
</Accordion>

<Accordion title="Como funciona a verificação por WhatsApp?">
  Se você está familiarizado com a API de verificação usada para enviar OTP por SMS, basta alterar o parâmetro de canal obrigatório de SMS para WhatsApp na requisição da API. Assim como o SMS, a mensagem de modelo OTP previamente aprovada é enviada por um número de telefone compartilhado mantido pelo YCloud.
</Accordion>

<Accordion title="Posso usar minha marca e número de telefone para enviar mensagens de OTP do WhatsApp em vez de usar o &#x22;remetente genérico&#x22; do YCloud?">
  Atualmente, não é possível definir sua marca e número de telefone como remetente. No entanto, o nome da sua marca será incluído no corpo da mensagem do WhatsApp. Usar o remetente genérico do WhatsApp do YCloud para verificação tem como um dos principais benefícios a possibilidade de usar o número compartilhado do WhatsApp do YCloud. Isso oferece as seguintes vantagens:

  * Começar desde o início com o limite de volume de mensagens mais alto
  * Evitar possíveis obstáculos nas políticas de negócios do WhatsApp, como aplicativos de namoro e produtos de criptomoedas. No entanto, você ainda precisa cumprir a política de uso aceitável do YCloud.
</Accordion>

<Accordion title="Qual produto YCloud devo usar: a API do WhatsApp de Verificação ou a API de Mensagens Programáveis do WhatsApp?">
  Se seu caso de uso é a entrega de OTP, recomendamos fortemente o uso da API do WhatsApp de Verificação do YCloud, pois é a solução construída especificamente para isso. Se você quiser desenvolver casos de uso de mensagens mais personalizadas usando o WhatsApp, pode escolher a [API de Mensagens Programáveis do WhatsApp](/api-reference/whatsapp-messages/enqueue-a-message).
</Accordion>


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