Телефония: 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 и право «Слушать записи разговоров» у вашей роли.

В карточке звонящего «Новый номер», хотя покупатель известен. Магазин ищет покупателя по номеру телефона в его карточке. Проверьте, что номер в карточке записан правильно, вместе с кодом страны.