Интеграции · Автоматизация
ProZvonki отправляет данные о телефонных звонках на ваш HTTPS-адрес: направление, результат, длительность, номер, SIM и при необходимости имя контакта. Запись разговора приходит отдельным multipart-запросом. Так Android-звонилку можно связать с n8n, Make, своей CRM, ботом или собственным сервером.
WebHook не привязан к конкретной CRM. Принимающей стороной может быть сценарий n8n или Make, ваша внутренняя система, Telegram-бот, аналитика, helpdesk или API собственной CRM. Достаточно HTTPS-адреса, который принимает POST-запросы.
call_finished отправляется после завершения подходящего звонка. Если нужен сценарий в реальном времени, включите отдельное событие call_started для входящих и исходящих вызовов. Оба события связаны одним стабильным call_id.
JSON содержит уникальный event_id, направление, результат, кто завершил разговор, номер или признак скрытого номера, длительность, время UTC, слот SIM и заданную вами метку SIM. Имя контакта можно передавать только по отдельному переключателю.
На телефоне с двумя SIM можно отправлять события только с выбранной рабочей SIM или с обеих. Для каждого слота задаётся произвольная метка — например, отдел, оператор или рабочий номер. Она приходит в поле sim_label.
Если в ProZvonki включены запись звонков и переключатель «Передавать запись разговора», после появления аудио отправляется отдельное событие recording_ready. Запрос использует multipart/form-data: JSON находится в части payload, а бинарный файл — в recording. Это не раздувает файл Base64-кодированием.
События отправляются в фоне. При временном отсутствии сети, тайм-ауте или временной ошибке сервера приложение повторяет доставку. Для записи используется долговременная очередь, переживающая перезапуск приложения и телефона. Возможны повторные запросы, поэтому обработчик должен сохранять event_id и не выполнять одно действие дважды.
Используйте HTTPS. Если обработчик требует авторизацию, укажите токен: ProZvonki добавит заголовок Authorization: Bearer <token>. URL и токен сохраняются в защищённых настройках приложения. Проверить адрес можно тестовым событием до первого реального звонка.
FAQ
После звонка отправляется call_finished. По желанию отдельно отправляется call_started, а после появления записи разговора — multipart-событие recording_ready.
Нужен доступный HTTPS URL. Это может быть собственный сервер, n8n, Make или другой сервис, способный принять POST с JSON и multipart/form-data.
Отдельным multipart-запросом: JSON-метаданные находятся в части payload, бинарный аудиофайл — в части recording. Base64 не используется.
Приложение сохраняет задания и повторяет отправку при временных сетевых и серверных ошибках. Сервер должен безопасно принимать повтор одного event_id.
Используйте HTTPS и при необходимости Bearer-токен. URL и токен хранятся на устройстве в защищённом виде. Не размещайте секрет в общедоступном адресе или журнале сервера.
Битрикс24 и amoCRM получают готовые CRM-действия: карточки, звонки, сделки и задачи. WebHook передаёт универсальные события на ваш адрес, а логику обработки вы создаёте сами.
