> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ukrgsm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Контакти й керування кампанією

> Як завантажити список номерів, оновити його пізніше та призупинити чи перезапустити обдзвін — покроково, простими словами.

Ця сторінка — коротка інструкція без технічних термінів: як завантажити номери телефонів для обдзвону, як їх оновити пізніше і як зупинити чи почати обдзвін заново.

## Файл з номерами

Список контактів — це звичайна таблиця, збережена у форматі CSV (таку таблицю можна зробити в Excel або Google Таблицях і зберегти як CSV-файл).

Обовʼязкова одна колонка — `phone_number`. Будь-які інші колонки можна додавати вільно — це дані про клієнта (імʼя, сума боргу, номер рахунку тощо), які потім підставляються в розмову агента.

Приклад файлу:

| phone\_number | customer\_name | debt\_words  |
| ------------- | -------------- | ------------ |
| 380501234567  | Олена Іваненко | 6539 гривень |
| 380671234567  | Ігор Петренко  | 1200 гривень |

**Номер телефону** має складатися рівно з 12 цифр, без знака `+` і без пробілів чи дефісів. Наприклад, `380501234567` — правильно, а `+380 50 123 45 67` — ні.

## Завантажити номери вперше

1. Створіть кампанію та оберіть свого агента.
2. Натисніть **«Завантажити CSV-файл»** і оберіть підготовлений файл.
3. Перевірте, що всі номери у форматі, описаному вище — якщо ні, платформа покаже, у яких саме рядках проблема, і не дасть продовжити, доки файл не виправите.
4. Натисніть **«Запустити кампанію»** — обдзвін почнеться одразу.

## Оновити список контактів

Кнопка **«Оновити контакти»** зʼявляється, коли кампанія **призупинена** або **завершена** (поки кампанія активно дзвонить — оновити список не можна, спершу призупиніть її).

1. Натисніть **«Оновити контакти»**.
2. Завантажте новий CSV-файл.
3. Натисніть **«Оновити контакти»** у вікні, що зʼявилося.

Що відбувається:

* номери, яких раніше не було — додаються;
* дані по вже наявних номерах (імʼя, сума тощо) — оновлюються на нові;
* номери, дзвінок на які вже відбувся — не змінюються, історія дзвінка зберігається;
* якщо номер просто відсутній у новому файлі — його ніхто не видаляє, він і далі лишається в кампанії.

### Як назавжди прибрати номер з обдзвону

Якщо потрібно, щоб на якийсь номер більше ніколи не дзвонили (наприклад, клієнт попросив), додайте до файлу ще одну колонку — `close_contact` — і навпроти цього номера напишіть слово `close`.

| phone\_number | customer\_name | close\_contact |
| ------------- | -------------- | -------------- |
| 380501234567  | Олена Іваненко | close          |

Такий номер лишається в кампанії для статистики, але дзвінків на нього більше не буде — навіть після перезапуску кампанії.

Щоб знову дозволити дзвонити на такий номер — завантажте файл ще раз і навпроти нього напишіть `activate` замість `close`.

Колонка `close_contact` не обовʼязкова — якщо вона не потрібна, файл можна завантажувати й без неї, як завжди.

## Призупинити кампанію

Натисніть **«Призупинити кампанію»**. Дзвінок, що триває саме зараз, завершиться нормально, а нові дзвінки більше не почнуться, доки кампанію не відновити.

Щоб продовжити — натисніть **«Відновити кампанію»**. Обдзвін продовжиться з того самого місця, без втрати прогресу.

## Перезапустити кампанію

Кнопка **«Перезапустити кампанію»** — це «продзвонити всіх ще раз». На відміну від звичайного оновлення контактів, вона повертає в чергу навіть ті номери, на які вже дзвонили раніше. Корисно для щоденних чи повторюваних обдзвонів одного й того ж списку.

Доступна, коли кампанія **призупинена** або **завершена**.

1. Натисніть **«Перезапустити кампанію»**.
2. За бажанням — завантажте новий CSV-файл (можна й не завантажувати, тоді передзвонить за поточним списком).
3. Підтвердіть.

Номери, які раніше закрили через `close_contact=close`, перезапуск не зачіпає — вони й далі лишаються поза обдзвоном, доки їх не активують вручну.

Після перезапуску кампанія стає **призупиненою** — натисніть **«Відновити кампанію»**, щоб дзвінки почались.