Настройка модуля «Zvonok.com»

Подтверждение телефона через Zvonok.com — верификация звонком-сбросом. Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

Когда стоит подключать модуль

• Площадкам, которым нужны коды подтверждения, уведомления о заказах или служебные сообщения.
• Владельцам, которые хотят отделить важные системные уведомления от ручной переписки.
• Командам, которым важно проверить доставку сообщения на тестовом получателе до массовой отправки.

Что изменится на сайте

• ADWOS CMS отправляет сервисные уведомления через «Zvonok.com».
• Можно проверить доставку кода, сообщения или админского оповещения на тестовом получателе.
• Владелец контролирует отправителя, токены, лимиты и стоимость сообщений.
• Пользователи получают важные уведомления в привычном канале.

Что подготовить заранее

Подготовьте доступы и тестовые данные до включения модуля. Так вы проверите сценарий спокойно и не затронете реальные заказы, пользователей или публичные страницы.

• Создайте кабинет, бота, отправителя или канал у провайдера «Zvonok.com».
• Подготовьте токен, идентификатор отправителя, chat_id, номер или другой реквизит, который требует модуль.
• Проверьте баланс, лимиты, правила шаблонов и разрешения на отправку сервисных сообщений.
• Выберите тестового получателя и не запускайте массовую отправку до успешной проверки.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «Zvonok.com» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

В настройках модуля заполняйте только те значения, которые относятся к вашему проекту. Секретные ключи храните в защищенных полях и не переносите их в открытые тексты, письма или инструкции для пользователей.

• «API-ключ Zvonok.com». Секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Используется в режиме flash-call
• «ID кампании». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Используется в режиме flash-call
• «Количество цифр для flash-call». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 4.
• «Номер для входящего звонка». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Показывается пользователю в режиме «Входящий звонок». Пользователь звонит на этот номер, и платформа проверяет CallerID.
• «Время жизни верификации (секунды)». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 300.
• «Режим верификации». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: flashcall.
• «Секрет вебхука». Секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. HMAC-SHA256 от тела POST в заголовке X-Zvonok-Signature. Если пусто, проверка отключена.

После сохранения обновите страницу панели управления и убедитесь, что модуль остался включенным. Если есть тестовый режим, сначала завершите проверку в нем, а уже потом переходите на боевые ключи.

Проверка перед запуском

• Отправьте тестовое уведомление на свой номер, аккаунт или канал.
• Проверьте статус доставки в ADWOS CMS и в кабинете провайдера.
• Убедитесь, что текст сообщения не содержит тестовых данных и понятен пользователю.
• Проверьте ошибку при неверном получателе или пустом токене.

Частые ошибки

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

Когда тест проходит без ошибок, оставьте модуль включенным и зафиксируйте, какие данные использовались для проверки. Это поможет быстро восстановить настройку после обновления или смены ключей.