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

Підрозділ Список контактів призначений для створення контактів, по яким необхідно зробити вихідні інтеракції.

По кожному контакту можуть бути вказані різні канали звязку, наприклад, декілька телефонів, електронних адрес, месенджерів тощо. 

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

1. Назва списку контактів
2. Всього: кількість контактів у списку
3. Доступні: контакти, які придатні для здійсненні вихідної активності
4. Плануються: контакти, які відібрано для обробки Дайлером і по яким планується вихідна інтеракція
5. Відкриті: контакти, по яким успішно було здійснено вихідну активність і які знаходяться в незавершеному статусі (очікують відповіді клієнта або опрацьовуються чат-ботом/оператором)
6. Досягнено спроб: контакти, по яким досягнено максимальної кількості спроб&#x20;
7. Позначені: контакти, по яким немає одиниць звязку (номерів телефону, ел. пошти, тощо) придатних для здійснення вихідних активностей з відповідним типом розмови
8. Закриті: контакти, по яким успішно було здійснено вихідну активність і які завершені
9. Статус кампанії: активна чи завершена. Для запуску кампанії необхідно перевести&#x20;

***

## Створення/Редагування Списку Контактів <a href="#create-edit-a-contact-list" id="create-edit-a-contact-list"></a>

**При створенні списку контактів необхідно вказати наступні параметри:**

<figure><img src="/files/26h0Tn8aDYloyxpDMO8t" alt=""><figcaption></figcaption></figure>

1. Назва списку контактів
2. Метод вибору контактів для загрузки. Контакти можна обрати з наявних розмов NovaTalks або загрузити у вигляді файлу.

**Для Методу вибору = Обрати наявні розмови необхідно вказати наступні параметри:**

1. Критерії для вибору розмов NovaTalks.&#x20;
2. Зразок - таблиця зі списком знайдених розмов та їх параметрів. Вона відображається, якщо по створеному фільтру в системі було знайдено хоча б 1 розмову. Зразок необхідний, щоб переконатись чи правильно налаштовано вибірку.
3. Закрити, якщо успішно опрацьовано всі типи розмов. Якщо параметр ввімкнено, то контакт успішно закриється, якщо по усім типам розмови (соцмережі, електронна пошта, дзвінки) було успішно здійснено вихідну активність. Якщо вимкнено – контакт успішно закриється, якщо хоча б по одному типу розмови було успішно здійснено вихідну активність.

{% hint style="info" %}
Дана опція використовується, якщо вам необхідно зв'язатись з контактом по усім каналам, наприклад в месенджері і по електронній пошті.&#x20;
{% endhint %}

4. Автоматично додавати нові розмови. Якщо параметр ввімкнено, система буде автоматично додавати нові розмови, які підпадають під критерії фільтру з заданою періодичністю.

{% hint style="info" %}
Наприклад, ви створили живу кампанію, яка завжди ввімкнена та відправляє клієнтам, які купили товар, повідомлення з промокодом на знижку на наступну покупку.&#x20;
{% endhint %}

5. Періодичність, з якою необхідно автоматично підгружати нові розмови в список контактів, які відповідають заданому фільтру. Значення за замовчуванням – кожен день о 00:00

**Для Методу вибору = Обрати наявні розмови необхідно вказати наступні параметри:**<br>

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

1. Файл з контактами для загрузки. Формат - csv (розділювач - кома), де перший рядок - назви колонок, всі наступні - контакти та їх дані. При редагуванні контактного листа через це поле можна підгружати додаткові дані. Формат вихідного файлу і файлу підгрузки повинен бути однаковий.

{% hint style="success" %}
Приклад:

id,email,full\_name,debt&#x20;

1,<stonadya@ukr.net>,nadya,75.25&#x20;

2,<nadiia@com.ua>,nadiia,150.5&#x20;

3,<cristina@com.ua>,cristina,225.75
{% endhint %}

2. Зразок - таблиця зі списком данних загружених з файлу.
3. Контактні колонки - це контактні дані, по яким необхідно звязатись к клієнтом - наприклад, номери телефону, електронна адреса, ідентифікатор розмов з NovaTalks тощо. Контакт може мати декілька контактних данних. В такому випадку система буде намагатись звязатись з контактом по кожній одиниці звязку.&#x20;

