# Registrar números de telefone para o WhatsApp

Para que um cliente receba mensagens do WhatsApp, ele deve ter um número de telefone válido e estar registrado como assinante da plataforma WhatsApp no Pushwoosh.

Além disso, o WhatsApp exige que as empresas obtenham o consentimento (opt-in) dos clientes antes de enviar mensagens para eles. Para diretrizes sobre como obter consentimento, consulte as [Melhores Práticas de Opt-In do WhatsApp](https://business.whatsapp.com/policy#best_practices).

## Métodos para registrar assinantes do WhatsApp
<Aside type="caution" icon="setting" title="Necessária a ajuda de um desenvolvedor">
****
 Você precisará da ajuda da sua equipe de desenvolvimento para registrar contatos do WhatsApp usando o SDK e a API da Pushwoosh. Certifique-se de compartilhar os links abaixo com eles para orientações detalhadas.
</Aside>

Existem três métodos principais para registrar números de telefone como assinantes do WhatsApp:

* Usando o SDK da Pushwoosh. [Saiba mais](/pt/developer/first-steps/subscribe-users#register-a-whatsapp-number)

* Usando a API da Pushwoosh. [Saiba mais](/pt/developer/first-steps/subscribe-users#whatsapp)

* Importando contatos do WhatsApp de um arquivo CSV

## Como importar contatos do WhatsApp de um arquivo CSV

Para importar contatos do WhatsApp, carregue um arquivo CSV contendo a lista de contatos. Os números importados serão registrados como assinantes do WhatsApp, permitindo mensagens personalizadas e segmentação de público.

### Prepare seu arquivo CSV

#### Regras de formatação de CSV

##### Estrutura geral
- A primeira linha deve conter os cabeçalhos das colunas descrevendo os dados em cada coluna.
- Cada linha subsequente representa um único contato, com valores correspondentes aos cabeçalhos.
- Os valores devem ser separados por vírgulas.
- Salve o arquivo com codificação UTF-8 para garantir a exibição correta dos caracteres.
- O tamanho máximo permitido do arquivo é de 100 MB.

##### Colunas obrigatórias
- **Número de Telefone** – Deve estar no formato [**E.164**](https://en.wikipedia.org/wiki/e.164), incluindo o sinal `+` e o código do país.
- **ID do Usuário** – Um identificador único para o usuário (por exemplo, nome ou e-mail).

<Aside type="note">
****
Os nomes das colunas no seu arquivo CSV não precisam corresponder exatamente a estes. Durante o processo de importação, você pode mapear os nomes das colunas existentes para os campos corretos no sistema. Por exemplo, se o seu arquivo CSV tiver uma coluna chamada *Celular* em vez de *Número de Telefone*, você pode atribuí-la manualmente ao campo **Número de Telefone** ao importar.
</Aside> 


##### Colunas opcionais
Adicionar colunas opcionais permite uma segmentação e personalização mais avançadas em suas campanhas do WhatsApp.

- **Nome** – Primeiro nome ou nome completo do usuário.
- **Localização** – Especifica a cidade, estado ou país do usuário. Útil para enviar promoções baseadas na localização (por exemplo, *Obtenha 20% de desconto em nossa loja de São Paulo hoje!*).
- **Aniversário** – Permite o envio de mensagens de aniversário com descontos especiais (por exemplo, *Feliz Aniversário, Sarah! Aqui está um desconto de 10% só para você!*). Pode acionar campanhas de aniversário automatizadas.
- **Idioma** – Armazena a preferência de idioma do usuário (por exemplo, Inglês, Espanhol, Francês). Ajuda a enviar mensagens no idioma do destinatário para um melhor engajamento.
- **Tipo de Cliente** – Identifica se o usuário é um **novo cliente, VIP ou inativo**. Permite mensagens direcionadas (por exemplo, *Oferta VIP exclusiva só para você!*).
- **Tags Personalizadas** – Quaisquer dados adicionais relevantes para sua campanha (por exemplo, preferências do usuário, histórico de compras). Elas podem ser mapeadas para tags do sistema e usadas para segmentação no Pushwoosh.

##### Exemplo de arquivo CSV

Aqui está um exemplo de um arquivo CSV formatado corretamente:

```csv
Phone Number,User ID,Name,Location  
+1XXXXXXXXXX,john.doe@email.com,John Doe,New York  
+1XXXXXXXXXX,jane.smith@email.com,Jane Smith,Los Angeles  
```

### Carregar o arquivo CSV

1. Vá para **Campanhas** > **Mensagens do WhatsApp** > **Carregar contatos**.

![Carregar contatos do WhatsApp](/whatsapp-messages-register-phone-numbers-for-whatsapp.webp)

Alternativamente, vá para **Público > Importar CSV > Importar contatos do WhatsApp > Carregar CSV**.

<img src="/whatsapp-messages-register-phone-numbers-for-whatsapp-1.webp" alt="Caminho alternativo para carregar contatos do WhatsApp"/>

2. Selecione seu arquivo CSV do seu computador.

3. Mapeie as colunas:
* **Coluna de Contato do WhatsApp no CSV:** Escolha a coluna que contém os números de telefone formatados como `whatsapp:+`.
* **Coluna de ID do Usuário no CSV:** Selecione a coluna com identificadores únicos de usuário (por exemplo, e-mail ou nome).

4. Adicionar dados adicionais (opcional)

   Se você quiser incluir detalhes extras para segmentação:

* Selecione um **Nome da Coluna** do seu CSV.
* Atribua uma **Tag** para vinculá-la aos dados do usuário no sistema.
* Clique em **\+ Adicionar Coluna** para incluir mais atributos.
4\. Clique em **Iniciar Importação** para começar a processar o arquivo.

<img src="/whatsapp-messages-register-phone-numbers-for-whatsapp-2.webp" alt="Mapeamento de colunas e importação de arquivo CSV"/>

Assim que a importação do CSV for concluída, os contatos aparecerão como um novo segmento na [lista de Segmentos](/pt/product/audience-data-and-segmentation/segmentation/) e também estarão disponíveis no [Explorador de Usuários](/pt/product/audience-data-and-segmentation/user-explorer/).

Você pode então usar esses dados para criar campanhas do WhatsApp segmentadas e personalizadas.

<LinkCard title="Saiba mais sobre o envio de mensagens do WhatsApp" href="/product/messaging-channels/whatsapp-messages/send-whatsapp-messages" />