# Customer Base Transfer

### How to Upload Clients via File

Client transfer is available from Telegram, Facebook, Viber, Instagram WhatsApp, and Email

Instagram clients can only be uploaded to a list from a file within the same project. You can also upload all Instagram clients you have had a conversation with. The upload is done via the button in the “Channels” section.

To upload clients, go to the “Messengers” section:

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

Next, select the desired messenger (highlighted in the screenshot below):

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

Add the bot if it’s not yet connected to the project. Then click the “Upload Client List” button:

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

Next, in the opened form, you can upload a CSV file and immediately add the clients to a List for more convenient use later:

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

{% hint style="warning" %}
Attention!&#x20;

When uploading a file, you need to specify the correct encoding and delimiter in it. By default, the settings are configured for files saved in Excel.
{% endhint %}

{% hint style="info" %}
Detailed information about the data format is provided in the form, which also highlights features specific to each messenger.
{% endhint %}

{% hint style="warning" %}
Attention!&#x20;

The file MUST include column names upon upload. If the document does not have column names, the file containing variables will not be uploaded, and the upload will fail (see example below).
{% endhint %}

<figure><img src="/files/qbbcqaaaRQ3CHBM2HEfA" alt=""><figcaption><p>Column names in the file</p></figcaption></figure>

### Possible Errors When Uploading Clients via File

If you encounter an error while uploading clients, it is likely that not all columns have names. You need to check this and provide names for the columns.

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

### Adding to a List

You can add the uploaded clients directly to one or more lists for segmentation.

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

### Mapping Variables

The first column should contain the messenger identifier, and the second column should contain the client’s name. All other column data will be recorded as client variables. Variable names are taken from the column headers, which should be placed in the first row.

Variable upload will occur automatically.

## Client Upload Features

Clients are linked to a specific messenger, meaning that subscribers from one Telegram bot cannot be uploaded to another.

**Телеграм**

В Telegram -> platform\_id - is a number.

**Viber**

In Viber platform\_id - is a string consisting of letters and numbers, ending with two equal signs.

**Whatsapp**

This is the only messenger where clients are not tied to a bot, and you can upload them simply as a list of phone numbers. The phone number format is flexible — it will be automatically converted to the required format during upload.

Attention! If you plan to send a message broadcast to a database of phone numbers, you must first upload the numbers to the client list and only then create the broadcast.

### Videoguide:&#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/business-mailings/customer-base-transfer.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.
