# Передача бази клієнтів

### Як завантажити клієнтів із файлу

Передача клієнтів можлива з Telegram, Viber, WhatsApp та Email.

Клієнтів з Instagram можна завантажити в список із файлу лише в межах одного й того самого проєкту. Також можна завантажити всіх клієнтів Instagram, з якими ви вели переписку. Завантаження виконується через кнопку в розділі «Канали».

Щоб завантажити клієнтів, перейдіть до розділу «Канали»:

<figure><img src="/files/e8c366f826d92f2a9b2f452b7720f90aa4e4ae04" alt="" width="438"><figcaption></figcaption></figure>

Далі виберіть потрібний месенджер (підсвічено на скріншоті нижче).

<figure><img src="/files/168c6c8a0d5cb48061536bd407d85b8894615080" alt=""><figcaption></figcaption></figure>

Додайте бота, якщо він ще не підключений до проєкту. Потім натисніть кнопку «Завантажити список клієнтів»:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfMZCG6yr41qFSXjL2IFR-GPFp4bRkEE_SZDSGwaoBi8yUXnOp3UfHX1th9qsNaaTO2gWP4QkpEKg5VXuNd_PO-RpViIv4lZTDNCf0pWCqKCnuRgHAGfAL1U_LsSFw-Lm_1EC1xUg?key=o5DRCqMFXEyXeycmGc9MdQ" alt=""><figcaption></figcaption></figure>

Тут ви можете завантажити CSV-файл і одразу додати клієнтів до списку для зручнішого подальшого керування:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfbFaz0hG3MeOua2pAQe7WwNhGAKEZIbQbt3Ge2dvbQOVBN3dCqbKhmwdfG7eRIqv4ooQRtcOCbdbDjjuCjeJ0MX8cAdjxB8vX70TwWQh_-S5M4z24LTlZEB3iNeRvNTvTcrS9h?key=o5DRCqMFXEyXeycmGc9MdQ" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
Важливо!&#x20;

Під час завантаження файлу потрібно вказати правильне кодування та роздільник. За замовчуванням параметри налаштовані для файлів, збережених в Excel.
{% endhint %}

{% hint style="info" %}
Докладна інформація про формат даних наведена у формі разом із конкретними вимогами для кожного месенджера.
{% endhint %}

{% hint style="warning" %}
Важливо!&#x20;

Файл ОБОВ’ЯЗКОВО має містити заголовки стовпців під час завантаження. Якщо в документі відсутні заголовки стовпців, файл із змінними не завантажиться коректно, і завантаження завершиться помилкою (див. приклад нижче).
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfPGraYbeqWfSItBSkDYEgDiSWXaPja3a5yfJM99pASkyp5CQl-YxwPdhnZjXGoLc8mCAMwxE_uWL-3pA3CnT9wxVedeuJpcB75KIR1-pbhnNX2xEXHznNiuTz0KjhYS-v4Kxz0sA?key=o5DRCqMFXEyXeycmGc9MdQ" alt=""><figcaption><p>Назви стовпців у файлі</p></figcaption></figure>

Можливі помилки під час завантаження клієнтів із файлу

Якщо ви помітили цю помилку під час завантаження клієнтів, імовірно, у деяких стовпців відсутні заголовки. Перевірте та переконайтеся, що заголовки є в усіх стовпців.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfIDXClLu2dU9oMDeLvDFdlH2ePhN0UxxHCnOOkP2Yv-0ExZKsTvRSKpe5KKiE4_Okk-35rCl4n4Z6s0Oave5mqMkjl48DGlD33Ad3oZtYJGDuxiclgMDHzMEhd9KsKbCEyO-eSmg?key=o5DRCqMFXEyXeycmGc9MdQ" alt="" width="563"><figcaption></figcaption></figure>

### Додавання до списку

Ви можете одразу додати завантажених клієнтів до одного або кількох списків для сегментації.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc7U3lbE2H1VYic-Rk3_AGaDDBgU_WgRBHTeux6rtMxvrdAoFSVc7tZX7Lgrhf5r_lqnkVIkFFAwRS5FqkSmqJIuMxh_3WcnXm2RhW-Bx3g-5VHcWvDc-7OQa4eEqEv4OTYAq2q?key=o5DRCqMFXEyXeycmGc9MdQ" alt="" width="375"><figcaption></figcaption></figure>

### Передача змінних

Перший стовпець містить ідентифікатор месенджера, а другий стовпець — ім’я клієнта. Дані з інших стовпців будуть збережені як змінні клієнта, а назви змінних будуть взяті із заголовків стовпців у першому рядку. <br>

Змінні буде завантажено автоматично.

## Деталі завантаження клієнтів

Клієнти прив’язані до конкретного месенджера, тобто підписників з одного Telegram-бота не можна завантажити в інший.

**Telegram**

У Telegram -> platform\_id - це число.

**Viber**

У Viber platform\_id - це рядок, що складається з літер і цифр, який закінчується двома знаками рівності.

**WhatsApp**

Це єдиний месенджер, де клієнти не прив’язані до бота, і ви можете завантажити їх просто як список номерів телефонів. Формат номера телефону є гнучким. Під час завантаження він буде автоматично перетворений у потрібний формат.

{% hint style="info" %}
Важливо! Якщо ви плануєте надсилати повідомлення на список номерів телефонів, будь ласка, завантажте номери до списку клієнтів перед створенням розсилки.
{% endhint %}

### Відеоурок&#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/uk/yak-zrobiti.../peredacha-bazi-kliyentiv.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.