По одниці зв'язку необхідно обрати її тип та канал, з якого буде здійснюватись вихідна активність.

{% hint style="info" %}
Для типу ідентифікатор розмови канал вказувати не потрібно. Система автоматично його визначить.
{% endhint %}

4. Закрити, якщо успішно опрацьовано всі типи розмов. Якщо параметр ввімкнено, то контакт успішно закриється, якщо по усім типам розмови (соцмережі, електронна пошта, дзвінки) було успішно здійснено вихідну активність. Якщо вимкнено – контакт успішно закриється, якщо хоча б по одному типу розмови було успішно здійснено вихідну активність.

{% hint style="info" %}
Дана опція використовується, якщо вам необхідно звязатись з контактом по усім каналам, наприклад в месенджері і по електронній пошті.
{% endhint %}

5. Унікальний ідентифікатор - поле для вибору колонки, яка слугуватиме унікальним ідентифікатором. Якщо нічого не обрати, система підставить номер по-порядку.
6. Ім'я контакту - поле для вибору колонки, яка слугуватиме ім'ям контакту, якщо в системі не буде знайдено існуючий контакт. Тоді система створить новий контакт, використовуючи ім'я з колонки.

### Опис даних Сontact List та Contact List Detail

**Contact List**– це таблиця з контактами, де 1 рядок=1 контакт, яка містить інформацію по статусу та спробах outgoing interaction по кожному conversation type та загалом по контакту, а також може містити додаткову інформацію по контакту для наступного використання при здійсненні та опрацюванні outgoing interaction.

<table><thead><tr><th width="204.4000244140625">Назва поля</th><th>Опис</th></tr></thead><tbody><tr><td>sys_id</td><td><p>Унікальний ідентифікатор контакту. Заповнюється системою автоматично, в залежності від налаштувань, такими даними:</p><p>1. Contact ID клієнта з NovaTalks - якщо [Contact List Settings] Selection method = Select existing Conversations<br>2. Номером по порядку - якщо [Contact List Settings] Selection method = Upload file &#x26;&#x26; [Contact List Settings] Unique Identifier Column не заповнено<br>3. Даними з поля визначеного користувачем - якщо [Contact List Settings] Selection method = Upload file &#x26;&#x26;  [Contact List Settings] Unique Identifier Column заповнено, то дані з цього поля записуються в sys_id. Якщо в полі існують неунікальні значення, то необхідно зберегти тільки перший контакт з таким id, всі інші видалити. Якщо в полі існують пусті значення – видалити такі рядки</p></td></tr><tr><td>sys_status</td><td>Статус контакту</td></tr><tr><td>sys_attempts</td><td>Кількість разів Dialer здійснював outgoing interaction по контакту</td></tr><tr><td>sys_status_call</td><td>Статус відповідного conversation type контакту</td></tr><tr><td>sys _attempts_call</td><td>Кількість разів Dialer здійснював outgoing interaction по conversation_type=call</td></tr><tr><td>sys _attempts_email</td><td>Кількість разів Dialer здійснював outgoing interaction по conversation_type= email</td></tr><tr><td>sys _attempts_social_media</td><td>Кількість разів Dialer здійснював outgoing interaction по conversation_type= social_media</td></tr><tr><td>sys_created_at</td><td>Дата та час створення запису</td></tr><tr><td>sys_updated_at</td><td>Дата та час оновлення запису</td></tr><tr><td>sys_last_attempt_cld_id</td><td>Id запису з Contact List Detail, який відповідає даному контакту, по якому була остання спроба outgoing interaction</td></tr><tr><td><em>Поля створені користувачем (якщо існують)</em></td><td></td></tr></tbody></table>

Поле **sys\_status** може приймати значення, наведені в таблиці:

