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