치지직 채팅봇

치지직 개발자 센터 API 키 발급, 화면별 안내 — 애플리케이션 등록부터 Client ID까지

직쓰 2026. 10. 5. 20:00

아인만 쓰려는 분은 이 글이 필요 없습니다. 아인은 설치하고 방송 계정으로 로그인하면 바로 시작되고, 키 발급 단계가 없습니다. 이 글은 직접 발급한 키로 연결하고 싶은 분과, 치지직 API로 프로그램을 직접 만드는 분을 위한 글입니다.

치지직에 직접 만든 프로그램이나 공식 API를 쓰는 도구를 붙이려면, 또는 설치형 채팅봇에 내 키를 넣어 쓰려면 치지직 개발자 센터에서 API 키를 발급받아야 합니다. 무료이고 한 번만 하면 되는데, 처음 보는 화면이라 어디에 뭘 넣어야 하는지 막히는 분이 많습니다.

이 글은 그 과정을 화면 순서대로 적은 글입니다. 입력값 예시는 제가 만든 채팅봇 '아인' 기준이지만, 다른 프로그램도 순서는 같고 프로그램이 알려 주는 값만 다릅니다. 아인은 2.3부터 키 없이 방송 계정 로그인만으로 쓸 수 있고, 직접 발급한 키로 연결하고 싶을 때 이 순서를 따르면 됩니다.

이 글이 필요한 경우

  • 설치형 채팅봇에 직접 발급한 키를 넣어 쓰려는 경우 (아인은 2.3부터 키 없이도 됩니다)
  • 직접 만든 프로그램으로 치지직 채팅을 읽거나 쓰려는 경우
  • 공식 API를 쓰는 오버레이·위젯 도구를 붙이는 경우

뚜봇, 빵떡, 한봇처럼 웹에서 로그인해 쓰는 봇은 봇 회사가 이미 발급받아 두었기 때문에 이 과정이 필요 없습니다.

준비

방송하는 네이버 계정 하나면 됩니다. 개발자 센터는 방송 계정으로 로그인해야 합니다. 부계정으로 등록하면 나중에 프로그램이 "다른 계정"이라고 알려 줍니다.

1. 개발자 센터 로그인

치지직 개발자 센터 첫 화면 (developers.chzzk.naver.com)

developers.chzzk.naver.com 에 들어가 네이버로 로그인합니다. 처음이면 이용 약관 동의 화면이 나옵니다.

2. 애플리케이션 등록

개발자 센터 애플리케이션 목록 — [애플리케이션 등록] 버튼

 

[애플리케이션 등록]을 누르면 입력 화면이 나옵니다. 여기서 넣을 것은 세 가지입니다.

애플리케이션 이름
자유롭게 짓되, "치지직", "네이버", "chzzk", "naver"는 넣을 수 없습니다. 넣으면 앱이 정지될 수 있습니다. "내 방송 봇" 정도면 됩니다. 이 이름은 로그인 창에 표시될 뿐 채팅에 나오지 않습니다.

로그인 리디렉션 URL
쓰려는 프로그램이 알려 주는 값을 그대로 붙여 넣습니다. 한 글자라도 다르면 로그인이 안 됩니다. 아인은 아래 값입니다.

http://localhost:3000/callback

API Scopes (권한)
프로그램이 요구하는 항목을 체크합니다. 아인은 다음 4 개입니다.

  • 유저 조회
  • 채팅 메시지 조회
  • 채팅 메시지 쓰기
  • 후원 조회 (치즈 후원 인사에 필요)

권한은 처음 등록할 때 한 번에 체크하세요. 등록 뒤에 권한을 바꾸면 치지직 검수를 거쳐야 반영돼서 며칠이 걸립니다. 빠뜨렸다면 아인은 어떤 권한이 빠졌는지 화면에 알려 주니 그때 추가하면 됩니다.

3. Client ID와 Client Secret 복사

등록 뒤 애플리케이션 정보 — 클라이언트 ID와 Secret(예시 값)

등록을 마치면 Client ID와 Client Secret 두 값이 나옵니다. 이걸 프로그램의 해당 칸에 붙여 넣습니다. 아인은 설정 → 치지직 연결 → "연결 방식"을 펼치면 나오는 Client ID·Client Secret 두 칸입니다. 처음 설치할 때는 초기 설정의 "내 키로 연결하기 (고급)"을 누르면 같은 두 칸이 나옵니다. Client Secret은 눈 모양 [보기]를 누르면 보이는데, 칸보다 길어서 끝까지 끌어 모두 골라 복사합니다.

Client Secret은 비밀번호와 같습니다. 방송 화면에 띄우거나 캡처에 남기지 마세요. 새어 나간 것 같으면 개발자 센터에서 그 애플리케이션을 지우고 새로 등록하면 됩니다.

4. 프로그램에서 로그인

프로그램이 여는 로그인 창에서 방송 계정으로 로그인하고 [동의]를 누르면 연동이 끝납니다. 동의 화면에 방금 체크한 권한 목록이 그대로 나옵니다.

아인은 로그인이 끝나면 화면에 방송 계정 이름을 보여 줍니다. 여기까지 3분 정도입니다.

알아 둘 것

  • 치지직 개발자 문서 기준으로 최근 90일 동안 API 사용이 없는 애플리케이션은 삭제됩니다. 봇을 몇 달 안 켰다가 다시 켤 때 로그인이 안 되면 이 경우이니 새로 등록하면 됩니다.
  • 애플리케이션은 계정당 여러 개 만들 수 있습니다. 프로그램마다 따로 등록해도 됩니다.
  • 개발자 센터 정책과 화면은 치지직이 바꿀 수 있습니다. 공식 문서는 chzzk.gitbook.io 에 있습니다.

막힐 때

로그인 창에서 오류가 나요
리디렉션 URL 오타가 대부분입니다. 프로그램이 알려 준 값과 글자 단위로 비교하세요. http와 https, 마지막 슬래시까지요.

"권한이 빠졌습니다"라고 나와요
API Scopes에서 빠진 항목을 체크하고 저장하세요. 검수 후 반영되면 아인 설정 → 치지직 연결에서 [방송 계정 변경 (다시 로그인)]을 누르고, 프로그램을 껐다 켜면 됩니다.

방송 계정이 다른 계정으로 나와요
개발자 센터나 로그인 창에서 부계정으로 로그인한 경우입니다. 로그아웃하고 방송 계정으로 다시 하세요.

아인에서 권한이 빠졌다고 나올 때 할 일은 문제 해결 가이드에 있습니다. 다른 증상도 같은 곳에 모아 두었습니다.
https://einbot.kr/guide/troubleshooting/#scope

아인 설치 순서는 여기에 있습니다. 2.3부터는 개발자 센터 단계 없이 로그인만 하면 되고, 직접 발급한 키로 연결하는 방법은 같은 글 아래쪽에 있습니다.
https://einbot.kr/guide/install/

아인 공식 사이트: https://einbot.kr

아인은 개인이 만든 프로그램이며, 네이버·치지직의 공식 서비스가 아닙니다. 개발자 센터 내용은 2026년 10월 기준입니다.

개인이 만든 프로그램이며 네이버·치지직의 공식 서비스가 아닙니다.