Як підключити віртуальну АТС до Elbuz

Що вміє форма підключення

Підключення складається з трьох кроків. Порядок саме такий — без ключів немає чого перевіряти, без внутрішніх номерів не працює кнопка «Подзвонити».

• Ключі оператора — форма сама підставляє підписи полів вашого оператора і перевіряє звʼязок з АТС однією кнопкою.
• Внутрішні номери — таблиця показує всіх активних співробітників і тих, кому номер ще не задано.
• Адреса для АТС або файл налаштування — щоб АТС повідомляла програму про кожен дзвінок у ту ж мить.
• Чек-лист — пройти й переконатися, що тестовий дзвінок дійшов до журналу.

Ключі APIСпосіб, яким програми обмінюються даними між собою напряму, без людини й без вікон: одна програма надсилає запит, інша відповідає даними. потрібні для дзвінків ваших співробітників. Голосовому AI-співробітнику вони не потрібні — що налаштувати для нього, дивіться в розділі «Ключі API чи голосовий AI».

Де це і хто має доступ

Меню

Кабінет → Налаштування системи → «Інші налаштування» → «Зовнішні сервіси та інтеграції» → група «Телефонія»

З журналу дзвінків

меню-бургер вікна → «Підключення телефонії»

Внутрішні номери

Кабінет → Налаштування системи → «Користувачі (співробітники)» → картка співробітника

Право доступу

вікно «API та токени доступу»; адресу й файл для АТС — ще й «Журнал дзвінків»

Підготувати

ключі API з кабінету оператора і внутрішні номери співробітників в АТС

У вікні «Зовнішні сервіси та інтеграції» група «Телефонія» має одинадцять рядків — десять операторів і «Рассылка SMS». SMS до телефонії відношення не має, це окремий сервіс зі своєю формою.

Крок 1. Вписати ключі оператора

Відкрийте свого оператора в групі «Телефонія», увімкніть перемикач активності й впишіть ключі. Над полями — підказка «Ключі доступу берете в кабінеті оператора.» і посилання «Де саме — покроково в інструкції для вашого оператора»: воно веде на сторінку саме вашого оператора, де покроково показано, що натиснути в його кабінеті.

1

Заголовок групи «Телефонія»

2

Рядок Binotel

3

Рядок «Рассылка SMS»

1. Заголовок групи «Телефонія» — усі оператори телефонії зібрані в одну групу списку.
2. Рядок Binotel — один із восьми операторів групи.
3. Рядок «Рассылка SMS» — сусідній сервіс у тій самій групі, це не телефонія.

Що саме вписувати, залежить від оператора — форма підставляє його підписи сама:

Нижче — поле «Номер лінії для вихідних»: з якого свого номера телефонувати клієнту. Залишите порожнім — АТС обере сама. Винятки:

• у Phonet, UniTalk і 3CX цього поля немає: їхній API номера лінії не приймає;
• у Ringostat воно обовʼязкове — зворотний дзвінок Ringostat починається з номера проєкту, і його треба вказати саме тут;
• в Asterisk є ще два поля зі значеннями за замовчуванням: «Канал співробітника» (Local/{ext}@from-internal) і «Контекст діалплану» (from-internal); у більшості установок FreePBX їх міняти не треба.

1

Перемикач активності

2

Поле «API-ключ (key)»

3

Поле «Номер лінії для вихідних»

4

Кнопка «Перевірити підключення»

1. Перемикач активності — вмикає/вимикає інтеграцію з оператором.
2. Поле «API-ключ (key)» — сюди вставляється ключ, який видає оператор.
3. Поле «Номер лінії для вихідних» — з якого номера дзвонити клієнту; порожньо — АТС обере сама.
4. Кнопка «Перевірити підключення» — перевіряє звʼязок з АТС на введених ключах.

Форма зберігається сама приблизно через секунду після правки — унизу вікна видно «Збереження...», а потім «Збережено». Окремої кнопки збереження немає.

