개발자 설정
우리 서비스와 제로톡을 이을 때 쓰는 설정이에요. 대시보드 채팅 설정 > 연동 / 개발 메뉴에 있고, 워크스페이스 관리자 이상에게 보여요.
이 문서는 화면에서 무엇을 하는지 안내해요. 요청 형식·이벤트 목록 같은 자세한 내용은 개발자 가이드를 참고하세요.
웹훅
채팅 설정 > 연동 / 개발 > Webhook 설정
새 메시지나 상담 상태 변화 같은 이벤트를 우리 서버 주소로 받아요. 아직 베타 기능이에요.
- 웹훅 추가하기
이름과 이벤트를 받을 URL을 입력해요. URL 은
https://로 시작해야 해요. 받을 구독 이벤트를 고르고(아무것도 고르지 않으면 모든 이벤트를 받아요), 필요하면 전달 조건으로 받을 대상을 좁혀요. - 시크릿 보관하기
저장하면 서명 검증에 쓰는 시크릿이 한 번만 표시돼요. 바로 복사해 안전한 곳에 보관하세요. 잃어버리면 목록의 키 재생성으로 새 시크릿을 받을 수 있고, 재생성하는 즉시 이전 시크릿은 쓸 수 없어요.
- 전달 결과 확인하기
목록의 이력에서 이벤트마다 전달 상태·응답 코드·걸린 시간을 확인해요. 이벤트 전달이 연속 10회 실패하면 웹훅 상태가 오류로 바뀌고 전송이 멈춰요. 이때 워크스페이스 관리자에게 알림이 가요.
목록의 오류 표시에 마우스를 올리면 마지막 전달이 왜 실패했는지 보여요. 응답 코드나 응답 없음 같은 실패 사유예요. 관리자에게 가는 알림에도 같은 사유가 함께 표시돼요.
이벤트 종류와 서명 검증 방법은 개발자 가이드의 웹훅 설정·이벤트·서명 검증을 참고하세요.
개발자 토큰
채팅 설정 > 연동 / 개발 > 개발자
제로톡 Public API 를 부를 때 쓰는 개인 액세스 토큰(PAT) 을 발급하고 관리해요.
| 역할 | 할 수 있는 일 |
|---|---|
| 소유자 | 토큰 발급·회전, 목록 보기, 회수, 발신 신원 수정 |
| 관리자 | 목록 보기, 회수, 발신 신원 수정 |
토큰을 만들 때 정하는 것:
- 이름 — 어디에 쓰는 토큰인지 알아볼 수 있게 붙여요.
- 권한 — 토큰으로 할 수 있는 일을 골라요. 필요한 것만 주는 게 안전해요.
- 만료 — 30일·60일·90일·365일 또는 무기한 중에서 골라요.
- 허용 IP — 정해 두면 그 주소에서 온 요청만 받아요.
발급 직후 표시되는 토큰 값을 바로 복사해 두세요. 목록에는 앞부분만 보이고, 전체 값은 다시 확인할 수 없어요. 잃어버렸거나 유출이 의심되면 회전(기존 토큰을 즉시 무효로 만들고 같은 이름·권한의 새 토큰을 발급해요)하거나 회수(해당 토큰의 API 호출을 즉시 막아요)하세요.
토큰은 발급한 사람이 아니라 워크스페이스에 속해요. 그래서 발급하거나 회전한 사람의 비밀번호 변경 기한이 지나도 토큰은 계속 동작해요. 토큰을 막으려면 회수하세요.
API 로 보낸 메시지가 상담 화면에 어떤 이름으로 보일지는 목록의 발신 신원에서 정할 수 있어요. 인증 방식과 권한 목록은 API 인증·권한 목록을 참고하세요.
모바일 SDK 푸시
채팅 설정 > 연동 / 개발 > 모바일 SDK 푸시
우리 iOS·Android 앱에 제로톡 SDK 를 넣었다면, 고객 앱으로 푸시 알림을 보내기 위한 자격증명을 여기에 등록해요. 관리자만 바꿀 수 있고, 다른 팀원에게는 읽기만 허용돼요.
| 플랫폼 | 등록하는 것 |
|---|---|
| iOS (APNs) | 인증 키와 Key ID·Team ID·Bundle ID, 환경(Sandbox 또는 Production) |
| Android (FCM) | Firebase 프로젝트 자격증명 — 등록하면 Project ID 가 표시돼요 |
등록을 마치면 카드에 등록됨으로 표시되고, 필요할 때 다시 올리거나 삭제할 수 있어요. 앱 쪽 설정은 iOS SDK·Android SDK 문서를 참고하세요.