Новофон: авторизация и уведомления звонком

Авторизация и уведомления звонком: Новофон — это высоконадежное каскадное решение для интернет-магазинов на платформе Shop-Script. Плагин позволяет многократно сократить расходы на рассылки, совершая экономный голосовой звонок клиенту через телефонию Новофон (UIS/CoMagic) и отправляя резервное СМС только в случае, если покупатель не взял трубку. Также плагин включает в себя функцию умного входящего голосового ассистента для автоматического озвучивания статуса заказа звонящему клиенту перед переводом вызова на оператора.

? Ключевые возможности и настройки плагина:

• Интеллектуальный каскад (Звонок ➔ СМС): Полная автоматизация. Плагин отправляет голосовой вызов. Если покупатель сбрасывает звонок, занят или не отвечает — система мгновенно перенаправляет сообщение в виде резервного СМС через любого выбранного вами провайдера.
• Интеллектуальный входящий голосовой ассистент (Внешний IVR): Когда клиент звонит вам, АТС Новофон автоматически обращается к вашему сайту, находит активный заказ клиента и зачитывает ему статус слитным, естественным голосом робота-помощника перед тем, как соединить с менеджером.
• Раздельный выбор шлюзов для СМС-резерва: Вы можете гибко назначить различные резервные СМС-адаптеры: один для статусных уведомлений о заказах (например, через плагин с низкой стоимостью символа), а другой — для критически важных OTP-кодов авторизации.
• Ограничение попыток дозвона: Укажите лимит попыток звонка в настройках. Если клиент исчерпал этот лимит (например, вызовам мешает режим «Не беспокоить»), плагин мгновенно отправит стандартное СМС без повторных попыток звонков.
• Борьба с автоответчиками операторов (Таймаут дозвона): Установите точное время дозвона в секундах (рекомендуется 20 секунд). Плагин автоматически прервет звонок до того, как сработает голосовая почта или виртуальные ассистенты (такие как «Олег» или «Марчелло»), предотвращая ложные отметки об успешном звонке и гарантируя своевременную отправку СМС-дубликата.
• Гибкое применение таймаута: Специальный переключатель в настройках позволяет решать, применять ли защитный 20-секундный лимит к OTP-кодам авторизации или оставить его только для информационных сообщений о заказах.
• Универсальное и гибкое управление озвучкой статусов: Плагин автоматически определяет абсолютно все статусы вашего магазина (включая любые ваши кастомные и новые статусы). Для каждого статуса вы получаете пару настроек:
  • Чекбокс включения/выключения озвучки для данного статуса.
  • Текстовое поле для ввода кастомной фразы (например, *«успешно оплачен и готовится к выдаче»*).
  Если чекбокс активен, но текстовое поле пустое, плагин автоматически и красиво произнесет оригинальное название статуса из админки в нижнем регистре.
• Умный голосовой движок (TTS): Текст автоматически адаптируется под речь:
  • Времена склоняются грамматически верно в родительном падеже (например, «до 21 часа» или «до 22 часов»).
  • Ссылки и доменные имена полностью вырезаются из голосового сообщения, чтобы автоинформатор не зачитывал клиенту лишний мусор.
  • Длинные номера заказов и коды авторизации разделяются точкой с запятой для премиального слитного проговаривания диктором строго по парам чисел (например, *«десять... ноль четыре... сорок... ноль девять»* для `10; 04; 40; 09`). Это полностью исключает ложные срабатывания робота на календарные даты или десятичные дроби!
• Удобная интеграция и вебхук: Адрес вебхука для интеграции с кабинетом Новофона вычисляется полностью автоматически под ваш домен. Поле настроек выведено в удобном формате только для чтения, что защищает от случайного изменения символов и позволяет быстро выделить ссылку.

? Где взять ключи для настройки плагина (в кабинете Новофон / UIS):

• API-ключ Новофон:
  Перейдите в личном кабинете Новофона в раздел «Администрирование» ➔ «Аккаунт» ➔ «API» (или раздел «Интеграции»). Создайте (сгенерируйте) новый API-ключ (токен доступа) и скопируйте его в настройки плагина. Он необходим сайту для авторизации запросов на звонки.
• Виртуальный номер:
  Перейдите в раздел «Номера» в кабинете Новофона и выберите любой ваш активный арендованный виртуальный номер телефона, с которого будут совершаться вызовы клиентам. Вставьте его в настройки плагина в международном формате (например, 78125076988).

?️ Инструкция 1: Настройка исходящего каскада «Звонок ➔ СМС» (Уведомление NOTIFY_OUT_END):

1. Зайдите в свой личный кабинет Новофона.
2. Перейдите в боковом меню в раздел «Уведомления».
3. Нажмите на кнопку создания нового уведомления и выберите тип события: «Завершение звонка» (системный код: NOTIFY_OUT_END).
4. В качестве канала отправки выберите «HTTP-уведомление» (Webhook).
5. В поле адреса вставьте «Адрес вебхука», скопированный из настроек плагина в панели управления вашим интернет-магазином Shop-Script.
6. Выберите метод отправки запроса: POST (наш вебхук автоматически поддерживает как стандартный POST-формат от Новофона, так и отправку сырых JSON-данных).
7. Сохраните настройки уведомления. Теперь Новофон будет мгновенно сообщать вашему сайту о результатах каждого сделанного звонка, а плагин при необходимости сразу запустит СМС-каскад!

? Инструкция 2: Настройка входящего голосового ассистента в Визуальной АТС (Внешний IVR):

Чтобы АТС зачитывала клиенту статус заказа перед соединением с менеджером, добавьте в сценарий Визуальной АТС Новофона блок «Внешний IVR» и настройте его строго по следующим параметрам:

1. Откройте сценарий вашей входящей схемы в редакторе Визуальной АТС Новофон.
2. Добавьте блок «Внешний IVR» перед блоком перевода на сотрудников.
3. В настройках добавленного блока выберите:
   • Метод: POST
   • URL для авторизации: вставьте ваш «Адрес вебхука» из настроек плагина (например, https://ваш-домен.ru/wa-plugins/sms/novofon/webhook.php).
   • Длина кода доступа / Межцифровой интервал: оставьте пустыми / не заданными.
   • Показывать при звонке: набранный номер.
4. КРАЙНЕ ВАЖНО: В таблице передаваемых параметров (внизу блока) обязательно **отметьте галочками** только следующие две мнемоники (остальные галочки снимите):
   • ✅ Номер абонента (мнемоника: numa) — необходим для автоматического поиска клиента в базе данных.
   • ✅ Идентификатор сессии звонка (мнемоника: call_session_id) — необходим для авторизации и управления сессией вызова.
5. Соедините блок «Внешний IVR» с остальными блоками. В случае успешного нахождения активного заказа робот зачитает клиенту его статус и звонок пойдет дальше. Если заказов нет — робот проиграет микро-паузу и переведет вызов по сценарию на шаг приветствия без единого сбоя.

Плагин поставляется с открытым исходным кодом, содержит встроенную конфигурацию базы данных для корректной установки и удаления Инсталлером, а также полностью защищен от прямого доступа к файлам кода. Сделайте ваши коммуникации с клиентами выгодными, надежными и по-настоящему технологичными!