<table><thead><tr><th width="95.39996337890625">Status</th><th width="208.4000244140625">Short Description</th><th>Description</th></tr></thead><tbody><tr><td>I</td><td>in progress</td><td>Dialer взяв запис з Contact List Detail по даному контакту для здійснення outgoing interaction</td></tr><tr><td>A</td><td>reached max attempts per contact</td><td>По контакту досягнуто максимальної кількості спроб Max Attempts Per Contact.</td></tr><tr><td>U</td><td>uncallable</td><td>Непридатний для здійснення outgoing interaction. Такий статус призначається, коли контакт було успішно опрацьовано.</td></tr><tr><td>C</td><td>callable</td><td>Контакт придатний для здійснення outgoing interaction.</td></tr><tr><td>Q</td><td>queued</td><td>Dialer успішно здійснив outgoing interaction та передав Campaign Manager для подальшого опрацювання</td></tr><tr><td>F</td><td>no callable records in Contact List Detail</td><td>В Contact List Detail по контакту немає записів придатних для здійснення outgoing interaction</td></tr></tbody></table>

Поля sys\_status\_email та sys\_status\_social\_media може приймати значення, наведені в таблиці:

<table><thead><tr><th width="95.39996337890625">Status</th><th width="208.4000244140625">Short Description</th><th>Description</th></tr></thead><tbody><tr><td>I</td><td>in progress</td><td>Dialer взяв запис з Contact List Detail по відповідному conversation type контакту для здійснення outgoing interaction</td></tr><tr><td>A</td><td>reached max attempts per contact</td><td>По відповідному conversation type контакту досягнуто максимальної кількості спроб Max Attempts Per .</td></tr><tr><td>U</td><td>uncallable</td><td>Непридатний для здійснення outgoing interaction. Такий статус призначається, коли контакт по відповідному conversation type було успішно опрацьовано.</td></tr><tr><td>C</td><td>callable</td><td>Контакт по відповідному conversation type придатний для здійснення outgoing interaction.</td></tr><tr><td>Q</td><td>queued</td><td>Dialer успішно додзвонився по відповідному conversation type та передав Campaign Manager для подальшого опрацювання</td></tr><tr><td>F</td><td>no callable records in Contact List Detail</td><td>В Contact List Detail по контакту немає записів придатних для здійснення outgoing interaction з відповідним conversation_type</td></tr></tbody></table>

**Contact List Detail** – це таблиця, в якій контакт розбивається на окремі рядки, де 1 рядок – 1 одиниця зв’язку контакту (номери телефону, email-и, conversation id, тощо) та містить інформацію по статусу, спробах і інших деталях outgoing interaction.

