Перейти к содержимому

Уведомления через вебхуки

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

Чтение: 5 мин Реальные экраны, вымышленные данные Обновлено 22 октября 2026

На этой странице

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

  1. Шаг 1: Добавьте конечную точку

    В Администрирование → Настройки → API и вебхуки в разделе Вебхуки нажмите Добавить конечную точку.

  2. Шаг 2: Введите адрес

    Заполните URL конечной точки (это должен быть общедоступный адрес https://) и при желании Описание.

  3. Шаг 3: Выберите события

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

  4. Шаг 4: Скопируйте секрет подписи

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

  5. Шаг 5: Проверьте

    Нажмите Отправить тестовое событие и проверьте Журнал доставок.

Доступные события

  • Контакты: контакт создан или изменён.
  • Счета: выставлен, полностью оплачен, аннулирован. Коммерческие предложения: принято.
  • Платежи: проведён платёж или поступление.
  • Счета поставщиков: получен (проведён), полностью оплачен. Расходы: зарегистрирован расход.
  • Запасы: остаток товара опустился до уровня повторного заказа или ниже.
  • Отпуск: создана заявка на отпуск.

Доставка и повторные попытки

  • Ваше приложение должно ответить статусом 2xx в течение 10 секунд. Всё остальное считается ошибкой.
  • Неудачные доставки автоматически повторяются — до шести попыток в течение нескольких часов, каждый раз с большим интервалом.
  • Откройте конечную точку кнопкой Управлять, чтобы увидеть Журнал доставок: каждое событие с его Полезная нагрузка, Ответ вашего сервера и статусом Доставлено, Ошибка или Ожидает. Нажмите Отправить повторно, чтобы отправить событие ещё раз.
  • Снимите отметку Отправлять события на эту конечную точку, чтобы приостановить её, или нажмите Удалить, чтобы её удалить. Конечная точка, которая долго не принимает сообщения, отключается автоматически.

Проверка подписи

Каждая доставка содержит заголовок X-Webhook-Signature: t=<timestamp>,v1=<signature>. Вычислите HMAC-SHA256 от «<timestamp>.<raw body>» с вашим секретом подписи и сравните результат с v1; отклоняйте метки времени старше 5 минут. X-Webhook-Id не меняется при повторных попытках, поэтому используйте его для отсеивания дубликатов.

Спросить о продукте

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

Думаю…

ИИ-ассистент сейчас недоступен. Поищите в руководствах или свяжитесь с нашей командой. Связаться с поддержкой

ИИ может ошибаться. Проверяйте по ссылкам на руководства.

Всё ещё нужна помощь?

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

Связаться с поддержкой
Чат с ИИ