Данные и интеграции · сверено 16.10.2026
Как передавать заявки из AppsMax в свою систему
AppsMax сообщит вашей системе о новой заявке. Узнайте, что настроить в кабинете, что поручить специалисту и как проверить доставку.
У ПОЛУЧАТЕЛЯ
Отправить ≠ проверить получение
01 / Сначала задача
Когда нужен такой обмен
Короткий ответ. AppsMax отправляет сообщение о заявке на защищённый адрес вашей системы. Этот способ называется исходящий webhook. На стороне получателя должен быть обработчик, который принимает сообщение и отвечает, что оно получено. Одной настройки адреса в AppsMax недостаточно.
Используйте его, если новая заявка или смена её статуса должна появляться в вашей учётной системе сразу после события в AppsMax. Если команда работает с заявками только в AppsMax, внешнее подключение не требуется. Если нужен лишь короткий лид в Битрикс24, сначала проверьте прямой путь без собственного обработчика. Для обмена с другой CRM или особой логики понадобится приём на вашей стороне.
Здесь AppsMax сообщает о событии. Если ваша система должна сама запрашивать или изменять данные в AppsMax, это другая задача — REST API. Сравните способы передачи, прежде чем начинать разработку.
02 / Разделим ответственность
Кто что готовит
- Вы или владелец организации
- Определяете, какое событие нужно, кому показывать заявку и кто проверит результат. В кабинете AppsMax сохраняете адрес и запускаете тест. Для управления webhook нужны права владельца и действующий доступ к интеграциям.
- Ваш специалист или команда внедрения
- Готовит публичный HTTPS-адрес для приёма, проверяет подпись запроса и обрабатывает повторы так, чтобы не создавать дубли. Согласует с вами, какие поля сохранять и как защищать личные данные.
- AppsMax
- Отправляет выбранные события, показывает результат попытки в журнале и повторяет доставку при некоторых временных ошибках. AppsMax не создаёт за клиента внешний сервер, правила обработки заявок или учётные записи в чужой системе.
Если своего специалиста нет, обсудите платное внедрение. Цена платформы и работы по подключению считаются отдельно.
03 / На своей стороне
Настройте отправку в AppsMax
Сначала черновик.
Потом — включение.
- Откройте «Данные → API и интеграции → Webhook» от имени владельца организации.
- Создайте новый webhook и выберите «Своя система (JSON)». Укажите подготовленный получателем HTTPS-адрес без логина и пароля. Адрес должен быть публичным: localhost, внутренние и зарезервированные IP не подходят. Если домен не удаётся проверить через DNS, исправьте его до сохранения. AppsMax не переходит по перенаправлениям при доставке. Не помещайте пароль или токен в адресную строку.
- Выберите только нужные события: «Новая заявка», «Статус заявки изменён» или «Данные заявки изменены». Для каждого события получатель должен знать, что делать.
- Согласуйте со специалистом «Секрет подписи» в дополнительных настройках. Его проверяют на сервере получателя; не отправляйте секрет в открытый чат или снимок экрана.
- Снимите отметку «Включить после сохранения». Сначала сохраните и проведите отдельный тест, затем включите настоящие события.
«Посмотреть пример данных» показывает образец без отправки получателю. Кнопка «Проверить» действительно отправляет отдельное тестовое событие: получатель может сохранить его как запись. Убедитесь, что он готов отличать тест от настоящей заявки. По действующей сетке AppsMax интеграции доступны начиная с «Автоматизации»; сверьте текущие условия.
04 / Два подтверждения
Проверьте доставку с обеих сторон
- Перед тестом попросите специалиста подтвердить, что приёмник готов и проверяет подпись, если она настроена.
- Один раз нажмите «Проверить». В AppsMax посмотрите ответ, код и время в журнале.
- На стороне получателя найдите это тестовое событие и проверьте, что оно не стало настоящей заявкой.
- Если ответ в кабинете не появился, сперва проверьте журнал и свою систему. Повторный тест может создать ещё одну запись у получателя.
После успешного теста включите настройку и отправьте контрольную заявку на собственных данных. Сверьте её в AppsMax и внешней системе. Только затем подключайте рабочий поток.
05 / Та же заявка, не новая
Почему сообщение может прийти повторно
Для ответов 408, 429, 5xx и временных сетевых сбоев предусмотрены повторы — не более пяти попыток. Другие 4xx не повторяются. Обработчик должен узнавать уже принятую заявку и событие, а не создавать запись при каждой попытке. Один номер заявки не различает все её изменения: специалист сверяет event, application.id и фактическое состояние объекта; отдельный стабильный delivery_id сейчас не публикуется. Ответ 2xx подтверждает HTTP-приём запроса, но не сохранение или правильную обработку заявки в вашей системе. Ошибка или потерянный ответ также не доказывают, что данные не сохранились.
Для специалиста точные заголовки, подпись, поля, допустимые ответы и интервалы повторов опубликованы в контракте исходящих webhook AppsMax. Это технический источник, а не обязательное чтение для регистрации клиента. Если требуется надёжная обработка, специалист сверяет реализацию с ним и текущим журналом.
06 / Рабочий поток
Что делать дальше
После проверки оставьте только действительно нужные события и назначьте человека, который будет смотреть ошибки доставки. Если маршрут больше не нужен, выключите webhook в AppsMax; при утечке адреса или секрета замените их и на стороне получателя. Полную заявку и историю продолжайте проверять в AppsMax: факт отправки не заменяет работу с обращением.
Ещё не работаете в платформе? Создайте аккаунт и начните с одной заявки. Уже знаете, куда передавать данные, но обработчик не готов? Расскажите нам о системе и нужных полях — оценим отдельное внедрение без обещания «подключения в один клик».
Порядок и ограничения сверены 16 октября 2026 года. Перед запуском внешнего обмена повторно проверьте продукт, тариф и обработчик получателя.