Приём и отправка вебхуков с проверкой подписи

Интеграция по вебхукам с Битрикс24, amoCRM и 1С: связки под ключ

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

Зачем это вам

Что даёт связка с вебхуками

Связка там, где нет коннектора

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

Поля разбираются под вашу систему

Из пришедшего сообщения берутся нужные значения и раскладываются по полям сделки или документа. Телефон приводится к единому виду, дата к нужному формату, а лишнее не попадает в карточку.

Чужой запрос не создаст сделку

Адрес приёма закрыт проверкой подписи или ключа, а неизвестные отправители отбрасываются. В базу не попадают записи от того, кто случайно или намеренно узнал адрес обработчика.

Повтор не порождает дубль

Сервисы часто отправляют одно и то же событие несколько раз, если не получили ответа. Повтор узнаётся по идентификатору сообщения, и вторая сделка по нему не создаётся.

Видно, что именно пришло

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

Типовой проект
Компания с отраслевой программой без готового коннектора и продажами в Битрикс24: программа отправляет событие о новой заявке на закрытый адрес обменника, поля разбираются под структуру CRM, сделка создаётся с источником и ответственным, а повторные отправки не плодят дубли.
Смотреть реальные кейсы →
Технически

Приём вебхуков: коротко для разработчика

Под каждый сценарий выделяется отдельный адрес приёма с ключом в заголовке или подписью тела запроса. Принимаются данные в формате JSON и обычных полей формы, разбор описывается схемой соответствия полям вашей системы. Повторы отсекаются по идентификатору сообщения, ответ отправителю возвращается сразу, а обработка идёт в очереди, поэтому медленная CRM не приводит к таймауту на стороне сервиса. Входящие сообщения хранятся для разбора спорных случаев.

Некогда разбираться самим? Соберём приём вебхуков под ваш сервис — опишите задачу, за час вернёмся со сметой.

Как мы делаем

Пять шагов до рабочего запуска

01

Разбираем ваш процесс

Смотрим что у вас в приёме вебхуков и куда данные должны попадать. Обсуждаем что мешает сейчас.

02

Настраиваем связь

Выделяем закрытый адрес приёма с ключом и описываем разбор полей под вашу систему.

03

Согласуем, что куда попадает

Расписываем какое поле в приёме вебхуков в какое попадёт. Учитываем нестандартную логику.

04

Тестируем на ваших данных

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

05

Запускаем в работу

Запускаем и присматриваем: оповещения о сбоях. 2 недели гарантии: если что — чиним бесплатно.

Платформа

Вебхуки в платформе FlowFrame

FlowFrame — это платформа интеграций. Вебхуки подключают к вашим системам наши инженеры под ключ, а вы получаете доступ к самой интеграции в личном кабинете app.flowframe.ru: видно, работает ли обмен, есть журнал последних событий и ошибок, оплата картой или по счёту и закрывающие документы.

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

Частые вопросы

FAQ по интеграции с вебхуками

Что нужно от нашего сервиса, чтобы связка заработала?
Достаточно возможности отправить сообщение на указанный адрес при наступлении события и примера такого сообщения. Дорабатывать сам сервис обычно не требуется: разбор полей и вся логика остаются на нашей стороне.
Насколько это безопасно?
Адрес приёма закрыт ключом в заголовке или проверкой подписи тела запроса, соединение идёт по защищённому протоколу. Сообщения от неизвестных отправителей отбрасываются и в CRM не попадают. Ключ можно сменить в любой момент.
Что будет, если сервис отправит одно событие несколько раз?
Повтор узнаётся по идентификатору сообщения или по набору ключевых полей, и вторая запись не создаётся. Это частая ситуация: сервисы повторяют отправку, когда не получили ответа вовремя.
А если в сообщении пришли неполные данные?
Обязательные поля проверяются до создания записи. При их отсутствии сообщение откладывается, а ответственный получает оповещение с текстом пришедшего запроса, чтобы было видно, чего не хватило. Испорченные карточки в базе при этом не появляются.
Можно ли наоборот — отправлять события из CRM во внешний сервис?
Да, обратное направление собирается так же: смена стадии сделки или проведение документа отправляет сообщение на адрес сервиса с нужным набором полей. При недоступности получателя отправка повторяется по нарастающему интервалу.
Что будет, если CRM в момент прихода события недоступна?
Ответ отправителю возвращается сразу, а обработка идёт из очереди: сообщение сохраняется и записывается в CRM после восстановления связи. Сервис не получает ошибку и не отключает отправку, что происходит, когда обработчик долго не отвечает.
Сколько стоит и что нужно для старта?
Связка на вебхуках под ключ стоит от 40 000 ₽, точную сумму фиксируем в смете до начала работ. Для старта нужен пример сообщения от вашего сервиса, доступ к CRM или учётной системе и описание того, что должно появляться по событию. Две недели после запуска устраняем недочёты бесплатно.

Обсудим приём вебхуков от вашего сервиса

За 1 час пришлём смету и план работ.

Оставить заявку