Наприкінці натисніть «Перевірити підключення». Програма запитає в оператора список співробітників — у вашому кабінеті вона при цьому нічого не змінює — і відповість «Звʼязок з АТС встановлено. Співробітників в АТС: ‹кількість›».

Окремим рядком вона покаже «Номери АТС без співробітника Elbuz: …» — це ті внутрішні номери, яким не відповідає жодна карточка. Готовий перелік того, що треба доробити на другому кроці.

Крок 2. Задати внутрішні номери співробітникам

Внутрішній номер — це те, за чим АТС розуміє, кому дзвонити першим, а Elbuz розуміє, хто говорив. Задається він у карточці співробітника: Кабінет → Налаштування системи → «Користувачі (співробітники)» → карточка → секція «Контакти» → поле «Телефон внутрішній». Поле це існувало й раніше, телефонія просто почала ним користуватися.

1

Підказка, де задається номер

2

Стовпець «Внутрішній номер»

3

Рядок з прочерком замість номера

1. Внутрішній номер співробітника задається в його картці (Установки → Користувачі → поле «Внутрішній номер»).
2. У цьому стовпці відображається внутрішній номер кожного менеджера.
3. Прочерк означає, що номер ще не призначено — співробітник не зможе дзвонити з інтерфейсу.

Щоб не ходити по карточках наосліп, у формі підключення є картка «Внутрішні номери співробітників»: таблиця з двох стовпців — «Менеджер» і «Внутрішній номер» — по всіх активних співробітниках. У кого номера немає, у другому стовпці стоїть прочерк; такі рядки йдуть у кінці списку. Поки хоч в одного номер порожній, підказка над таблицею підсвічена попереджальним кольором.

Крок 3. Налаштувати, щоб АТС повідомляла про дзвінки

Тут два різні варіанти, і який ваш — вирішує оператор, а не ви.

• Оператор приймає адресуBinotel, Zadarma, Ringostat, Phonet, UniTalk, sipgate, Aircall: копіюєте готову адресу з форми і передаєте її оператору
• АТС налаштовується файлом3CX і Asterisk: завантажуєте готовий файл і додаєте його у свою АТС

RingCentral у жоден із варіантів не потрапляє: адресу в кабінет RingCentral вписувати не треба, підписку на події Elbuz створює сам після «Перевірити підключення» і сам її продовжує.

Оператор приймає адресу

У формі є картка «Адреса для вебхука АТС» з полем тільки для читання й кнопкою «Скопіювати» — після натискання спливає «Адресу скопійовано».

Підказка каже, що з цією адресою робити: «Скопіюйте адресу і вставте її в кабінеті оператора в налаштуваннях сповіщень (вебхуків) про дзвінки — де саме, показано в інструкції для вашого оператора (посилання вище).» Де це місце в кабінеті кожного оператора — на сторінках Binotel, Zadarma, Ringostat, Phonet, UniTalk, sipgate і Aircall.

1

Поле адреси

2

Кнопка «Скопіювати»

1. Поле адреси — містить готове посилання для АТС, ключ обезличено (демо-тенант).
2. Кнопка «Скопіювати» — копіює адресу в буфер обміну для передачі оператору.

Адресу видає сервер, і всередині неї — секретний ключ із 32 знаків. Створюється він один раз, при першому відкритті форми, і далі не змінюється. Тому адресу передають оператору й більше нікому: той, хто її знає, може надсилати вам події від імені АТС.

АТС налаштовується файлом

У 3CX і Asterisk замість адреси картка «Файл налаштування для АТС» і кнопка «Завантажити файл налаштування». 3CX отримує XML-шаблон інтеграції з CRMОблік клієнтів і роботи з ними: контакти, історія замовлень, листування, дзвінки, задачі й угоди в одному місці., який завантажують у консоль керування АТС; Asterisk — шматок діалплану, який вставляють у конфігурацію свого сервера. Адреса приймача і ключ уже всередині файла, заповнювати нічого не потрібно.

