Розробники

Вебхуки

Кожне сповіщення, яке генерує ваш обліковий запис, може надсилатися безпосередньо до ваших власних систем у вигляді підписаного JSON POST — тож події на вашому хостингу можуть запускати робочий процес будь-де.

Уся документація для розробників →

До чого ви можете це підключити

Вебхук — це звичайний запит HTTPS, тому все, що може його отримати, може виконати дію на його основі. Вам не потрібно, щоб ми створювали інтеграцію для вашого інструмента.

Платформи автоматизації

Спрямуйте вебхук на робочий процес у n8n, Make, Zapier, Pipedream, Activepieces, і кожна подія стане тригером — публікуйте в каналі, відкривайте тікети, оновлюйте таблиці, викликайте інші API. Платформи із власним хостингом працюють точно так само, якщо кінцева точка доступна через HTTPS.

CRM та служби підтримки

Надсилайте події виставлення рахунків та облікового запису до HubSpot, Pipedrive, Salesforce або до будь-якої служби підтримки чи CRM із вхідним вебхуком, щоб запис клієнта відображав стан його хостингу без необхідності копіювати дані вручну.

Усе інше, що прослуховує

Slack, Discord, Google Sheets, Airtable, Notion, ваш власний моніторинг, сховище даних або невеликий скрипт, який ви написали. Якщо він може приймати HTTPS POST і читати JSON, він може отримувати ці дані.

Що надсилається

Ви самі обираєте, які категорії куди надсилати, — і можете підключити декілька призначень, щоб рахунки надходили в одне місце, а сповіщення сайту — в інше. За замовчуванням усе ввімкнено.

Оплата та рахунки

Виставлені та сплачені рахунки, невдалі платежі, картки, термін дії яких закінчується, продовження та скасування.

Сайти та безпека

Підготовку завершено, сайт призупинено, виявлено шкідливе програмне забезпечення, резервні копії та зміни сертифікатів.

Підтримка та домени

Відкриті та ескаловані тікети, трансфери доменів, продовження та зміни DNS.

Підтвердження того, що запит надійшов від нас

Кожен запит підписується секретним ключем, який відомий лише вам і нам. Перевірте підпис, перш ніж виконувати дії над тілом повідомлення — ці заголовки надходять із кожною доставкою:

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paid

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

Ваш секретний ключ підпису відображається лише один раз, під час додавання вебхуку. Ми не можемо показати його знову — якщо ви його втратите, видаліть кінцеву точку та додайте її повторно.

Налаштування одного

  1. На панелі керування відкрийте «Сповіщення» та додайте призначення типу Webhook.
  2. Вкажіть вашу кінцеву точку HTTPS і скопіюйте секрет підпису, який ми вам показуємо.
  3. Натисніть Test. Ми надсилаємо справжній запит у тій самій формі, що й робочий, щоб ви могли виконати налаштування до того, як відбудеться щось реальне.
  4. Виберіть, які категорії має отримувати це місце призначення. Нові типи сповіщень вмикаються автоматично.

Ви можете додати скільки завгодно місць призначення, комбінувати вебхуки з електронною поштою, Slack і Telegram та призначати кожному з них окремий набір категорій.

Бажаєте натомість зателефонувати нам?

Вебхуки сповіщають вас про те, коли щось відбулося. API — це спосіб виконати певну дію: кожна операція, яку здійснює панель керування, доступна вам.

Переглянути довідник API