Исходящие вебхуки

Ваши системы узнают о событии в ту же секунду

Тридцать одно событие, от создания контакта до сорванного срока ответа в поддержке или отклонённого объявления, приходит на ваш эндпоинт подписанными HTTP POST-запросами с автоматическими повторами. На тарифе Business. Никакого цикла опроса и никакого cron-задания, которое спрашивает, не изменилось ли что-нибудь.

  • 31 событие
  • Подпись HMAC-SHA256
  • Повторы с нарастающей задержкой

Последнее обновление:

Все события, на которые можно подписаться

Подписывайте эндпоинт только на нужные ему события, а не получайте всё подряд с фильтрацией на своей стороне.

Контакты и воронка

4
  • contact.created
  • contact.updated
  • contact.deleted
  • pipeline.stage_changed

Сообщения

3
  • message.sent
  • message.received
  • sequence.completed

Цепочки привлечения клиентов

4
  • outreach.step.sent
  • outreach.replied
  • outreach.completed
  • outreach.unsubscribed

Сделки

5
  • deal.created
  • deal.updated
  • deal.stage_changed
  • deal.won
  • deal.lost

Задачи

2
  • task.created
  • task.completed

Финансы

4
  • invoice.created
  • invoice.paid
  • finance.transaction.created
  • subscription.changed

Служба поддержки

4
  • support.ticket.created
  • support.ticket.updated
  • support.ticket.resolved
  • support.ticket.breached

Рекламные аккаунты

5
  • ads.ad.disapproved
  • ads.budget.exhausted
  • ads.spend.anomaly
  • ads.billing.problem
  • ads.campaign.status_changed

Скучные детали надёжности, от которых зависит доверие

Отправить POST с JSON может кто угодно. А пригодными для продакшена вебхуки делают подпись, повторы при сбоях и возможность увидеть, что произошло.

Подпись HMAC-SHA256

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

Повторы с нарастающей задержкой

Неудачная доставка повторяется с нарастающей задержкой, а не отбрасывается, поэтому окно деплоя или короткий сбой на вашей стороне не съедят молча то самое важное событие.

Понятный журнал доставок

Видно, что было отправлено, когда, что ответил ваш эндпоинт и сколько это заняло. Отладка интеграции перестаёт быть спором о том, сработало ли событие.

Подписка на отдельные события

Каждый эндпоинт подписывается на нужные ему события. Сервису исполнения заказов, которому важен только invoice.paid, не придётся получать и выбрасывать каждое обновление контакта.

Несколько эндпоинтов

До двадцати эндпоинтов, так что складская система, внутренний ретранслятор в Slack и хранилище данных могут получать свой поток со своим секретом.

Проверьте, прежде чем полагаться

Тестовое событие позволяет проверить эндпоинт, сверку подписи и ваш обработчик до того, как от работы всех трёх будет зависеть настоящий deal.won.

Нарушения SLA поддержки тоже

support.ticket.breached срабатывает, когда сорван обещанный срок ответа. Именно это событие большинство команд хотят видеть в канале дежурных, а не на дашборде, который никто не открывает.

Весь бизнес, а не только контакты

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

В паре с REST API

Вебхук сообщает, что что-то произошло; публичный REST API позволяет прочитать или изменить запись, с которой это произошло. Вместе они полностью заменяют опрос.

Зачем нужны исходящие вебхуки

Вебхук — это HTTP POST, который Pinlyx отправляет на ваш URL в момент события, вместо того чтобы ваш код каждые несколько минут спрашивал нас, не случилось ли что-нибудь. Доступно тридцать одно событие, каждая доставка подписана, сбои повторяются, а журнал показывает, что именно ответил ваш эндпоинт.

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

Как убедиться, что доставка пришла от нас

У каждого эндпоинта свой секрет. Мы вычисляем HMAC-SHA256 тела запроса с этим секретом и отправляем его в заголовке подписи; ваш получатель вычисляет его заново и сравнивает. Запрос без совпадающей подписи нужно отклонять.

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

Что происходит, когда ваш эндпоинт недоступен

Ответ с кодом не из диапазона 2xx или тайм-аут помечают доставку как неудачную, и она повторяется с нарастающей задержкой. Это покрывает обычные случаи: деплой, перезапуск, кратковременную блокировку базы данных.

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

Какой тариф нужен

Исходящие вебхуки, до двадцати эндпоинтов, входят в тариф Business, как и публичный REST API, который работает с ними в паре. Если вы вообще не хотите писать получатель, интеграции с Zapier и n8n получают те же события на том же тарифе. Актуальные цены на странице с ценами.

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

На тридцать одно: контакты и этапы воронки, сообщения, цепочки привлечения клиентов, сделки, задачи, счета и транзакции, подписки, тикеты службы поддержки, включая нарушения SLA, и оповещения рекламных аккаунтов, например об отклонённом объявлении или исчерпанном бюджете.
Каждая доставка подписана HMAC-SHA256 с секретом вашего эндпоинта. Вычислите подпись заново по исходному телу запроса и сравните её за постоянное время; всё, что не совпадает, отклоняйте.
Неудачные доставки повторяются с нарастающей задержкой, а не отбрасываются, а журнал доставок показывает каждую попытку и ответ вашего эндпоинта. Из-за повторов ваш обработчик должен быть идемпотентным.
Да, до двадцати, у каждого свой секрет и своя подписка на события, так что разные системы получают разные потоки.
Нет. Исходящие вебхуки входят в тариф Business вместе с API-ключами и публичным REST API. MCP-сервер есть на всех тарифах. Актуальные цены на странице с ценами.
Используйте интеграции с Zapier или n8n. Они получают те же события и позволяют направлять их в другие приложения, ничего не программируя и не размещая у себя.

Готово к запуску

Хватит опрашивать в поисках изменений

Вебхуки и REST API входят в тариф Business.

Тариф Free: бесплатно навсегда · С учётом требований GDPR · Без банковской карты