1

Заголовок «Файл налаштування для АТС»

2

Кнопка «Завантажити файл налаштування»

1. 3CX налаштовується файлом, а не адресою вебхука — це видно з окремого заголовка картки.
2. Кнопка завантажує готовий файл налаштування з адресою і ключем усередині.

Як переконатися, що телефонія працює

Пройдіть список після налаштування — відмітки зберігаються у вашому браузері. Останній пункт необовʼязковий: AI-розбір дзвінків вмикається в тій самій формі оператора.

Сценарії

Переходите на іншого оператора, і якийсь час працюють обидва

Що зробити. У групі «Телефонія» вікна «Зовнішні сервіси та інтеграції» тримайте в обох операторів увімкнений перемикач активності й вписані ключі. Новому операторові передайте адресу приймача або завантажте файл налаштування.

Що вийде. Журнал наповнюють події від обох операторів, а щогодинна звірка обходить обидва сервіси. Одна й та сама розмова двічі не запишеться: рядок упізнається за сервісом і номером дзвінка в АТС.

Чого не буде. Кнопка «Подзвонити» працює тільки через одного з них, і вибрати оператора для окремого дзвінка не можна.

Щоб набирати через нового, вимкніть перемикач активності в старого — після цього події від старого оператора програма відкидає, і звірка до нього теж не ходить. Записи його дзвінків, посилання на які не збережене в журналі, теж більше не відкриються — програма відповість «Запис розмови недоступний».

Магазин переїхав на новий домен

Що зробити. Відкрийте форму свого оператора, скопіюйте адресу з картки «Адреса для вебхука АТС» і вставте її в кабінеті оператора замість старої. Для 3CX і Asterisk завантажте файл налаштування заново.

Що вийде. Дзвінки знову зʼявляються в журналі в момент дзвінка, а картка «Вхідний дзвінок» спливає менеджерам.

Чого не буде. Програма не попередить, що адреса в оператора застаріла: дзвінки просто перестануть надходити. Тому адресу передають одразу після зміни домену.

Часті запитання

Ключі вписав, помилки немає, а дзвінки не працюють. Чому?

Найчастіше ключ вставлено не в те поле або це ключ WebSocket замість REST API — форма такий ключ збереже мовчки. Натисніть «Перевірити підключення»: без відповіді «Звʼязок з АТС встановлено» далі не йдіть (крок 1).

Чи запрацює 3CX або Asterisk, що стоїть в офісі?

Тільки якщо АТС доступна з інтернету. На адреси локальної мережі програма не звертається, і кнопка «Подзвонити» не спрацює (файл налаштування).

Чи можна передати адресу приймача підряднику, щоб він налаштував АТС?

Передавайте її тільки в кабінет оператора. В адресі зашитий секретний ключ: той, хто її знає, може надсилати вам події від імені АТС.

Чи можна змінити ключ в адресі для вебхука?

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

Чи потрібні ключі API, якщо на дзвінки відповідатиме голосовий AI?

Ні. Голосовому AI достатньо переадресації номера в кабінеті оператора. Ключі потрібні, щоб у журнал потрапляли дзвінки менеджерів (ключі API чи голосовий AI).

Суміжні теми

• Якщо потрібна загальна картина — як програма впізнає клієнта й менеджера і що вміє кожен оператор: Телефонія в Elbuz.
• Якщо не знаєте, де в кабінеті оператора ключі й налаштування вебхуків, — сторінка вашого оператора, наприклад Binotel чи Zadarma; решта — у таблиці операторів.
• Якщо підключення готове і менеджери починають дзвонити — як дзвонити з Elbuz і бачити, хто телефонує.
• Якщо кнопка дзвінка видає помилку або дзвінок не зʼявився в журналі — що робити, коли телефонія не працює.