Webhook

​

Webhook이란?

​

폴링 (Polling)과 웹훅 (Webhook)

​

노티플라이에서의 웹훅

• 유저의 이벤트 발송
• 예약 발송 (주기 발송) 시 예약된 시점 도달

​

Prerequisites

1. 웹훅을 수신할 수 있는 환경
   • 웹훅을 수신하기 위해서는 웹훅을 수신할 수 있는 서버가 필요하고, 이 서버는 public 네트워크에 연결되어 HTTP 요청을 수신할 수 있어야 합니다.
   • 알맞은 DNS 설정을 통해, 명시된 URL으로 노티플라이 서버가 해당 서버에 도달할 수 있어야 합니다.
2. 노티플라이 IP Whitelist 설정
   • 노티플라이 서버의 IP 주소로부터의 Inbound Traffic을 네트워크 정책에서 꼭 허용하도록 설정해주세요. 노티플라이 웹훅 발송 서버의 IP 주소의 목록은 다음과 같습니다.
     • 3.38.74.151
     • 43.201.228.103
     • 43.200.138.23

​

웹훅 캠페인 생성 및 메시지 개인화

​

웹훅 캠페인 생성

• URL (필수) - 웹훅을 수신할 URL입니다. 필수로 입력해야 합니다.
• HTTP Method - 웹훅을 수신할 때 사용할 HTTP Method입니다. 현재 GET, POST, PUT, DELETE를 지원합니다.
• HTTP Headers - 웹훅을 수신할 때 함께 전송할 HTTP Header입니다. Key-Value 형태로 입력해야 합니다.
• HTTP Body - 웹훅을 수신할 때 함께 전송할 HTTP Body입니다. GET 요청의 경우 body를 사용하실 수 없습니다.

​

메시지 개인화

{  "name": "{{ user['name'] }}",  "email": "{{ user['email'] }}"}

{%- assign additional_properties = user["properties"] -%}{%- if additional_properties -%}{  "name": {{ user["name"] | default: "" | json }},  "email": {{ user["properties"] | json }}}{%- else -%}{  "name": {{ user["name"] | default: "" | json }},  "properties": null}{%- endif -%}

{  "name": "John Doe",  "properties": {    "age": 30  }}

{  "name": "John Doe",  "properties": {    "age": 30  }}

{  "name": "John Doe",  "properties": null}

​

메시지 개인화 테스트

1. Liquid 템플릿 테스트

• Liquid JS Playground 를 이용하여 템플릿 테스트 후 캠페인을 집행하시길 권장드립니다.

2. Webhook 발송 테스트

• URL, HTTP Method, HTTP Headers, HTTP Body를 입력한 후 ‘테스트 발송’을 클릭해주세요.

• 발송할 유저 아이디를 입력하신 후, ‘테스트 발송’을 클릭해주세요.

• 발송 결과를 탭하시면, 더 자세한 정보를 확인하실 수 있습니다.

​

Note

1. 요청 응답 지연 시간이 5초 이상인 경우, 발송 실패로 처리됩니다.
2. 응답 상태 코드가 2XX 인 경우, 발송 성공으로 처리되며 그 외의 경우는 발송 실패로 처리됩니다.