Elbuz підключається до UniTalk одним API-ключем: менеджер дзвонить клієнту з картки одною кнопкою, а дзвінки з записами самі лягають у журнал та історію клієнта.
Коли це знадобиться:
- Менеджер не знає, хто дзвонить — на екрані Elbuz спливає картка вхідного дзвінка з імʼям клієнта й останніми замовленнями.
- Номер доводиться набирати вручну — кнопка «Подзвонити» в картці: UniTalk зʼєднує спершу менеджера, потім клієнта.
- Пропущені дзвінки губляться — пропущений стає задачею «Перетелефонувати» в «Пульсі».
З чого почати: згенеруйте API-ключ у кабінеті UniTalk (де саме).
Що вміє Elbuz з UniTalk
- Дзвінок з картки клієнта одною кнопкою — з внутрішньої лінії менеджера (внутрішні номери).
- Журнал і записи розмов — постійне посилання на запис зберігається в журналі (що приходить).
- Зрозумілий результат дзвінка — стани UniTalk зведено до кількох звичних (статуси).
- Картка вхідного і пропущеного дзвінка — імʼя, останні замовлення, задача «Перетелефонувати» (картка дзвінка).
- Резюме розмови в історії клієнта — AI-розбір і наступний крок (AI-розбір дзвінків).
Де це і хто має доступ
Підключення UniTalk живе серед інших інтеграцій, а не в журналі дзвінків. Вікно з рядка оператора називається «Налаштування доступу до API зовнішніх сервісів».
- Меню
- Кабінет → Налаштування системи → «Інші налаштування» → «Зовнішні сервіси та інтеграції» → «Телефонія» → UniTalk
- Інші входи
- «Журнал дзвінків» → меню-бургер → «Підключення телефонії»
- Право доступу
- налаштування системи і вікно «Журнал дзвінків»; щоб дзвонити, права не потрібні
- Підготувати
- API-ключ UniTalk, внутрішні лінії (SIP) співробітників
Без права на «Журнал дзвінків» не працюють «Перевірити підключення», адреса вебхука й файл налаштування.
Що потрібно від UniTalk
API-ключ створюється в кабінеті UniTalk (за базою знань UniTalk):
- Кабінет UniTalk → розділ «Інтеграції – API».
- Натисніть кнопку створення ключа — він зʼявиться у вікні; скопіюйте його.
Логіна UniTalk не потребує — у формі Elbuz одне поле для ключа. Внутрішні лінії (SIP) співробітників видно в «Налаштування» → вкладка «Користувачі».
Шляхи в кабінеті UniTalk взято з офіційної документації оператора. Якщо пункт називається інакше — орієнтуйтеся на ці сторінки або питайте підтримку UniTalk:
Як підключити UniTalk до Elbuz
Три кроки по черзі: ключ, внутрішні номери і вебхуки. Без внутрішніх номерів не працює кнопка «Подзвонити». Без вебхуків журнал наповнюється лише щогодинною звіркою — із запізненням до години.
Крок перший: ключі UniTalk
Відкрийте рядок UniTalk у групі «Телефонія». Перемикач «Активність» уже ввімкнено — залиште його так. У поле «API-ключ» впишіть ключ з розділу «Інтеграції – API».
1
Посилання на інструкцію2
Перемикач «Активність»3
Поле «API-ключ»4
Кнопка «Перевірити підключення»- Посилання «Де саме — покроково в інструкції для вашого оператора» — веде на цю сторінку.
- Перемикач «Активність» — інтеграція ввімкнена.
- Поле «API-ключ» — ключ з розділу «Інтеграції – API».
- Кнопка «Перевірити підключення» — читальний запит до оператора, у кабінеті нічого не змінює.
Форма зберігається сама приблизно через секунду після правки: унизу видно «Збереження...», потім «Збережено». Кнопки «Зберегти» немає.
Наприкінці натисніть «Перевірити підключення». Окремого списку співробітників в API UniTalk немає, тому Elbuz перевіряє ключ запитом журналу дзвінків за останню годину. Відповідь — «Звʼязок з АТС встановлено. Співробітників в АТС: 0», рядка «Номери АТС без співробітника Elbuz» не буде. Невірний ключ Elbuz розпізнає як відмову, а не як «дзвінків немає».
Крок другий: внутрішні номери
Коли менеджер натискає «Подзвонити», UniTalk спершу телефонує на його внутрішній номер і лише після відповіді набирає клієнта. Той самий номер привʼязує дзвінки в журналі до менеджера.
Де: картка співробітника («Користувачі (співробітники)») → поле «Телефон внутрішній».
Для UniTalk у «Телефон внутрішній» вписують внутрішній номер (SIP-лінію) співробітника з кабінету UniTalk. Саме його Elbuz передає в UniTalk як «звідки» дзвонити. Внутрішнім номером Elbuz вважає лише коротке значення, до шести цифр.
Під формою підключення є картка «Внутрішні номери співробітників» — таблиця «Менеджер» / «Внутрішній номер» по всіх активних співробітниках. Рядки з прочерком — ті, кому номер ще не вписали.
Крок третій: вебхуки на адресу Elbuz
У формі є картка «Адреса для вебхука АТС» з адресою й кнопкою «Скопіювати». Вебхуки в UniTalk створюєте ви (за базою знань UniTalk):
- Кабінет UniTalk → «Інтеграції – API» → кнопка «Додати» — відкриється форма вебхука.
- «Дія» — «Надіслати вебхук», «Назва» — наприклад «Новий дзвінок», «URL» — адреса з Elbuz, метод — POST. Заголовок із ключем для Elbuz не потрібен: адресу підтверджує секрет у ній самій.
- Тіло запиту — JSON з подією CALL_NEW (які поля читає Elbuz). Збережіть.
- Так само створіть другий вебхук — «Завершений дзвінок» з подією CALL_END.
- Додайте обидва вебхуки в підрозділ «Обробка подій дзвінка (Вихідні вебхуки)» розділу «Інтеграції – API».
1
Адреса для оператора2
Кнопка «Скопіювати»- Адреса, яку передаєте оператору; секретний ключ у кінці на кадрі приховано.
- Кнопка «Скопіювати» — кладе адресу в буфер обміну.
Щоб UniTalk запрацював з Elbuz
Що приходить у Elbuz
Усе нижче звірено з модулем інтеграції UniTalk в Elbuz, написаним за довідником API оператора.
| Можливість | Як це працює з UniTalk |
|---|---|
| Дзвінок з картки й журналу («Подзвонити») | так: дзвінок із внутрішньої лінії менеджера на номер клієнта |
| Вхідні й вихідні в журналі | так, за подією CALL_END; внутрішні дзвінки (INNER) не пишуться |
| Картка вхідного дзвінка | так, з подій CALL_NEW, CALL_REDIRECT, CALL_ANSWER, якщо в них є внутрішня лінія |
| Запис розмови | так: постійне посилання приходить у події; є лише в розмов, що відбулися |
| Щогодинна звірка журналу | так, на 25-й хвилині кожної години за добу назад |
| Імʼя клієнта на екрані телефону | ні: у відповідь UniTalk нічого не чекає |
| Скинути дзвінок з картки вхідного | так: кнопка «Скинути» в картці «Вхідний дзвінок» |
| Голосовий AI-співробітник | не підтверджено (нижче) |
Elbuz читає з тіла вебхука поле event і обʼєкт call у структурі події UniTalk: id, direction, from, to, state, secondsTalk, secondsFullTime, link, date, outerNumber. Як підставити ці поля в шаблон тіла запиту, база знань UniTalk не пояснює — уточніть у підтримки UniTalk, якщо форма не заповнює тіло сама.
Особливості UniTalk
Ліміти запитів UniTalk
UniTalk жорстко обмежує частоту запитів: більше 30 за 10 секунд — тимчасове блокування, більше 100 — постійне. Тому щогодинна звірка бере журнал найбільшими сторінками, по 1000 дзвінків, робить секундну паузу між сторінками і зупиняється на двадцятій.
Адресу вебхука не показуйте стороннім
Підпису в подіях UniTalk немає, адрес своїх серверів оператор не публікує, тож єдиний захист — секретний ключ в адресі.
Записи розмов
Посилання на запис UniTalk передає в полі події, і воно постійне. Є воно тільки в дзвінків, які відбулися: у пропущеного чи скасованого запису немає.
Як читаються статуси
Станів дзвінка в UniTalk більше, ніж в інших операторів. Elbuz зводить їх так:
| Стан у UniTalk | «Результат» у журналі Elbuz |
|---|---|
| «Немає грошей», «зайняті зовнішні лінії», «номер не існує», «недоступний», помилка напрямку | «Збій звʼязку» |
| заблокований | «Скасований» |
| «зайнято» | «Зайнято» |
| стан не прийшов, була тривалість | «Відбувся» |
| стан не прийшов, тривалості немає | «Не відповіли» |
Номер клієнта й коментарі
У UniTalk номер клієнта передається тільки цифрами, без «+» і пробілів — Elbuz прибирає їх сам. Коментарі до дзвінка з UniTalk у журнал не переносяться: поле коментаря в журналі належить менеджеру, і звірка не затирає написане ним.
Голосовий AI-співробітник на номері UniTalk
AI-співробітник Elbuz уміє сам відповідати на дзвінки і сам телефонувати клієнтам. Розмову веде не ваша АТС, а голосова платформа Elbuz, і номер треба на неї спрямувати. Налаштування розділу «Голос по телефону» — у статті Голосовий AI-співробітник.
Вхідні: як направити номер на AI
У полі «Оператор» розділу «Голос по телефону» оберіть «Інший оператор». У поле «Адреси оператора» через кому впишіть IP, підмережі або домен АТС, з яких оператор надсилатиме дзвінки на SIP-адресу, — їх дає підтримка оператора. Поле порожнє — Elbuz прийматиме дзвінки на вашу SIP-адресу з будь-якої адреси.
Домен Elbuz сам перетворює на IP-адреси під час збереження розділу. Якщо АТС змінить IP, змініть будь-яке поле розділу «Голос», щоб він зберігся заново.
Розділ покаже адресу виду <номер>@<SIP-домен>. У базі знань UniTalk сценарії вхідних дзвінків налаштовуються в «Дзвінки» → «Налаштування» → «Вхідні сценарії» → «Додати сценарій», і серед напрямків переадресації є «зовнішній SIP-акаунт або інша телефонія». Чи можна вписати туди адресу вигляду номер@домен — уточніть у підтримки UniTalk: прямо база знань цього не каже.
Вихідні: SIP-лінія для дзвінків AI
Логін і пароль лінії беруться в кабінеті UniTalk (за інструкціями UniTalk для програмних телефонів):
- «Налаштування» → вкладка «Користувачі».
- Логін — внутрішній номер; пароль — кнопка «Показати пароль».
- SIP-сервер —
sip.unitalk.cloudабо той, що вказано в налаштуваннях SIP-лінії на вкладці «Користувачі».
Їх вписують у «Логін лінії», «Пароль лінії» і «SIP-сервер» блоку «Вихідні дзвінки». Під AI краще завести окремого користувача. Чи дозволяє UniTalk дзвонити клієнтам із такої лінії з зовнішньої платформи — уточніть у підтримки UniTalk.
Вихідні працюють тільки тоді, коли ввімкнено «Відповідати на дзвінки»: інакше пробний дзвінок відповість «Вихідні не налаштовані: вкажіть логін і пароль лінії та увімкніть відповідь на дзвінки». За замовчуванням AI дзвонить з 9 до 20 за часом акаунта — поле «Дзвонити в години».
Сценарії
Менеджер передзвонює клієнту з картки
- Впишіть менеджеру його SIP-лінію UniTalk у «Телефон внутрішній» (крок другий).
- Менеджер тисне «Подзвонити» в картці клієнта — UniTalk дзвонить йому, після відповіді набирає клієнта.
- Після розмови вебхук CALL_END кладе дзвінок у журнал із записом і результатом.
Пропущений дзвінок не губиться
Менеджер не взяв слухавку — спливає картка «Пропущений дзвінок», а в «Пульсі» зʼявляється задача «Перетелефонувати». Коли з номером відбулася розмова, задача знімається сама. Детальніше: пропущені дзвінки.
Розібратися, чому дзвінок не відбувся
Відфільтруйте журнал за «Результатом» «Збій звʼязку»: туди потрапляють дзвінки, які UniTalk не провів через баланс, зайняті лінії чи неіснуючий номер (як читаються статуси).
Що робити, коли UniTalk не працює з Elbuz
Загальні проблеми телефонії — немає кнопки дзвінка, порожній журнал, немає запису — розібрано в статті Телефонія в Elbuz. Тут — те, що стосується UniTalk.
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| Кнопки «Подзвонити» немає ні в списку контактів, ні в картці | Ключі не вписані або перемикач «Активність» вимкнено — кнопки дзвінка тоді не малюються зовсім | Перевірте поля й перемикач у формі підключення (крок перший) |
| «У вашій картці співробітника не вказано внутрішній номер телефону» | Порожнє поле «Телефон внутрішній» у вашій картці: АТС нікуди дзвонити першим кроком | Впишіть номер у картку співробітника (крок другий) |
| «Перевірити підключення» повертає помилку авторизації | Невірний або видалений API-ключ | Згенеруйте ключ у «Інтеграції – API» ще раз і перевпишіть |
| Дзвінки зʼявляються тільки раз на годину | Вебхуки не створені, не додані в обробку подій дзвінка або в адресі старий домен | Перевірте вебхуки CALL_NEW і CALL_END у кабінеті UniTalk і адресу в них |
| UniTalk тимчасово заблокував ключ | Перевищено ліміт 30 запитів за 10 секунд — разом з іншими інтеграціями, що користуються тим самим ключем | Дочекайтеся розблокування й не використовуйте той самий ключ у кількох інтеграціях одночасно |
| «АТС не відповіла вчасно. Якщо дзвінок усе ж почався, він зʼявиться в журналі дзвінків — перевірте його перед повторним набором» | Оператор не відповів за 15 секунд. Запит міг бути прийнятий — тоді ваш телефон задзвонить трохи згодом | Не набирайте одразу вдруге: зачекайте хвилину. Якщо АТС прийняла запит, ваш телефон задзвонить, а після розмови дзвінок зʼявиться в журналі |
Часті запитання
Де в UniTalk взяти API-ключ для Elbuz?
У кабінеті UniTalk, розділ «Інтеграції – API», кнопка генерації ключа. Ключ вписують у поле «API-ключ» рядка UniTalk групи «Телефонія» в Elbuz.
Які вебхуки UniTalk потрібні Elbuz?
Два вихідні вебхуки методом POST на адресу з картки «Адреса для вебхука АТС»: на новий дзвінок (CALL_NEW) і на завершений (CALL_END). Їх додають в обробку подій дзвінка в розділі «Інтеграції – API».
Чи може Elbuz заблокувати мій ключ UniTalk частими запитами?
Elbuz враховує ліміти UniTalk: звірка бере журнал сторінками по 1000 дзвінків із паузою між ними. Ризик зʼявляється, якщо той самий ключ одночасно використовують інші інтеграції.
Чому перевірка показує «Співробітників в АТС: 0»?
Окремого списку співробітників в API UniTalk немає, тому Elbuz перевіряє ключ запитом журналу дзвінків за годину. Нуль — нормальна відповідь для UniTalk.
Чи покаже UniTalk імʼя клієнта на телефоні менеджера?
Ні: UniTalk не чекає від CRM відповіді з іменем. Хто дзвонить, менеджер бачить у картці вхідного дзвінка на екрані Elbuz (картка дзвінка).
Чи можна вибрати номер, з якого UniTalk дзвонить клієнту?
Ні. API дзвінка UniTalk номера лінії не приймає, тому поля «Номер лінії для вихідних» у формі UniTalk немає.
Чи можна направити номер UniTalk на голосового AI?
Готової інструкції немає. Уточніть у підтримки UniTalk, чи можна переадресувати номер на зовнішню SIP-адресу з розділу «Голос по телефону» (що вже відомо).
Суміжні теми
- Якщо потрібна загальна картина телефонії й порівняння операторів — Телефонія в Elbuz.
- Якщо дзвінок уже в журналі й треба зрозуміти колонки чи «Результат» — Журнал дзвінків.
- Якщо хочете, щоб AI сам відповідав і телефонував клієнтам, — Голосовий AI-співробітник.
- Якщо дзвінки не привʼязуються до менеджера — Користувачі (співробітники), поле «Телефон внутрішній».
- Якщо треба знайти розмову в історії клієнта — Картка контрагента.