웹훅이란 서버 알림, 메일 수신 등 사용자가 정한 특정한 이벤트가 발생하면 이를 웹훅 URL로 전송하도록 하여 메신저 대화방에 메시지로 보여주는 서비스입니다.
하이웍스 메신저 그룹 대화방과 나와의 대화방으로 웹훅을 수신 설정하여 일정한 포맷의 메시지로 전송받을 수 있습니다.
 |
• 웹훅 URL로 특정 이벤트를 전송하도록 하기 위해서는 프로그래밍 또는 서드파티 서비스를 이용한 작업이 필요합니다. • 웹훅 기능은 현재 그룹 대화방(그룹 기능)과 나와의 대화방에서만 사용할 수 있으며, 그룹 대화방의 웹훅은 그룹 소유자만 설정할 수 있습니다. |
1. 메시지를 전송받을 대화방을 선택하여 [메뉴 > 웹훅 수신 연동 설정]에서 [새 연동 추가] 버튼을 클릭합니다.
(그룹 대화방의 새 연동 추가 및 설정 버튼은 그룹 소유자에게만 출력됩니다.)
2. 연동 추가 레이어에 생성된 Webhook URL로 수신할 정보(HTTP POST request)를 전송 설정하세요.
 |
• 웹훅 메시지는 총 500자까지만 출력할 수 있습니다. |
|
• Curl request 샘플 curl -X POST https://hooks.hiworks.com/messenger/chat/611168efa58cbfceff44b625385d015d -H "Content-Type: application/json" -d "{\"text\": \"Hello, world.\"}"
• Json방식 POST https://hooks.hiworks.com/messenger/chat/08344a0c736ffb5abb9011a30as3acr9 Content-type: application/json |
3. [연동 추가] 창에서 대화방에서 출력할 웹훅 메시지의 출력 이름과 이미지를 설정할 수 있습니다.
위와 같이 설정을 완료한 후, 설정된 웹훅 연동 메시지는 아래와 같이 전송됩니다.