개발자

웹훅

계정에서 발생하는 모든 알림을 서명된 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

타임스탬프는 본문과 따로 전송되지 않고 함께 서명되므로, 누군가 가로챈 요청을 나중에 다시 재생 공격할 수 없습니다. 몇 분 이상 경과한 요청은 모두 거부하세요.

웹훅을 추가할 때 서명 비밀 키가 한 번 표시됩니다. 다시 표시할 수 없으므로, 분실한 경우 대상(destination)을 삭제한 후 다시 추가해야 합니다.

설정하는 중

  1. 대시보드에서 알림을 열고 웹훅 유형의 수신지를 추가하세요.
  2. HTTPS 엔드포인트를 제공하고 표시되는 서명 비밀 키를 복사하십시오.
  3. 테스트를 누르세요. 실제 요청과 동일한 형태의 실제 요청을 보내므로, 실제 상황이 발생하기 전에 그에 맞춰 빌드할 수 있습니다.
  4. 해당 목적지가 수신할 카테고리를 선택하세요. 새로운 종류의 알림은 자동으로 켜집니다.

원하는 만큼 목적지를 추가하고, 웹훅을 이메일, Slack 및 Telegram과 혼합하여 각각에 다른 카테고리 집합을 지정할 수 있습니다.

전화로 문의하시겠습니까?

웹후크는 어떤 일이 발생했음을 알려줍니다. API는 어떤 일이 발생하도록 만드는 방법이며, 대시보드가 수행하는 모든 작업을 여러분도 이용할 수 있습니다.

API 레퍼런스 탐색하기