<table><thead><tr><th width="210.7999267578125">Назва поля</th><th>Опис</th></tr></thead><tbody><tr><td>sys_id</td><td>Унікальний ідентифікатор запису. Заповнюється автоматично номером по порядку.</td></tr><tr><td>sys_contact_id</td><td>id контакту, до якого належить запис (з табл. Contact List sys_id)</td></tr><tr><td>sys_channel_user</td><td><p>одиниця звязку для здійснення outgoing interaction по контакту, де 1 рядок = 1 одиниця звязку контакту. В залежності від налаштувань, заповнюється такими даними:</p><p>1.Conversation ID з NovaTalks - якщо [Contact List Settings] Selection method = Select existing Conversations</p><p>2. Значеннями з колонок файлу, загруженого користувачем. Такі колонки користувач в [Contact List Settings] обирає як contact columns. - якщо [Contact List Settings] Selection method = Upload file</p></td></tr><tr><td>sys_channel_user_type</td><td><p>Тип одиниці звязку. В залежності від налаштувань, заповнюється такими даними:</p><p>1.phone/email/conversation_id/messenger_id/username: підставляється значенням обраним користувачем в [Contact Lists Settings] Type - якщо [Contact List Settings] Selection method = Upload file</p><p>2.conversation_id - якщо [Contact List Settings] Selection method = Select existing Conversations</p></td></tr><tr><td>sys_cl_source_column</td><td><p>Назва колонки з файлу загруженого користувачем , до якого відноситься sys_channel_user:</p><p>1.Заповнюємо назвою відповідної колонки - якщо [Contact List Settings] Selection method = Upload file</p><p>2.conversation_id - якщо [Contact List Settings] Selection method = Select existing Conversations</p></td></tr><tr><td>sys_conversation_type</td><td><p>conversation_type inbox_id, до якого належить sys_channel_user.</p><p>Можливі значення:</p><p>call</p><p>email</p><p>social_media</p></td></tr><tr><td>sys_inbox_id</td><td><p>id каналу, з якого необхідно здійснити outgoing interaction. Визначається в залежності від типу sys_channel_user:</p><p>-         для phone /email/messenger_id/username– підставляється inbox_id обраний користувачем в [Contact Lists Settings].</p><p>-         Для conversation_id – необхідно визначити автоматично, в залежності від conversation_id.</p></td></tr><tr><td>sys_status</td><td>Статус запису</td></tr><tr><td>sys_attempts</td><td>Кількість разів Dialer здійснював outgoing interaction по контакту</td></tr><tr><td>sys_attempts_abandoned</td><td>Кількість разів, коли результатом спроби outgoing interaction був Dialer Attempt Result, в якого Dialer Attempt Category=abandoned</td></tr><tr><td>sys_attempts_busy</td><td>Кількість разів, коли результатом спроби outgoing interaction був Dialer Attempt Result, в якого Dialer Attempt Category=busy</td></tr><tr><td>sys_attempts_noanswer</td><td>Кількість разів, коли результатом спроби outgoing interaction був Dialer Attempt Result, в якого Dialer Attempt Category=noanswer</td></tr><tr><td>sys_attempts_machine</td><td>Кількість разів, коли результатом спроби outgoing interaction був Dialer Attempt Result, в якого Dialer Attempt Category=machine</td></tr><tr><td>sys_scheduled_at</td><td>Дата та час не раніше якої потрібно здійснити повторну outgoing interaction</td></tr><tr><td>sys_created_at</td><td>Дата та час створення запису</td></tr><tr><td>sys_updated_at</td><td>Дата та час оновлення запису</td></tr><tr><td>sys_last_attempt_datetime</td><td>Дата та час ініціації останньої outgoing interaction Dialer-ом по запису</td></tr><tr><td>sys_last_attempt_campaign_id</td><td>Campaign id в рамках якої було ініційовано останню outgoing interaction Dialer-ом по запису</td></tr><tr><td>sys_last_attempt_dialog_id</td><td>Dialog id останньої outgoing interaction по запису</td></tr><tr><td>sys_last_attempt_dialer_attempt_result_id</td><td>Id результату спроби outgoing interaction здійсненої Dialer-ом</td></tr></tbody></table>

Поле **sys\_status** може приймати значення, наведені в таблиці:

<table><thead><tr><th width="103.39996337890625">Status</th><th width="194.7999267578125">Short Description</th><th>Description</th></tr></thead><tbody><tr><td>C</td><td>callable</td><td>Запис придатний для здійснення outgoing interaction</td></tr><tr><td>I</td><td>in progress</td><td>Dialer взяв запис для здійснення outgoing interaction</td></tr><tr><td>A</td><td>reached max attempts per number or recall type</td><td>По запису досягнуто максимальної кількості спроб Max Attempts Per Conversation або Max Attempts Per &#x3C;Recall Type>.</td></tr><tr><td>U</td><td>uncallable</td><td>Непридатний для здійснення outgoing interaction. Такий статус призначається, коли запис було успішно опрацьовано або зєднанано з невірною стороною.</td></tr><tr><td>O</td><td>auto-sheduled callback</td><td>По запису заплановано ще одну outgoing interaction Dialer-ом відповідно до  налаштувань Campaign.</td></tr><tr><td>S</td><td>callback by agent</td><td>По запису заплановано ще одну outgoing interaction Агентом.</td></tr><tr><td>P</td><td>purged</td><td><p>Не знайдено conversation в системі для запису з sys_channel_</p><p>user_type=conversation_id</p></td></tr><tr><td>Q</td><td>queued</td><td>Dialer успішно додзвонився та передав Campaign Manager для подальшого опрацювання</td></tr></tbody></table>


---

# 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://help.novatalks.com.ua/ua/get-started/outgoing-campaigns/lists/contact-list.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.