Телефонія
«Телефонія» — дзвінки з робочого телефона компанії без платної АТС: застосунок Helomi на телефоні зливає сюди журнал дзвінків робочої SIM і записи розмов, а розділ показує їх списком зі статистикою, порадами й телефонною книгою. Кожен дзвінок зіставляється з клієнтом нашої CRM і його останньою угодою, а в картку угоди (або клієнта) лягає нотатка про дзвінок.
На цій сторінці
Можливості
- Журнал дзвінків робочої SIM з телефона: вхідні, вихідні, пропущені, з записами розмов; стан передзвону для пропущених.
- Ім'я клієнта, його картка й остання угода в нашій CRM — за номером телефону (телефони клієнта, додаткових контактів, одержувача посилки).
- Нотатка про кожен дзвінок у картці угоди клієнта, а без угоди — у картці клієнта; видно в «Нотатках» і в журналі картки.
- Вкладка «Контакти»: телефонна книга з клієнтів нашої CRM плюс свої записи й зірочки.
- Статистика по днях, годинах, лініях і клієнтах; поради за правилами (не передзвонили, пік дзвінків, короткі розмови).
- Кнопка «Набрати» з комп'ютера — телефон сам починає дзвінок з робочої SIM.
- Дзвінок у клік по всій CRM: номер у картці угоди, клієнта, контакту, у завданнях, «Дашборді продажів», картці колеги в «Структурі» й у «Користувачах» — клік, і ваш робочий телефон сам набирає номер.
- Ломі набирає номер на ваше прохання («набери клієнта угоди 50000375») — з вашого робочого телефона або з лінії, яку назвали.
1Налаштування
Доступ дає адміністратор: «Налаштування» → «Розділи» → «Телефонія». Без доступу розділ не відкривається, а телефон цієї людини не зливає журнал.
Робочі номери: «Телефонія» → «Номери» → «Додати номер» (адміністратор). Прив'яжіть лінію до людини, щоб «Набрати» знав, з якого телефона дзвонити; на телефоні один раз оберіть робочу SIM у розділі «Телефонія».
Нотатки й зіставлення налаштовує адміністратор або людина з доступом «Налаштування CRM» (PUT /api/telephony/settings; форма в інтерфейсі — у черзі робіт):
- «Писати нотатку про дзвінок у картку угоди клієнта» (типово так).
- «Якщо угоди нема — писати в картку клієнта» (так).
- «Писати й про дзвінки без відповіді» (так) — пропущені й «не додзвонилися».
- «Нотатки лише для дзвінків не старших за, днів» (3) — щоб давні дзвінки після дозіставлення не перетирали останню нотатку угоди.
- «Дозіставляти дзвінки без клієнта чи угоди за останні, днів» (14) — замовлення з площадки приходить уже після дзвінка.
Змінили — діє з наступного синку телефона, без перезапуску. Кожна зміна записується в журнал з автором.
2Дзвінки і клієнти
- Відкрийте «Телефонія» на телефоні — застосунок зіллє журнал робочої SIM (повторно можна скільки завгодно, дублів не буде).
- У списку на комп'ютері з'являться дзвінки з ім'ям клієнта і кнопкою угоди. Ім'я береться так: свій запис у «Контактах» → клієнт нашої CRM за телефоном (телефони клієнта, додаткові контакти, об'єднані дублі → основна картка) → одержувач у блоці «Доставка» угоди.
- Угода в рядку — остання неархівна угода цього клієнта; кнопка відкриває її картку в «Угодах» (
/crm/deals/<id>). - Якщо клієнт з'явився в CRM уже після дзвінка, дзвінок дозіставиться сам при наступному синку (за налаштуванням «Дозіставляти…»).
3Нотатки про дзвінки в картках
Після кожного синку телефона нові дзвінки клієнтів лягають нотатками в картку угоди: «Телефонія: вхідний дзвінок 18.10.2026 14:05 від +380… на +380… «Продажі» — розмова 2 хв 10 с». Пропущений — «без відповіді, треба передзвонити», вихідний без відповіді — «не додзвонилися»; якщо є запис — «Запис розмови — у розділі «Телефонія»». Автор нотатки — «Телефонія» з позначкою бота; та сама подія — у журналі картки. Без угоди нотатка іде в картку клієнта (якщо увімкнено). Один дзвінок — одна нотатка, повторів нема.
4Контакти
Вкладка «Контакти» об'єднує клієнтів нашої CRM (телефони клієнта і додаткових контактів — «ПІБ контакту (Клієнт)») і свої записи. Перейменували клієнта тут — ім'я одразу підтягнеться в дзвінки, а в CRM картка не змінюється. Зірочка збирає вибрані номери у вкладку «Вибрані» в дзвінках.
5Набрати з комп'ютера
Кнопка «Набрати» в рядку дзвінка чи контакту: сервер шле команду в застосунок на робочому телефоні (або у вебхук телефона, якщо вписали в «Номерах»), телефон починає дзвінок з робочої SIM. Журнал дзвінка приїде наступним синком.
Команда йде на телефон власника лінії — там стоїть робоча SIM. Лінія колеги сама не підставляється: якщо своєї лінії нема, а в компанії лише лінії, прив'язані до інших людей, клік не змусить дзвонити чужий телефон. Ні до кого не прив'язана єдина лінія — спільна, нею користуються всі.
6Дзвінок у клік з будь-якого розділу
Номер телефону в CRM — кнопка (власник 22.10.2026: «нажати на телефон і дзвонити з того номера, який прив'язаний до цього аккаунта»):
- Прив'яжіть свою лінію до себе: «Телефонія» → «Номери» → лінія → людина (адміністратор). На робочому телефоні відкрийте Helomi, дозвольте сповіщення й дзвінки і один раз оберіть робочу SIM.
- Натисніть номер у картці угоди, клієнта, додаткового контакту, у списку завдань, на «Дашборді продажів» (кружечок з трубкою), у картці колеги в «Структурі» чи в «Користувачах». Підказка під курсором — «Подзвонити … з лінії «Продажі»».
- Тост «Телефон набирає +380… з лінії «Продажі»» — телефон уже дзвонить, лишається взяти його й говорити. Поки команда йде, номер притишений і другий натиск нічого не шле.
Якщо лінії нема чи «Телефонію» закрито, номер працює як звичайне посилання tel:: на телефоні відкриється набір, на ПК — програма для дзвінків (наприклад, «Зв'язок із телефоном» Windows). Помилка (телефон не підписаний, вебхук не відповів) лишається тостом, поки його не закриють.
7Ломі набирає на прохання
Попросіть Ломі в чаті: «набери клієнта угоди 50000375», «подзвони Марії Клієнт», «набери 050 111 22 33 з лінії Продажі». Ломі знаходить номер і набирає його на вашому робочому телефоні (лінія, прив'язана до вас), або з лінії, яку ви назвали. Дзвінок починається одразу, бо дзвонить ваш телефон за вашим проханням; якщо ШІ працює з «Спершу запитати» (дії лише після підтвердження), набір чекає в кошику, а після «Підтвердити» дзвонить телефон того, хто просив, а не того, хто підтвердив. Так само працює Остап — ваш власний чат (Claude, ChatGPT, Kimi, Gemini) з файлом сесії: дзвонить телефон людини, яка створила цей файл. Без людини (сам по собі, за розкладом, зовнішня програма за ключем) ШІ номер не набирає. У журналі ШІ — запис, хто попросив.
Можливі помилки
| Як показується | Чому | Що зробити |
|---|---|---|
| «Немає доступу до розділу «Телефонія»» | Розділ не відкрито цій людині | «Налаштування» → «Розділи» → увімкнути «Телефонія» |
| У дзвінку нема імені та угоди | Номера нема серед телефонів клієнтів і доставок | Додайте телефон у картку клієнта або запис у «Контакти»; дзвінок дозіставиться наступним синком |
| Нотатка про дзвінок не з'явилась | Дзвінок старший за «Нотатки лише для дзвінків не старших за» або нотатки вимкнено | Перевірте «Налаштування телефонії»; давні дзвінки нотатками не дублюються навмисно |
| «Нема куди слати команду» при «Набрати» | Телефон не підписаний на сповіщення й без вебхука | Відкрити Helomi на робочому телефоні, дозволити сповіщення й дзвінки, або вписати вебхук у «Номерах» |
| «Налаштування телефонії змінює адміністратор…» | Нема доступу «Налаштування CRM» | Попросити адміністратора |
| Номер відкриває програму ПК замість дзвінка з телефона | До вас не прив'язано лінію або телефон без застосунку Helomi | «Телефонія» → «Номери»: прив'язати лінію; на телефоні — Helomi зі сповіщеннями |
| «ШІ набирає номер лише на прохання людини…» | ШІ кличе набір без людини (цикл агента, MCP) | Попросіть ШІ в чаті Ломі — дзвонитиме ваш телефон |
Для ШІ-співробітників
Розділ у каталозі — describe_section("telephony") (доступ — розділ «Телефонія» у «Доступах» ШІ):
telephony_dial values={number, line_id?, agreement_id?}— набрати номер на робочому телефоні людини, яка попросила в чаті (її лінія абоline_id). Без людини — 403: набирати лише на прохання. Права — людини: якщо їй «Телефонію» закрито, набору нема.telephony_lines— робочі номери (id, назва, чия, чи готова до набору з ПК) — щоб набрати «з лінії Продажі».telephony_calls tab=missed|incoming|outgoing|recorded|starred q=…— журнал дзвінків з клієнтом і угодою.telephony_client_calls number=…— історія дзвінків з одним номером.
Нотатки «Телефонії» видно в картках угод і клієнтів через звичайні інструменти угод (deals_*) — рядки від автора «Телефонія» з позначкою бота. Налаштування телефонії й лінії ШІ не змінює (ПРАВИЛА §5).
Додаткова інформація
- «Угоди» (
deals.md), «Клієнти» (clients.md), «Дашборд продажів» (sales.md— смуга «Пропущені дзвінки» бере дані звідси).
Цю саму статтю читають ШІ-співробітники Helomi: help("telephony")