Разработчики
Вебхуки
Каждое уведомление, создаваемое вашей учетной записью, может отправляться непосредственно в ваши собственные системы в виде подписанного запроса 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Временная метка подписывается вместе с телом сообщения, а не отправляется рядом с ним, поэтому перехваченный запрос не может быть воспроизведен повторно в ваш адрес позже. Отклоняйте все, что старше нескольких минут.
Ваш секретный ключ подписи отображается только один раз, при добавлении вебхука. Мы не сможем показать его снова — если вы потеряете его, удалите адрес назначения и добавьте его повторно.
Настройка
- На панели управления откройте «Уведомления» и добавьте назначение типа Webhook.
- Укажите вашу конечную точку HTTPS и скопируйте секрет подписи, который мы вам покажем.
- Нажмите Test. Мы отправим настоящий запрос в том же формате, что и рабочий, чтобы вы могли настроить интеграцию до того, как произойдет что-то реальное.
- Выберите категории, которые должны поступать в это место назначения. Новые типы уведомлений включаются автоматически.
Вы можете добавить любое количество мест назначения, комбинировать вебхуки с электронной почтой, Slack и Telegram, а также назначать каждому из них свой набор категорий.
Предпочитаете позвонить нам?
Вебхуки сообщают вам о том, когда что-то произошло. API — это способ заставить что-то произойти: каждая операция, выполняемая панелью управления, доступна вам.