Для чого
Замість двох кабінетів і ручного копіювання адрес — пʼять кроків: оператор, ключ API, номери, вихідна лінія, результат. Акаунт і номери лишаються вашими в операторі; ми лише налаштовуємо їх вашим ключем, а ключ зберігаємо зашифрованим і нікому не показуємо. Для UniTalk, Київстару й інших операторів без API майстер показує, що написати оператору, і відкриває звичайну форму підключення з обраним оператором. Автоматичні оператори позначені «бета»: адаптери написано за документацією, і перше справжнє підключення ми перевіряємо разом із вами. Змінює лише адміністратор.
Що на екрані
- 1
Кроки підключення
Де ви зараз: оператор, ключ API, номери, вихідна лінія, готово. Під кроками — наша SIP-адреса, на яку оператор надсилатиме дзвінки: сервер не реєструється в операторі, тож у переліку лише ті, хто вміє слати дзвінок на сталу адресу.
- 2
Оберіть оператора
Картки операторів з країнами, де вони дають номери. «бета — перевіряємо на першому підключенні» — налаштуємо самі вашим ключем; «вручну» — покажемо інструкцію. Twilio не має українських номерів.
- 3
Ключ API
Поля ключа саме цього оператора і «Де взяти ключ» — кроки в його кабінеті. Ключ спершу перевіряємо в операторі, потім зберігаємо зашифрованим; після збереження видно лише «ключ збережено». «Забути ключ» не відключає вже підключених номерів.
- 4
Номери
Номери вашого акаунта в операторі: країна, тип і куди номер веде зараз. «уже підключено» — номер уже в нашому підключенні цього оператора; «у підключенні …» — він в іншому вашому підключенні, і спершу його треба прибрати звідти.
- 5
Вихідна лінія і «Підключити»
Що саме зробимо, і чи налаштовувати вихідну лінію. Для Twilio і Telnyx логін і пароль для вихідних створюємо самі; для Zadarma і DIDWW їх треба вписати з кабінету оператора. Вихідна лінія у воркспейсу одна — якщо вона вже є через іншого оператора, майстер попередить.
- 6
Результат
Кожен крок із позначкою: зелена галочка — зроблено, номер — лишилося зробити вам, з точним значенням і місцем у кабінеті оператора. Останній крок завжди один: подзвонити на номер і переконатися, що агент відповідає.
- 7
Підключення вручну
Для операторів без API: що написати менеджеру чи зробити в кабінеті, з нашою адресою вже підставленою, і кнопка, що відкриває форму підключення з обраним оператором.
Типові дії
Підключити номер Zadarma
- У кабінеті Zadarma відкрийте сторінку ключів API (my.zadarma.com/api/) і створіть ключі — Key і Secret.
- Тут оберіть «Zadarma», вставте обидва значення й натисніть «Перевірити й зберегти ключ».
- Позначте номери й натисніть «Далі: вихідна лінія».
- За бажанням оберіть «І вихідна лінія через Zadarma» і впишіть логін і пароль SIP з «Налаштування → SIP-підключення». Натисніть «Підключити».
- Подзвоніть на номер — дзвінок має зʼявитися в «Дзвінках».
Дописати номер, куплений пізніше
- Купіть номер у кабінеті оператора.
- Відкрийте «Підключити оператора» і того самого оператора — ключ уже збережено.
- Позначте новий номер і натисніть «Підключити». Вже зроблене не повториться: номер додасться до наявного підключення.
Підключити оператора без API (UniTalk, Київстар)
- Оберіть оператора й виконайте кроки з інструкції: попросіть SIP-транк без реєстрації на нашу адресу і перелік IP-адрес оператора.
- Натисніть «Відкрити форму підключення» — оператор уже обраний.
- Впишіть номери й адреси від оператора та натисніть «Підключити номер».
Часті питання
Навіщо давати вам ключ API оператора? Що ви з ним робите?
Лише три речі: показуємо номери вашого акаунта, спрямовуємо обрані номери на наш сервер і, якщо ви попросили, налаштовуємо вихідну лінію. Нічого не купуємо і нічого не видаляємо. Ключ зберігаємо зашифрованим; показати його назад не може ніхто. Не хочете давати ключ — усе те саме робиться вручну на сторінці «Телефонний номер».
Що означає «бета — перевіряємо на першому підключенні»?
Налаштування написане за документацією оператора і ще не проходило через справжній акаунт. Найімовірніше місце розбіжності — перелік IP-адрес, з яких оператор надсилає дзвінки. Якщо перший дзвінок не дійде, напишіть у підтримку з часом дзвінка: ми звіримо адресу й допишемо її.
Натиснув «Підключити» двічі. Нічого не задвоїлося?
Ні. Транк чи зʼєднання в операторі шукаємо за назвою callbridge-… і використовуємо наявне, а в нашій системі оновлюємо те саме підключення: номери й адреси додаються, а не замінюються.
Результат каже «зробіть вручну». Чому?
Оператор відмовив на якомусь кроці — наприклад, номер ще не активний або підключений до його віртуальної АТС. Наше підключення вже створене; біля кроку написано, що саме і де зробити. Коли причину усунено, натисніть «Підключити» ще раз.
Чому немає Binotel чи Ringostat?
Це АТС, а не оператори, що вміють слати дзвінок на сталу SIP-адресу. Підключіть номер будь-якого оператора з переліку й налаштуйте у своїй АТС переадресацію на нього.