콘텐츠로 이동

웹훅

웹훅을 통해 외부 메시지 서비스의 API를 활용하여 다채널 메시지를 구성하거나, 자사 서버와 연계하여 쿠폰 발급 등의 동작을 연계할 수 있습니다.

개발 지식이 조금 필요하지만 기존 단가 계약된 메시지 업체를 그대로 사용하거나, 서버 연동을 통해 활용 범위를 가장 넓게 구성할 수 있어 많은 고객사께서 사용하는 채널입니다.

엔드포인트, 헤더, 바디 파라미터를 구성하는 웹훅 생성 화면

플레어레인 콘솔 내 채널 > 웹훅 페이지에서 생성이 가능하며 외부 HTTP 요청을 위한 엔드포인트, 헤더, 바디 파라미터를 구성하여 웹훅을 생성할 수 있습니다.

각 항목에는 개인화 메시지 (Liquid) 문법을 활용하여 동적 파라미터 구성을 위한 유저 태그나 데이터 값을 입력할 수 있습니다.

업체에서 제공하는 발송 API를 참고하여 플레어레인 웹훅 채널에 이를 등록합니다. 플레어레인은 웹훅을 통해 업체의 발송 API를 실행하는 식으로 실제 발송이 진행됩니다.

웹훅을 통해서도 메시지 구성에 필요한 여러 동적 변수를 전달할 수 있으며 개인화 메시지 (Liquid)를 참고하시면 어떠한 변수를 입력할 수 있는지 확인할 수 있습니다.

NHN Cloud의 알림톡 발송 API를 사용하는 경우 다음처럼 구성할 수 있습니다.

NHN Cloud 알림톡 발송 API를 엔드포인트와 바디에 구성한 웹훅 설정 화면

전화번호 태그를 활용하여 타 업체 문자 발송 API 사용

Section titled “전화번호 태그를 활용하여 타 업체 문자 발송 API 사용”
{
"body": "{{ text }}", // text 변수 수동 입력
"sendNo": "15446859",
"recipientList": [
{
"recipientNo": "{{ tags.phone_number }}", // 전화번호 태그 존재 시 자동 입력됨
"countryCode": "82"
}
]
}

유저ID를 활용하여 직접 자사 API 사용

Section titled “유저ID를 활용하여 직접 자사 API 사용”
{
"userId": "{{ userId }}", // 유저ID 존재 시 자동 입력됨
"text": "{{ text }}" // text 변수 수동 입력
}

고객 여정 캔버스 내 웹훅 액션 노드가 구성된 자동화 화면

고객 여정 내 웹훅 액션에 만들어진 웹훅을 구성할 수 있습니다.

웹훅 내 입력 가능한 데이터 필드가 있는 경우 추가 입력을 위한 데이터 필드가 구성됩니다.

특정 유저 대상 웹훅 테스트 발송 패널과 데이터 변수 입력 화면

만들어진 웹훅을 토대로 특정 유저 대상으로 발송 테스트도 가능합니다. 개인화 메시지 (Liquid) 문법 중 데이터 변수를 활용하는 경우 데이터를 입력할 수 있는 입력란이 함께 오픈됩니다.

성공/실패 결과와 요청·응답 본문을 기록한 웹훅 발송 이력 화면

웹훅 발송 이력은 성공, 실패 결과를 나눠 확인할 수 있습니다. 발송 당시의 요청, 응답 본문이 구체적으로 기록됩니다.