> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salvy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução a números virtuais

<Warning>Para utilizar nossas APIs e Webhooks de linhas virtuais, é necessário aderir ao nosso [manual de branding](/api-reference/branding)</Warning>

A Salvy oferece um produto de números virtuais, fornecidos por API.

Números virtuais (DID) são linhas telefônicas que não estão vinculadas a um chip.

A solução é ideal para empresas que necessitam de um número para ativar em ferramentas como Meta WhatsApp API.

Como os números virtuais móveis da Salvy **possuem suporte a SMS via webhook**, a autenticação em plataformas como o WhatsApp API pode ser feita diretamente por mensagem de texto. Nesse modelo, o número virtual recebe o SMS de validação, e o conteúdo da mensagem é entregue em tempo real para a sua aplicação por meio de um webhook configurado na API da Salvy.

Importante:
Para autenticar suas requisições, crie uma chave de API na página de [Chaves de API](/api-reference/api-keys).

## Recomendações importantes:

1. **O número virtual não é recomendado para utilização no WhatsApp Business do Celular**: a Meta possui controles que podem bloquear a ativação, principalmente em dispositivos Android.
2. **Sempre consulte a lista de DDDs** disponíveis antes de solicitar a criação de um número virtual. A disponibilidade de códigos de área (DDDs) pode variar ao longo do tempo. Recomendamos que você utilize o endpoint de [listagem de DDDs disponíveis](/api-reference/virtual-phone-accounts/list-area-codes) e apresente as opções disponíveis para o usuário final antes de tentar criar um número virtual. Isso garante uma melhor experiência e evita erros ao tentar adquirir um número em uma área indisponível.
3. **Os números são contabilizados na fatura a partir da ativação**: qualquer número ativado será cobrado no início do mês.
4. **Números cancelados são cobrados em sua totalidade**: se um número virtual ativado for cancelado, ele será cobrado em sua totalidade, independentemente da data de cancelamento. Exemplo: se um número de teste for ativado e cancelado no mesmo dia, o valor será cobrado em sua totalidade na fatura. Para evitar cobranças desnecessárias, recomendamos que você reutilize números sempre que possível.

## Como configurar o WhatsApp utilizando um número virtual móvel da Salvy:

1. **Consulte os DDDs disponíveis**: utilize o [endpoint de listagem de DDDs](/api-reference/virtual-phone-accounts/list-area-codes) para verificar quais códigos de área estão disponíveis no momento;
2. **Adquira o número virtual móvel**: utilizando a API da Salvy, informe o código de área desejado (DDD) a partir da lista de disponíveis, por exemplo: 11;
3. **Configure o [webhook](/api-reference/webhooks/introduction) de SMS recebido**: registre na API da Salvy a URL que receberá as mensagens SMS destinadas ao número virtual;
4. **Escolha a autenticação via SMS**: no cadastro do WhatsApp, insira o número virtual da Salvy e selecione o método de verificação por SMS;
5. **Receba o código de verificação**: a mensagem com o código de confirmação será enviada para o número virtual e entregue ao seu sistema via webhook;
6. **Finalize a configuração**: utilize o código recebido para concluir o processo de verificação no WhatsApp.