Elbuz робить із хмарної АТС Zadarma CRM-телефонію: менеджер дзвонить клієнту з картки однією кнопкою, бачить, хто дзвонить, а кожна розмова з записом лягає в журнал та історію клієнта. На тому самому номері може відповідати голосовий AI-співробітник.
Коли це знадобиться:
- Дзвонить клієнт — менеджерові спливає картка з імʼям клієнта та його останніми замовленнями.
- Треба передзвонити — «Подзвонити» в картці: Zadarma спершу дзвонить менеджерові, потім клієнту.
- Дзвінок пропущено — у «Пульсі» зʼявляється задача «Перетелефонувати».
- Менеджери зайняті чи вже пішли — слухавку бере AI-співробітник і записує заявку.
З чого почати: скопіюйте ключ і секрет API в кабінеті Zadarma.
Що вміє інтеграція з Zadarma
Звʼязка працює двома каналами: через API Elbuz ставить дзвінки й щогодини звіряє журнал, а через сповіщення Zadarma сама повідомляє Elbuz про кожен дзвінок. Голосовий AI підключається окремо, але до того самого номера.
- Картка того, хто дзвонить. Спливає «Вхідний дзвінок» з імʼям клієнта і його останніми замовленнями; незнайомий номер заводиться кнопкою «Створити контрагента» (картка вхідного).
- Дзвінок з картки клієнта одною кнопкою. «Подзвонити» в картці контрагента чи в журналі — номер набирати не треба (внутрішні номери).
- Запис і резюме в історії клієнта. Дзвінок лягає в стрічку клієнта, «Прослухати запис» відкриває запис, AI-розбір пише резюме і пропонує наступний крок (AI-розбір дзвінків).
- Пропущений дзвінок стає задачею. У «Пульсі» зʼявляється «Перетелефонувати» з високим пріоритетом і знімається сама після розмови з цим номером.
- AI бере слухавку. Називає статус замовлення, відповідає про доставку й оплату за вашими статтями і записує заявку (номер Zadarma на AI).
- AI сам дзвонить клієнту. Наприклад, процес Flows після нового замовлення набирає клієнта, щоб підтвердити замовлення (вихідні AI).
Де це і хто має доступ
- Меню
- Кабінет → Налаштування системи → «Інші налаштування» → «Зовнішні сервіси та інтеграції» → «Телефонія» → Zadarma
- З журналу
- меню-бургер вікна «Журнал дзвінків» → «Підключення телефонії»
- Внутрішній номер
- «Користувачі (співробітники)» → картка співробітника → «Телефон внутрішній»
- Голосовий AI
- Довідники → Контакти → Пульс → «Агенти» → «Налаштування агента» → «Голос по телефону»
- Право доступу
- налаштування системи і вікно «Журнал дзвінків»; для голосу — «Управління»
- Підготувати
- ключ і секрет API Zadarma, внутрішній номер АТС для кожного менеджера
Вікно з рядка оператора називається «Налаштування доступу до API зовнішніх сервісів». Без права на «Журнал дзвінків» не працюють «Перевірити підключення», адреса вебхука й файл налаштування; щоб просто дзвонити, права не потрібні. Загальна механіка — журнал, картка дзвінка, права — у статті Телефонія в Elbuz.
Що потрібно від Zadarma
- Ключ і секрет API — «Налаштування» → «Інтеграції та API».
- Внутрішній номер АТС для кожного менеджера — «Моя АТС» → «Внутрішні номери».
- Сповіщення про дзвінки, зокрема про початок вхідного на внутрішній номер — без нього картка вхідного не спливе (крок третій).
- Для AI — окремий внутрішній номер під SIP-лінію AI і номер, з якого AI може дзвонити з-за кордону (вихідні AI).
Шляхи в кабінеті Zadarma взято з офіційної документації оператора. Якщо пункт називається інакше — орієнтуйтеся на ці сторінки або питайте підтримку Zadarma:
Як підключити Zadarma до журналу дзвінків
Три кроки по черзі: ключі, внутрішні номери співробітників і сповіщення про дзвінки. Без внутрішніх номерів не працює кнопка «Подзвонити», а без сповіщень журнал наповнюватиметься лише щогодинною звіркою — із запізненням до години.
Крок перший: ключі Zadarma
- Кабінет Zadarma → «Налаштування» → «Інтеграції та API».
- Ключі API — на сторінці
my.zadarma.com/api/: скопіюйте ключ (Key) і секрет (Secret).
Секрет потрібен Elbuz двічі: ним підписуються запити до Zadarma, і ним же Elbuz перевіряє підпис кожного сповіщення від Zadarma.
Відкрийте рядок Zadarma у групі «Телефонія». Перемикач «Активність» уже ввімкнено — залиште його так. Поля:
| Поле у формі | Що вписати |
|---|---|
| «API-ключ (key)» | ключ (key) з кабінету Zadarma |
| «Секрет (secret)» | секрет (secret) тієї ж пари |
| «Номер лінії для вихідних» | ваш номер Zadarma, який побачить клієнт; порожньо — Zadarma обере сама |
1
Посилання на інструкцію2
Перемикач «Активність»3
Поле «API-ключ (key)»4
Поле «Секрет (secret)»5
Поле «Номер лінії для вихідних»6
Кнопка «Перевірити підключення»- Посилання «Де саме — покроково в інструкції для вашого оператора» — веде на цю сторінку.
- Перемикач «Активність» — інтеграція ввімкнена.
- Поле «API-ключ (key)» — ключ з «Налаштування» → «Інтеграції та API».
- Поле «Секрет (secret)» — секрет тієї ж пари; ним Elbuz перевіряє підпис сповіщень.
- Поле «Номер лінії для вихідних» — номер, який побачить клієнт; порожньо — Zadarma обере сама.
- Кнопка «Перевірити підключення» — читальний запит до оператора, у кабінеті нічого не змінює.
Форма зберігається сама приблизно через секунду після правки: унизу видно «Збереження...», потім «Збережено». Кнопки «Зберегти» немає.
Наприкінці натисніть «Перевірити підключення». Програма звернеться до оператора з читальним запитом — у вашому кабінеті вона нічого не змінює — і відповість «Звʼязок з АТС встановлено. Співробітників в АТС: ‹кількість›». Імен співробітників Zadarma не віддає, тому в рядку «Номери АТС без співробітника Elbuz» будуть самі номери.
Крок другий: внутрішні номери
Коли менеджер натискає «Подзвонити», Zadarma спершу телефонує на його внутрішній номер і лише після відповіді набирає клієнта. Номер береться з поля «Телефон внутрішній» у картці співробітника. Той самий номер привʼязує дзвінки в журналі до менеджера: колонка «Менеджер» показує імʼя співробітника Elbuz, у якого стоїть цей номер.
- Внутрішні номери АТС видно в кабінеті Zadarma: «Моя АТС» → «Внутрішні номери».
- У картку співробітника вписуйте короткий номер (наприклад, 100), без префікса акаунта. За коротким номером звірка відрізняє вихідний дзвінок від вхідного.
- Під формою підключення є картка «Внутрішні номери співробітників» — таблиця «Менеджер» / «Внутрішній номер» по всіх активних співробітниках. Рядки з прочерком — ті, кому номер ще не вписали.
Крок третій: як увімкнути сповіщення Zadarma
У формі є картка «Адреса для вебхука АТС» з адресою й кнопкою «Скопіювати». Далі в кабінеті Zadarma (так описано в документації API Zadarma):
- «Налаштування» → «Інтеграції та API».
- У блоці сповіщень вставте адресу в поле «для сповіщень про дзвінки в АТС».
- Натисніть «Увімкнути».
Під час збереження Zadarma перевіряє адресу: надсилає на неї контрольний рядок і чекає його у відповідь. Elbuz відповідає на таку перевірку сам, тож адреса зберігається без додаткових дій.
Elbuz потрібні сповіщення:
- про початок і завершення вхідного дзвінка;
- про початок і завершення вихідного дзвінка;
- про запис розмови;
- про початок вхідного дзвінка на внутрішній номер АТС (у документації Zadarma — NOTIFY_INTERNAL). Лише в ньому Zadarma називає внутрішній номер, на який іде дзвінок, і без нього картка вхідного не спливе.
Як увімкнути останнє в кабінеті, документація Zadarma не показує (через API це параметр notify_internal, за замовчуванням вимкнений). Не знайшли перемикача — уточніть у підтримки Zadarma. Події «відповідь» і голосове меню Elbuz пропускає.
1
Адреса для оператора2
Кнопка «Скопіювати»- Адреса, яку передаєте оператору; секретний ключ у кінці на кадрі приховано.
- Кнопка «Скопіювати» — кладе адресу в буфер обміну.
Кожне сповіщення Zadarma підписує секретом API, і Elbuz приймає лише ті, чий підпис сходиться із секретом у формі. Перевипустили ключі в Zadarma й не оновили секрет в Elbuz — сповіщення мовчки відкидаються, журнал наповнює тільки звірка. Після будь-якої заміни ключів перепишіть обидва поля і натисніть «Перевірити підключення».
У адресі — секретний ключ із 32 знаків, і хост тієї адреси, з якої ви відкрили форму. Відкривайте налаштування з того домену, яким користуєтеся постійно. Змінили домен — скопіюйте адресу заново й замініть її в Zadarma.
Щоб Zadarma запрацював з Elbuz
Що приходить у Elbuz
| Можливість | Як це працює з Zadarma |
|---|---|
| Дзвінок з картки й журналу («Подзвонити») | так: Zadarma спершу дзвонить на внутрішній номер менеджера, потім клієнту. Якщо заповнено «Номер лінії для вихідних», клієнт побачить цей номер |
| Вхідні дзвінки в журналі | так, за сповіщенням про завершення дзвінка; дзвінки співробітника співробітнику в журнал не потрапляють |
| Вихідні дзвінки в журналі | так, за сповіщенням про завершення вихідного |
| Картка вхідного дзвінка в момент дзвінка | так, якщо ввімкнено сповіщення про початок вхідного на внутрішній номер (картка вхідного) |
| Запис розмови | так: посилання Elbuz запитує в Zadarma в момент, коли ви натискаєте «Прослухати запис» |
| Результат дзвінка | «Відбувся», «Зайнято», «Скасований», «Не відповіли», «Збій звʼязку» — так Elbuz перекладає статуси Zadarma |
| Щогодинна звірка журналу | так, на 25-й хвилині кожної години за добу назад |
| Час очікування окремо від розмови | ні: Zadarma віддає лише загальну тривалість, колонка очікування нульова |
| Імʼя клієнта на екрані телефону | ні: Zadarma не запитує в CRM імʼя того, хто дзвонить |
| Скинути дзвінок з картки вхідного | ні: у Zadarma немає такого методу API |
| Голосовий AI-співробітник | так, вхідні й вихідні (номер на AI) |
Особливості Zadarma
Які сповіщення Elbuz обробляє
- Початок вхідного і вихідного дзвінка — Elbuz шукає клієнта за номером.
- Початок вхідного на внутрішній номер — показує картку менеджерові.
- Завершення дзвінка — кладе дзвінок у журнал з тривалістю, результатом і ознакою запису.
- Запис — приходить пізніше завершення; Elbuz знаходить уже записаний дзвінок і ставить позначку, що запис є.
Картка вхідного дзвінка
Картку «Вхідний дзвінок» Elbuz показує тому менеджерові, на чий внутрішній номер іде виклик. У сповіщенні про початок вхідного дзвінка Zadarma передає номер клієнта, ваш номер і час, але не внутрішній номер — його вперше називає сповіщення «початок вхідного дзвінка на внутрішній номер АТС».
- Сповіщення не ввімкнене — картка в момент дзвінка не спливе, але дзвінок ляже в журнал після завершення, а картка «Пропущений дзвінок» зʼявиться, якщо у сповіщенні про завершення є внутрішній номер.
- Дзвінок від співробітника до співробітника (обидва номери короткі) — картки немає, і в журнал він не потрапляє ні зі сповіщень, ні під час звірки.
Записи розмов
Elbuz не зберігає записи в себе. Коли ви натискаєте «Прослухати запис», програма просить у Zadarma посилання на цей дзвінок; якщо записів у дзвінка кілька, береться перший. Тому запис можна прослухати доти, доки він зберігається у Zadarma, — скільки саме, визначає ваш тариф в операторі.
Щогодинна звірка і ліміти Zadarma
Щогодини Elbuz забирає в Zadarma статистику дзвінків АТС за добу назад і дописує те, чого не принесли сповіщення. Zadarma віддає статистику порціями до 1000 дзвінків, не більше ніж за 30 днів за раз, і дозволяє лише кілька запитів статистики на хвилину.
Ліміт вичерпано — Elbuz чекає, доки він оновиться (коли до оновлення трохи більше хвилини). Якщо й цього мало, зберігає вже отримане, а решту добирає наступна звірка.
Як направити номер Zadarma на голосового AI
Голос працює окремо від інтеграції вище: розмову веде не ваша АТС, а голосова платформа Elbuz, і номер треба на неї спрямувати. Налаштовується це в розділі «Голос по телефону» картки AI-співробітника; що AI каже покупцям і як дзвонить з процесів — у статті Голосовий AI-співробітник. Тут — лише кроки в кабінеті Zadarma.
Вхідні: як направити номер на AI
У розділі «Голос по телефону» вкажіть номер Zadarma, на який має відповідати AI, і в полі «Оператор» залиште Zadarma. Розділ покаже адресу виду <номер>@<SIP-домен> — номер без «+», потім домен голосової платформи Elbuz. Скопіюйте її кнопкою «Скопіювати» і в кабінеті Zadarma скористайтеся одним із двох способів.
Номер цілком на AI (переадресація самого віртуального номера):
- «Налаштування» → «Віртуальні номери».
- Натисніть на SIP, до якого підключений номер.
- Поставте помітку навпроти пункту «зовнішній сервер» і вставте скопійовану адресу.
Через внутрішній номер АТС (дзвінки на номер ідуть за сценарієм АТС, а на AI — з потрібного внутрішнього):
- «Моя АТС» → «Внутрішні номери».
- У налаштуваннях внутрішнього номера навпроти «Переадресація та голосова пошта» натисніть «Увімкнути».
- Оберіть умову, наприклад «Завжди».
- У «Переадресація на» оберіть «Зовнішній сервер (SIP URI)» і вставте адресу.
- Натисніть «Зберегти».
Zadarma просить дозволити на приймальній стороні дзвінки з її адрес. Коли в розділі «Голос по телефону» вибрано Zadarma, Elbuz робить це сам: приймає дзвінки на вашу SIP-адресу тільки з підмереж Zadarma.
Вихідні: SIP-лінія для дзвінків AI
Для вихідних AI реєструється у Zadarma як звичайний SIP-телефон на одному з внутрішніх номерів АТС. Заведіть під AI окремий внутрішній номер: один SIP-обліковий запис — один зареєстрований пристрій.
| Поле в Elbuz | Що вписати | Де взяти в Zadarma |
|---|---|---|
| «SIP-сервер» | pbx.zadarma.com; порожнє поле Elbuz для Zadarma заповнить сам | адреса SIP-проксі АТС з інструкцій Zadarma |
| «Логін лінії» | внутрішній номер вигляду 12345-101 | «Моя АТС»: ідентифікатор АТС, дефіс, короткий внутрішній номер |
| «Пароль лінії» | пароль цього внутрішнього номера; після збереження поле показує «збережено — введіть, щоб замінити» | «Моя АТС» → «Внутрішні номери» |
| «Номер для клієнта» | номер, який побачить клієнт; порожньо — як у вхідних | список ваших номерів |
| «Дзвонити в години» | за замовчуванням 9-20 за часом акаунта | — |
Вихідні працюють тільки з увімкненим «Відповідати на дзвінки» — інакше «Пробний дзвінок» відповість «Вихідні не налаштовані: вкажіть логін і пароль лінії та увімкніть відповідь на дзвінки».
Голосова платформа Elbuz дзвонить через Zadarma з-за кордону, тому для вихідних AI важлива категорія номера в «Номері для клієнта»:
- «Національні» й міські номери (наприклад, Вінниця) з-за кордону не дзвонять — вихідні AI з ними не пройдуть;
- «Мобільні», за словами підтримки Zadarma, дзвонити можуть; живим дзвінком ми це ще не перевіряли — зробіть «Пробний дзвінок»;
- номер іншої країни, наприклад з ЄС, підходить.
Категорію видно в кабінеті Zadarma у списку ваших номерів, у колонці країни й міста. Вхідні AI приймає з номера будь-якої категорії.
Сценарії
Менеджери дзвонять з CRM, керівник слухає розмови
Пройдіть три кроки підключення і впишіть кожному менеджеру короткий внутрішній номер. «Подзвонити» запрацює з картки й журналу, а записи слухаються з журналу, поки зберігаються в Zadarma.
Частину дзвінків беруть менеджери, частину — AI
Направте на AI внутрішній номер АТС, а не весь віртуальний номер: так дзвінки йдуть за сценарієм вашої АТС, і на AI потрапляють лише ті, що перейшли на цей внутрішній (вхідні на AI).
AI підтверджує кожне нове замовлення
Заведіть для AI окремий внутрішній номер, впишіть його логін і пароль у «Вихідні дзвінки», у «Номер для клієнта» — номер, який дзвонить з-за кордону. Зробіть «Пробний дзвінок», потім процес Flows з блоком «AI-дзвінок» (підтвердити замовлення).
Що робити, коли дзвінки не доходять
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| Кнопки «Подзвонити» немає ні в списку контактів, ні в картці | Ключі не вписані або перемикач «Активність» вимкнено — кнопки дзвінка тоді не малюються зовсім | Перевірте поля й перемикач у формі підключення (крок перший) |
| «У вашій картці співробітника не вказано внутрішній номер телефону» | Порожнє поле «Телефон внутрішній» у вашій картці: АТС нікуди дзвонити першим кроком | Впишіть номер у картку співробітника (крок другий) |
| Дзвінки є в кабінеті Zadarma, а в журналі зʼявляються лише через годину | Сповіщення не доходять: адреса не додана в Zadarma, у ній старий домен або підпис не сходиться через замінений секрет | Скопіюйте адресу з картки «Адреса для вебхука АТС» заново, перевірте її в сповіщеннях Zadarma і перевпишіть секрет (крок третій) |
| «Звʼязок з АТС встановлено», але в рядку «Номери АТС без співробітника Elbuz» самі номери без імен | Так і має бути: Zadarma віддає список внутрішніх номерів без імен | Звірте номери з кабінетом Zadarma і впишіть їх у картки відповідних співробітників |
| «АТС не відповіла вчасно. Якщо дзвінок усе ж почався, він зʼявиться в журналі дзвінків — перевірте його перед повторним набором» | Оператор не відповів за 15 секунд. Запит міг бути прийнятий — тоді ваш телефон задзвонить трохи згодом | Не набирайте одразу вдруге: зачекайте хвилину. Якщо АТС прийняла запит, ваш телефон задзвонить, а після розмови дзвінок зʼявиться в журналі |
| Вихідний дзвінок AI на клієнта не проходить, хоча вхідні AI приймає | У «Номері для клієнта» номер категорії «Національні» або міський: з-за кордону такі номери не дзвонять | Укажіть у «Номері для клієнта» номер категорії «Мобільні» (за словами підтримки Zadarma) або номер іншої країни, наприклад з ЄС, і зробіть «Пробний дзвінок» |
Решта випадків — у загальному розборі Телефонія в Elbuz, проблеми розмови з AI — у розборі статті Голосовий AI-співробітник.
Часті запитання
Де в Zadarma взяти ключ і секрет для Elbuz?
В особистому кабінеті Zadarma: «Налаштування» → «Інтеграції та API», сторінка ключів API my.zadarma.com/api/. Ключ вписується в поле «API-ключ (key)», секрет — у «Секрет (secret)» рядка Zadarma групи «Телефонія».
Куди в Zadarma вписати адресу з Elbuz?
«Налаштування» → «Інтеграції та API», у блоці сповіщень — поле «для сповіщень про дзвінки в АТС», далі «Увімкнути». Контрольний запит Zadarma під час збереження Elbuz проходить сам.
Чи можна прослухати запис розмови Zadarma з Elbuz?
Так. «Прослухати запис» у журналі просить у Zadarma посилання саме в момент натискання. Elbuz записи в себе не копіює, тож прослухати можна доти, доки запис зберігається в Zadarma.
Чому в Zadarma не спливає картка вхідного дзвінка?
Внутрішній номер, на який іде дзвінок, Zadarma називає лише в сповіщенні «початок вхідного дзвінка на внутрішній номер АТС» (NOTIFY_INTERNAL). Увімкніть його в Zadarma; не знайшли перемикача — уточніть у підтримки Zadarma.
Як направити номер Zadarma на голосового AI?
Скопіюйте з розділу «Голос по телефону» адресу виду номер@SIP-домен і вставте в Zadarma як «зовнішній сервер» віртуального номера або як «Зовнішній сервер (SIP URI)» у переадресації внутрішнього номера (кроки).
Що вписати, щоб AI сам дзвонив клієнтам через Zadarma?
SIP-сервер pbx.zadarma.com, логін внутрішнього номера вигляду 12345-101 і його пароль, а в «Номер для клієнта» — номер, який дзвонить з-за кордону (вихідні AI).
Підключено дві телефонії — через яку піде «Подзвонити»?
Через першу активну налаштовану. Дзвонити через Zadarma і другого оператора одночасно Elbuz не вміє.
Чи побачить менеджер імʼя клієнта на екрані телефону?
Ні: Zadarma не запитує в CRM, хто дзвонить, тож на апараті — тільки номер. Імʼя і замовлення показує картка «Вхідний дзвінок» в Elbuz.
Суміжні теми
- Якщо треба зрозуміти журнал, картку дзвінка чи хто що бачить — Телефонія в Elbuz.
- Якщо треба налаштувати, що AI каже покупцям і коли дзвонить, — Голосовий AI-співробітник.
- Якщо менеджерові треба вписати «Телефон внутрішній» — Картка співробітника.
- Якщо треба знайти розмову в історії клієнта — Картка контрагента.