Интеграция ID Mobile с Tolda для push-уведомлений

Настройка автоматической отправки push-уведомлений через сервис ID Mobile при получении заявки с формы на сайте Tolda - востребованная задача для повышения конверсии и безопасности. В этой инструкции разберём, как объединить два сервиса, чтобы после отправки формы клиенту приходило подтверждение номера телефона.

Зачем нужна интеграция ID Mobile и Tolda

Связка ID Mobile с Tolda позволяет автоматизировать верификацию клиентов. После того как пользователь заполняет форму заявки (например, на покупку или консультацию), система отправляет push-уведомление с кодом подтверждения. Это снижает риск мошенничества и ускоряет обработку лидов.

Подготовка к интеграции

Перед началом убедитесь, что у вас есть:

• Аккаунт в ID Mobile с доступом к API и настроенным шаблоном push-уведомления.
• Аккаунт в Tolda с подключённым доменом и активной формой заявки.
• API-ключи от ID Mobile (обычно токен авторизации).

Пошаговая настройка

Шаг 1. Создание вебхука в Tolda

В панели управления Tolda перейдите в раздел «Интеграции» → «Вебхуки». Создайте новый вебхук для события «Отправка формы». Укажите URL-адрес, на который будут отправляться данные (эндпоинт вашего скрипта или сервера).

Шаг 2. Разработка скрипта-обработчика

Вам понадобится промежуточный скрипт (например, на PHP или Node.js), который будет принимать POST-запрос от Tolda, извлекать номер телефона из данных формы и отправлять запрос к API ID Mobile. Пример логики на PHP:

<?php
$phone = $_POST['phone']; // номер из формы
$apiKey = 'ваш_api_ключ';
$url = 'https://api.id-mobile.ru/v1/push/send';
$data = [
  'phone' => $phone,
  'message' => 'Ваш код подтверждения: 1234'
];
$options = [
  'http' => [
    'header' => "Authorization: Bearer $apiKey
Content-Type: application/json",
    'method' => 'POST',
    'content' => json_encode($data)
  ]
];
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
?>

Шаг 3. Тестирование отправки

Заполните тестовую форму на сайте. Проверьте, что вебхук сработал, а скрипт корректно передал номер в ID Mobile. В личном кабинете ID Mobile убедитесь, что push-уведомление доставлено.

Шаг 4. Обработка ошибок

Добавьте в скрипт логирование: записывайте ответы от API ID Mobile и ошибки. Это поможет быстро выявить проблемы, например, неверный формат номера или превышение лимитов.

Возможные проблемы и их решение

• Не приходит push-уведомление - проверьте, что номер телефона передан в международном формате (например, +79123456789).
• Ошибка авторизации API - обновите API-ключ в скрипте и убедитесь, что он активен.
• Вебхук не срабатывает - в Tolda проверьте, что вебхук включён и URL указан без опечаток.

Советы по оптимизации

Для ускорения работы используйте асинхронную обработку запросов (например, через очередь задач). Также настройте повторную отправку уведомления при неудаче - это повысит надёжность интеграции ID Mobile с Tolda.