# Client database transfer ### How to upload client from a file Client transfer is possible from Telegram, Viber, WhatsApp, and Email. Clients from Instagram can only be uploaded to a list from a file within the same project. You can also upload all Instagram clients with whom you have had a conversation. Uploading can be done via the button in the "Channels" section. To upload clients, go to the "Channels" section:

Next, select the required messenger (highlighted in the screenshot below).

Add a bot if it’s not yet connected to the project. Then click the "Upload client list" button:

Here you can upload a CSV file and immediately add the clients to a list for easier management later:

{% hint style="warning" %} Important! When uploading a file, you need to specify the correct encoding and delimiter. By default, the settings are configured for files saved in Excel. {% endhint %} {% hint style="info" %} Detailed information about the data format is provided on the form, along with specific requirements for each messenger. {% endhint %} {% hint style="warning" %} Important! A file MUST have column headers when uploading. If the column headers are missing in the document, the file with variables will not upload correctly, and the upload will fail (see example below). {% endhint %}

Possible errors when uploading clients from a file If younotice this error while uploading clients, it’s likely that some columns miss their headers. Please check and make sure all columns have them.

### Adding to a list You can add the uploaded clients to one or more lists right away for segmentation purposes.

### Variables transfer The first column contains a messenger identifier, and the second column contains a client’s name. Data from the other columns will be saved as client variables, with variable names taken from the column headers in the first row.
Variables will be uploaded automatically. ## Client upload details Clients are linked to a specific messenger, meaning subscribers from one Telegram bot cannot be uploaded to another. **Telegram** In Telegram -> platform\_id - is a number. **Viber** In viber platform\_id - is a row, 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. During upload, it will be automatically converted to the required format. {% hint style="info" %} Important! If you plan to send messages to a list of phone numbers, please upload the numbers to the client list before creating the mailing. {% endhint %} ### Video tutorial {% embed url="" %} --- # 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/how-to-do.../client-database-transfer.md?ask= ``` 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.