# Transferência da base de clientes

### Como Fazer Upload de Clientes via Arquivo

A transferência de clientes está disponível a partir de Telegram, Facebook, Viber, Instagram, WhatsApp e Email

Clientes do Instagram só podem ser enviados para uma lista a partir de um arquivo dentro do mesmo projeto. Você também pode enviar todos os clientes do Instagram com quem já teve uma conversa. O envio é feito pelo botão na seção “Canais”.

Para enviar clientes, vá para a seção “Mensageiros”:

<figure><img src="/files/b7ad7ee5a7cddbde98283c9d15d4fbb4b4990ad8" alt=""><figcaption></figcaption></figure>

Em seguida, selecione o mensageiro desejado (destacado na captura de tela abaixo):

<figure><img src="/files/5c53d8a88a648fad84020f43ad6d137825dd5617" alt="" width="563"><figcaption></figcaption></figure>

Adicione o bot se ele ainda não estiver conectado ao projeto. Depois clique no botão “Upload da Lista de Clientes”:

<figure><img src="/files/5d6ca7c8d29aa758fab4513c104f1d338d320393" alt=""><figcaption></figcaption></figure>

Em seguida, no formulário aberto, você pode enviar um arquivo CSV e adicionar imediatamente os clientes a uma Lista para uso mais conveniente depois:

<figure><img src="/files/192a762ce447e1403494a6c9e59bb701c8a53e3a" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
Atenção!&#x20;

Ao enviar um arquivo, é necessário especificar a codificação e o delimitador corretos nele. Por padrão, as configurações são definidas para arquivos salvos no Excel.
{% endhint %}

{% hint style="info" %}
Informações detalhadas sobre o formato dos dados são fornecidas no formulário, que também destaca recursos específicos de cada mensageiro.
{% endhint %}

{% hint style="warning" %}
Atenção!&#x20;

O arquivo DEVE incluir nomes de colunas no envio. Se o documento não tiver nomes de colunas, o arquivo contendo variáveis não será enviado, e o envio falhará (veja o exemplo abaixo).
{% endhint %}

<figure><img src="/files/096744c8c3df0d560cfef8bfc1467f573d008462" alt=""><figcaption><p>Nomes das colunas no arquivo</p></figcaption></figure>

### Possíveis Erros ao Enviar Clientes via Arquivo

Se você encontrar um erro ao enviar clientes, é provável que nem todas as colunas tenham nomes. Você precisa verificar isso e fornecer nomes para as colunas.

<figure><img src="/files/0a2332e66a2f8c9ee313b235fdf575f83e31a4d5" alt=""><figcaption></figcaption></figure>

### Adicionando a uma Lista

Você pode adicionar os clientes enviados diretamente a uma ou mais listas para segmentação.

<figure><img src="/files/9e9eeaec03b89e76352a0492168e8aa4a6f3500b" alt=""><figcaption></figcaption></figure>

### Mapeamento de Variáveis

A primeira coluna deve conter o identificador do mensageiro, e a segunda coluna deve conter o nome do cliente. Todos os dados das outras colunas serão registrados como variáveis do cliente. Os nomes das variáveis são obtidos dos cabeçalhos das colunas, que devem ser colocados na primeira linha.

O envio de variáveis ocorrerá automaticamente.

## Recursos de Upload de Clientes

Os clientes estão vinculados a um mensageiro específico, o que significa que assinantes de um bot do Telegram não podem ser enviados para outro.

**Telegram**

No Telegram -> platform\_id - é um número.

**Viber**

No Viber, platform\_id - é uma string composta por letras e números, terminando com dois sinais de igual.

**WhatsApp**

Este é o único mensageiro em que os clientes não estão vinculados a um bot, e você pode enviá-los simplesmente como uma lista de números de telefone. O formato do número de telefone é flexível — ele será convertido automaticamente para o formato necessário durante o envio.

Atenção! Se você planeja enviar uma transmissão de mensagens para um banco de dados de números de telefone, primeiro você deve enviar os números para a lista de clientes e só depois criar a transmissão.

### Videoguia:&#x20;

{% embed url="<https://www.youtube.com/watch?ab_channel=Salebot-%D0%9A%D0%BE%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%82%D0%BE%D1%80%D1%87%D0%B0%D1%82%D0%B1%D0%BE%D1%82%D0%BE%D0%B2&v=9a7P4G_aBxM>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/envios-empresariais/transferencia-da-base-de-clientes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
