요약
이 문서에서는 다음 내용을 다룹니다:
- Discourse에서 Zendesk 동기화 설정 활성화
- Zendesk 웹훅 구성
- Zendesk 트리거 설정
Zendesk 동기화 설정 활성화
시작하려면 Zendesk 플러그인을 활성화하고, 동기화 설정을 켜며, 보안 토큰을 제공해야 합니다.
- 플러그인 설정으로 이동: Discourse 사이트로 이동하여
/admin/plugins/discourse-zendesk-plugin의 Zendesk 플러그인 설정 페이지로 이동합니다. 또는/admin/site_settings에서 검색하여 설정을 찾을 수도 있습니다. - 플러그인 활성화: 아직 활성화되지 않았다면
zendesk enabled설정을 찾아 활성화합니다. - 동기화 설정 활성화:
sync comments from zendesk설정을 찾아 활성화합니다. - 웹훅 토큰 제공:
zendesk incoming webhook token필드에서 무작위 보안 문자열을 생성하고 추가합니다. 이 토큰은 나중에 Zendesk 웹훅 구성 시 사용됩니다. - 자동 생성 카테고리 구성: 양방향 동기화는 Zendesk 티켓 자동 생성이 구성된 카테고리의 주제에만 작동합니다.
zendesk autogenerate all categories를 활성화하거나, 특정 카테고리를zendesk autogenerate categories설정에 추가하십시오. 이 설정이 없으면 웹훅은 수신된 댓글을 조용히 무시합니다.
Zendesk 웹훅 설정
Zendesk에서 웹훅을 구성하려면 다음 단계를 따르세요:
- 웹훅 페이지에 액세스: Zendesk의 Apps and integrations → Webhooks 섹션으로 이동합니다.
- 예시 URL:
https://<instance_name>.zendesk.com/admin/apps-integrations/webhooks/webhooks
- 예시 URL:
- 웹훅 생성:
- 오른쪽 상단 모서리의 Actions 버튼을 클릭합니다.
- Create Webhook을 선택합니다.
- 웹훅 세부 정보를 입력합니다:
- Request method:
PUT - Endpoint URL:
https://<discourse.example.com>/zendesk-plugin/sync - Request format: JSON
- Request method:
- 웹훅 테스트:
- Test Webhook 버튼을 클릭합니다.
- 드롭다운에서 'Custom Test’를 선택합니다.
- JSON을 다음 내용으로 교체하고 토큰을 삽입합니다:
{
"ticket_id": "{{ticket.id}}",
"topic_id": "{{ticket.external_id}}",
"email": "{{current_user.email}}",
"token": "INSERT TOKEN HERE"
}
- Send Test를 누릅니다. HTML 페이지가 성공을 나타내도록 표시되는
400 Bad Request응답이 정상 신호로 예상됩니다.
Zendesk 트리거 설정
Zendesk에서 트리거를 구성하여 작업을 자동화합니다:
- 트리거 페이지에 액세스: Zendesk의 Admin → Objects and Rules → Business Rules → Triggers 섹션으로 이동합니다.
- 예시 URL:
https://<instance_name>.zendesk.com/admin/objects-rules/rules/triggers
- 예시 URL:
- 트리거 생성:
- Add trigger를 클릭합니다.
- 이름을 "Discourse Sync"로 지정하고 카테고리를 "Notifications"로 설정합니다.
- 아래에 묘사된 대로 조건과 작업을 구성합니다.
- 테스트 웹훅 단계에서 사용한 것과 동일한 JSON 본문을 사용하며, 다시 "INSERT TOKEN HERE"를 토큰으로 교체합니다.
- 트리거 저장: 구성이 완료되면 트리거를 저장했는지 확인하십시오.
다만, Zendesk 댓글에 첨부파일이 있는 경우 문제가 발생합니다. 메시지는 정상적으로 전송되지만 첨부파일이 누락됩니다. 첨부파일을 처리하기 위해 웹훅에 추가 매개변수를 전달해야 하는지 확실하지 않습니다. 이 작업을 위해 필요한 특정 매개변수가 있는지 확인해 주실 수 있을까요?
