Телефонія: Zadarma

Доповнення «Телефонія: Zadarma» підключає до магазину хмарну АТС Zadarma. Менеджери телефонують покупцям кнопкою з панелі, бачать картку абонента, поки дзвонить телефон, а розмови із записами потрапляють у картку покупця. Як усе це виглядає в магазині, описано на загальній сторінці Дзвінки й телефонія. Тут — як підключити саме Zadarma.

Що потрібно заздалегідь#

• Обліковий запис Zadarma з підключеною віртуальною АТС і внутрішніми номерами для співробітників. Внутрішній номер — це телефон співробітника в АТС: застосунок Zadarma на смартфоні, програма на комп'ютері чи SIP-телефон.
• Міський (віртуальний) номер Zadarma, якщо покупці телефонуватимуть вам. Без нього телефонувати можна лише самим, кнопкою «Зателефонувати».
• Гроші на балансі Zadarma: дзвінки кнопкою оплачуються за тарифом оператора.
• Магазин, відкритий з інтернету: Zadarma повідомляє про дзвінки за посиланням магазину. Поки триває оновлення магазину, посилання не відповідає.

Крок 1. Ключі API в кабінеті Zadarma#

В особистому кабінеті Zadarma відкрийте сторінку ключів API (https://my.zadarma.com/api/) і створіть ключі. Ви отримаєте два рядки: ключ (Key) і секрет (Secret). Скопіюйте обидва повністю.

Секретом Zadarma підписує кожне сповіщення про дзвінок, а магазин цей підпис перевіряє. Якщо пізніше ви створите нові ключі, замініть їх і в магазині, інакше магазин перестане приймати дзвінки.

Крок 2. Підключення в магазині#

1. Встановіть доповнення «Телефонія: Zadarma» у «Налаштування платформи» → «Платформа» → «Встановлення та оновлення».
2. Відкрийте «Налаштування платформи» → «Налаштування магазину» → «Телефонія» і натисніть «Підключити АТС».
3. У полі «Оператор» виберіть Zadarma. Поле «Назва» можна лишити як є.
4. У блоці «Доступ до АТС» вставте «Ключ API» і «Секрет API» з кроку 1.
5. Натисніть «Зберегти». Панель перезавантажиться, і в меню з'явиться розділ «Дзвінки».
6. Натисніть «Перевірити доступ». Якщо все правильно, магазин відповість «Zadarma на зв'язку. Баланс: …».

Крок 3. Посилання для сповіщень про дзвінки#

Щоб магазин дізнавався про дзвінки, Zadarma має знати його посилання. Його показує блок «Посилання для сповіщень про дзвінки».

Найпростіше натиснути «Прописати в АТС». Магазин сам збереже посилання в Zadarma й увімкне шість сповіщень: про початок і завершення вхідного дзвінка, про початок і завершення вихідного, про дзвінок на внутрішній номер і про відповідь. Zadarma одразу перевіряє посилання, відкриваючи його, тому кнопка спрацює, лише якщо магазин доступний з інтернету.

Можна й вручну. У кабінеті Zadarma, у розділі «Інтеграції та API», знайдіть сповіщення про дзвінки в АТС, натисніть «Скопіювати» в магазині й вставте посилання. Увімкніть ті самі шість сповіщень:

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

Сповіщення про готовий запис розмови окремо вмикати не потрібно: про запис Zadarma повідомляє разом із завершенням дзвінка.

Крок 4. Внутрішні номери співробітників#

У блоці «Співробітники та внутрішні номери» натисніть «Додати співробітника». У першому полі магазин запропонує номери, які є у вашій АТС Zadarma (наприклад, 100, 101, 102), у другому виберіть співробітника. Натисніть «Зберегти».

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

Крок 5. Запис розмов#

Записи розмов Zadarma робить, якщо запис увімкнено на внутрішньому номері. Увімкніть його в кабінеті Zadarma, у налаштуваннях внутрішніх номерів АТС, причому зі збереженням записів у Zadarma, а не лише з надсиланням на пошту: магазин бере запис зі сховища Zadarma. Без цього дзвінки в магазині будуть, а кнопки «Прослухати» — ні.

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

Як це працює#

Вхідний дзвінок. Покупець телефонує на міський номер. Zadarma повідомляє магазину про дзвінок, а магазин передає їй ім'я покупця: воно з'являється в застосунку Zadarma в менеджера, навіть якщо в панелі цей покупець йому не видимий. У панелі менеджерів, чий телефон дзвонить, з'являється картка абонента. Коли розмова завершиться, дзвінок опиниться в журналі й у картці покупця. Якщо ніхто не відповів, він потрапить у «Передзвонити».

Дзвінок кнопкою. Менеджер натискає кнопку дзвінка в замовленні, профілі покупця чи угоді. Zadarma спершу дзвонить на його внутрішній номер, а коли він зніме слухавку, набирає покупця. Якщо на внутрішньому номері ніхто не відповість, покупцеві дзвонити не будуть.

Переведення дзвінка. Якщо дзвінок перевели на іншого співробітника, у журналі дзвінок буде за тим, хто договорив останнім.

Часті проблеми#

«Zadarma не прийняла ключ і секрет. Перевірте, що обидва скопійовано повністю». Ключ чи секрет вставлено не повністю або їх видалили в кабінеті. Скопіюйте заново з кроку 1. Обидва рядки довгі, і під час копіювання легко загубити останні символи.

«Zadarma не змогла відкрити посилання магазину. Магазин має бути доступний з інтернету; під час оновлення магазину посилання не відкривається. Відповідь Zadarma: …» — після натискання «Прописати в АТС». Zadarma перевіряє посилання одразу й не достукалася до магазину. Перевірте, що магазин відкривається ззовні за своєю адресою, і повторіть.

«Забагато запитів до Zadarma поспіль. Зачекайте хвилину й повторіть». Zadarma обмежує кількість запитів на хвилину. Повторіть за хвилину.

«Zadarma не відповідає. Спробуйте ще раз за хвилину». Сервіс тимчасово недоступний або магазин не може до нього достукатися.

«Zadarma відмовила: …». Zadarma відхилила запит і пояснює причину після двокрапки. Під час дзвінка кнопкою цей текст стоїть після «АТС не почала дзвінок:». Перевірте в кабінеті Zadarma баланс і сам внутрішній номер співробітника.

Дзвінки не з'являються в журналі. Перевірте крок 3: посилання збережене в Zadarma, сповіщення про дзвінки ввімкнені. Якщо в «Налаштування платформи» → «Система» → «Журнали» є записи «Telephony: notification rejected», магазин не впізнав підпис Zadarma: секрет у магазині не той, що в кабінеті. Вставте ключі заново.

Запис не грає. Одразу після розмови запису ще немає: Zadarma готує його близько хвилини. Якщо кнопки «Прослухати» немає зовсім, перевірте крок 5 і право «Слухати записи розмов» у вашої ролі.

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