Отправлять события в вашу собственную систему с помощью вебхуков

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

Добавить конечную точку

1. Откройте Вебхуки вкладку и нажмите Добавить конечную точку.
2. Введите Имя и URL. Она должна быть общедоступной. Адреса внутри частной сети отклоняются по соображениям безопасности.
3. Отметьте События что Вы хотите.
4. Необязательно: выберите Ключ API. Конечная точка затем получает только те события, которые этот ключ может прочитать.
5. Нажмите Сохранить. IDup показывает Ваш секрет подписи один раз. Храните его в безопасности.

События

• Счет создан, Счет оплачен, Платеж получен
• Новый клиент, Новый контакт, Новый лид, Новый тикет
• Коммерческое предложение принято — коммерческое предложение, которое принял клиент

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

Проверить подпись

Ваша система должна вычислить HMAC-SHA256 по времени и необработанному телу с вашим секретом, сравнить его с подписью и отклонить время старше 5 минут. Нажмите Проверка подписи и примеры для готового кода.

Тестировать, приостанавливать и обновлять

• Отправить тест отправляет тестовое событие и показывает HTTP-код и время, которое это заняло.
• Пауза останавливает доставки; Активировать запускает их снова.
• Секрет ролла создает новый секрет. Старый перестает работать сразу.
• Удалить удаляет конечную точку. Ее журнал сохраняется.

Повторы и журнал

Ваш адрес должен ответить кодом 2xx в течение 5 секунд. Перенаправления не следуются. Если это не удается, IDup повторяет попытку через 1 минуту, 5 минут, 30 минут, 2 часа и 12 часов. После шестой попытки доставка помечается Сдались.

Журнал показывает каждую попытку с событием, конечной точкой, попыткой, кодом HTTP, продолжительностью и началом ответа. Статус Ожидание, Доставлено, Не удалось или Сдались. Используйте Отправить повторно отправить доставку снова.