HelomiWIKI

Телефонія

«Телефонія» — дзвінки з робочого телефона компанії без платної АТС: застосунок Helomi на телефоні зливає сюди журнал дзвінків робочої SIM і записи розмов, а розділ показує їх списком зі статистикою, порадами й телефонною книгою. Кожен дзвінок зіставляється з клієнтом нашої CRM і його останньою угодою, а в картку угоди (або клієнта) лягає нотатка про дзвінок.

8 хвОновлено 25.10.2026
Markdown для ШІ
На цій сторінці

Можливості

  • Журнал дзвінків робочої SIM з телефона: вхідні, вихідні, пропущені, з записами розмов; стан передзвону для пропущених.
  • Ім'я клієнта, його картка й остання угода в нашій CRM — за номером телефону (телефони клієнта, додаткових контактів, одержувача посилки).
  • Нотатка про кожен дзвінок у картці угоди клієнта, а без угоди — у картці клієнта; видно в «Нотатках» і в журналі картки.
  • Вкладка «Контакти»: телефонна книга з клієнтів нашої CRM плюс свої записи й зірочки.
  • Статистика по днях, годинах, лініях і клієнтах; поради за правилами (не передзвонили, пік дзвінків, короткі розмови).
  • Кнопка «Набрати» з комп'ютера — телефон сам починає дзвінок з робочої SIM.
  • Дзвінок у клік по всій CRM: номер у картці угоди, клієнта, контакту, у завданнях, «Дашборді продажів», картці колеги в «Структурі» й у «Користувачах» — клік, і ваш робочий телефон сам набирає номер.
  • Ломі набирає номер на ваше прохання («набери клієнта угоди 50000375») — з вашого робочого телефона або з лінії, яку назвали.

1Налаштування

Доступ дає адміністратор: «Налаштування» → «Розділи» → «Телефонія». Без доступу розділ не відкривається, а телефон цієї людини не зливає журнал.

Робочі номери: «Телефонія» → «Номери» → «Додати номер» (адміністратор). Прив'яжіть лінію до людини, щоб «Набрати» знав, з якого телефона дзвонити; на телефоні один раз оберіть робочу SIM у розділі «Телефонія».

Нотатки й зіставлення налаштовує адміністратор або людина з доступом «Налаштування CRM» (PUT /api/telephony/settings; форма в інтерфейсі — у черзі робіт):

  • «Писати нотатку про дзвінок у картку угоди клієнта» (типово так).
  • «Якщо угоди нема — писати в картку клієнта» (так).
  • «Писати й про дзвінки без відповіді» (так) — пропущені й «не додзвонилися».
  • «Нотатки лише для дзвінків не старших за, днів» (3) — щоб давні дзвінки після дозіставлення не перетирали останню нотатку угоди.
  • «Дозіставляти дзвінки без клієнта чи угоди за останні, днів» (14) — замовлення з площадки приходить уже після дзвінка.

Змінили — діє з наступного синку телефона, без перезапуску. Кожна зміна записується в журнал з автором.

2Дзвінки і клієнти

  1. Відкрийте «Телефонія» на телефоні — застосунок зіллє журнал робочої SIM (повторно можна скільки завгодно, дублів не буде).
  2. У списку на комп'ютері з'являться дзвінки з ім'ям клієнта і кнопкою угоди. Ім'я береться так: свій запис у «Контактах» → клієнт нашої CRM за телефоном (телефони клієнта, додаткові контакти, об'єднані дублі → основна картка) → одержувач у блоці «Доставка» угоди.
  3. Угода в рядку — остання неархівна угода цього клієнта; кнопка відкриває її картку в «Угодах» (/crm/deals/<id>).
  4. Якщо клієнт з'явився в CRM уже після дзвінка, дзвінок дозіставиться сам при наступному синку (за налаштуванням «Дозіставляти…»).

3Нотатки про дзвінки в картках

Після кожного синку телефона нові дзвінки клієнтів лягають нотатками в картку угоди: «Телефонія: вхідний дзвінок 18.10.2026 14:05 від +380… на +380… «Продажі» — розмова 2 хв 10 с». Пропущений — «без відповіді, треба передзвонити», вихідний без відповіді — «не додзвонилися»; якщо є запис — «Запис розмови — у розділі «Телефонія»». Автор нотатки — «Телефонія» з позначкою бота; та сама подія — у журналі картки. Без угоди нотатка іде в картку клієнта (якщо увімкнено). Один дзвінок — одна нотатка, повторів нема.

4Контакти

Вкладка «Контакти» об'єднує клієнтів нашої CRM (телефони клієнта і додаткових контактів — «ПІБ контакту (Клієнт)») і свої записи. Перейменували клієнта тут — ім'я одразу підтягнеться в дзвінки, а в CRM картка не змінюється. Зірочка збирає вибрані номери у вкладку «Вибрані» в дзвінках.

5Набрати з комп'ютера

Кнопка «Набрати» в рядку дзвінка чи контакту: сервер шле команду в застосунок на робочому телефоні (або у вебхук телефона, якщо вписали в «Номерах»), телефон починає дзвінок з робочої SIM. Журнал дзвінка приїде наступним синком.

Команда йде на телефон власника лінії — там стоїть робоча SIM. Лінія колеги сама не підставляється: якщо своєї лінії нема, а в компанії лише лінії, прив'язані до інших людей, клік не змусить дзвонити чужий телефон. Ні до кого не прив'язана єдина лінія — спільна, нею користуються всі.

6Дзвінок у клік з будь-якого розділу

Номер телефону в CRM — кнопка (власник 22.10.2026: «нажати на телефон і дзвонити з того номера, який прив'язаний до цього аккаунта»):

  1. Прив'яжіть свою лінію до себе: «Телефонія» → «Номери» → лінія → людина (адміністратор). На робочому телефоні відкрийте Helomi, дозвольте сповіщення й дзвінки і один раз оберіть робочу SIM.
  2. Натисніть номер у картці угоди, клієнта, додаткового контакту, у списку завдань, на «Дашборді продажів» (кружечок з трубкою), у картці колеги в «Структурі» чи в «Користувачах». Підказка під курсором — «Подзвонити … з лінії «Продажі»».
  3. Тост «Телефон набирає +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")