# Importar contatos de SMS

Você pode fazer o upload de um arquivo CSV para importar números de telefone em massa. Os números importados serão registrados como assinantes de SMS, permitindo que você personalize e segmente suas comunicações por SMS.

## 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 a codificação UTF-8 para garantir a exibição correta dos caracteres.
*   O tamanho máximo do arquivo é de 100 MB.

#### Colunas obrigatórias

*   **Número de telefone**: Deve estar no formato internacional, começando com `+` seguido pelo código do país, por exemplo, *+120XXXXX234*
*   **ID do Usuário**: O identificador único do 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

A inclusão de colunas opcionais permite uma segmentação e personalização mais avançadas em suas campanhas de SMS. Abaixo estão os campos opcionais que você pode adicionar e como eles podem ser usados:

*   **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 Los Angeles 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 o envio de mensagens direcionadas (por exemplo, *Oferta VIP exclusiva só para você!*).

Você pode adicionar quaisquer dados adicionais relevantes para sua campanha (por exemplo, preferências do usuário, histórico de compras). Eles podem ser mapeados para tags do sistema e usados 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  
+120XXXXX234,john.smith@email.com,John Smith,New York  
+131XXXXX890,jane.smith@email.com,Jane Smith,Los Angeles  
```

## Faça o upload do arquivo CSV

1.  Navegue para **Público → Importar CSV → Importar Contatos de SMS.**

![Captura de tela mostrando o menu Público com as opções Importar CSV e Importar Contatos de SMS](/import-sms-contacts-1.webp)

2.  Clique em **Fazer upload de CSV** e selecione seu arquivo.

![Captura de tela mostrando o botão Fazer upload de CSV e a interface de seleção de arquivos](/import-sms-contacts-2.webp)

Se precisar fazer o upload de um arquivo diferente, clique em **Fazer upload de outro CSV** para substituí-lo.

3.  Mapeie as colunas

Certifique-se de que as colunas corretas estão selecionadas:

*   **Coluna de Número de Telefone no CSV**. Selecione a coluna que contém os números de telefone (deve estar no formato internacional, começando com `+`).
*   **Coluna de ID do Usuário no CSV**. Selecione a coluna que contém os identificadores únicos de usuário.

4.  Adicione dados adicionais (opcional)

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

*   Selecione um nome de 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.

![Captura de tela mostrando a interface de mapeamento de colunas com opções de número de telefone, ID do usuário e atribuição de tags](/import-sms-contacts-3.webp)

5.  Clique em **Iniciar importação** para começar a processar o arquivo.

Após a importação, os contatos estarão disponíveis para campanhas de SMS no Pushwoosh. Eles aparecerão como um novo segmento na [lista de Segmentos](/pt/product/audience-data-and-segmentation/segmentation/) e também podem ser acessados através do [User explorer](/pt/product/audience-data-and-segmentation/user-explorer/).