Discord용 챗봇 제작 Skill

개발자 전용 편집기에서 Discord 봇을 구축하며, 봇에 필요한 항목에 맞춰 게이트웨이 인텐트를 설정하고, 슬래시 명령어를 먼저 길드 명령어로 등록한 뒤 3초 이내에 응답합니다. 봇을 배포하기 위해 활성화되었습니다.

KissMySkills.com | 설치: 이 파일을 프로젝트에 넣고 Claude Code, Cursor 또는 코드를 읽을 수 있는 AI로 엽니다. 또는 Claude, ChatGPT, Gemini에 붙여넣고 프로젝트를 설명합니다. 그런 다음 시작하라고 요청하세요. 개발자의 Discord 봇을 개발자 포털 애플리케이션에서 실제 배포를 견디는 봇까지, 개발자의 에디터에서 함께 구축합니다. "디스코드에서 봇 만들기"를 검색하면 모든 결과가 "애플리케이션을 만들고, 봇 사용자를 추가하고, 링크로 초대하세요"에서 끝납니다. 그러면 봇을 서버에 추가할 수는 있지만, 이후 봇이 메시지 콘텐츠를 읽지 못하는 이유, 멤버 이벤트가 전혀 발생하지 않는 이유, 한 서버에서 작동하던 슬래시 명령어가 다른 서버에서는 보이지 않는 이유는 설명하지 않습니다. 데모 수준을 넘어 실제로 구축합니다. 봇에 필요한 항목에 맞춘 게이트웨이 인텐트, 현재 배포 단계에 맞는 올바른 슬래시 명령어 등록 방식, 그리고 연결이 조용히 끊기지 않고 유지되는 프로세스를 다룹니다. 1. discord.js(Node/TypeScript) 또는 discord.py(Python) 중 무엇을 사용하는지와 주요 버전. 2. 봇이 확인해야 하는 항목: 메시지 콘텐츠, 멤버 입장/퇴장, 프레즌스 또는 슬래시 명령어 상호작용만 필요한지. 3. 테스트를 위해 한 서버(길드)에만 사용할 봇인지, 여러 서버에서 공개적으로 사용할 봇인지. 4. 실행 환경: 장시간 실행되는 프로세스/컨테이너인지, 서버리스 함수인지. 1. 개발자 포털 애플리케이션과 봇 사용자를 만들고, 한 번만 생성되어 다시 표시되지 않는 봇 토큰을 커밋되는 설정 파일이 아니라 환경 변수에 바로 저장합니다. 2. 실제로 필요한 항목에 맞춰 게이트웨이 인텐트를 요청하며, 기본적으로 모든 인텐트를 활성화하지 않습니다. 메시지 콘텐츠, 길드 멤버, 프레즌스는 권한이 필요한 인텐트이므로 개발자 포털에서 명시적으로 활성화하고 코드에서도 요청해야 합니다. 100개 이상의 서버에 있는 봇은 계속 사용하려면 Discord의 승인을 받아야 합니다. 인텐트를 비활성화해도 큰 오류가 발생하지 않고, 관련 데이터가 조용히 비어 있거나 관련 이벤트가 전혀 발생하지 않을 뿐이므로 이것이 가장 흔하게 발생하는 문제입니다. 3. 슬래시 명령어는 먼저 길드 명령어로 등록합니다. 테스트에 적합하고 즉시 업데이트되기 때문입니다. 봇이 안정화된 뒤에만 글로벌 명령어로 배포합니다. 글로벌 명령어는 전파에 최대 한 시간이 걸릴 수 있으므로 이를 예상하지 못하면 버그처럼 보일 수 있습니다. 4. 3초 이내에 응답하거나 명시적으로 응답을 지연하도록 상호작용 핸들러를 구축합니다. 제때 확인되지 않은 상호작용은 Discord에서 무효화하기 때문입니다. 5. 권한 및 초대 링크를 확인합니다. 초대 링크가 요청하는 OAuth2 범위와 봇 권한은 코드가 실제로 호출하는 기능과 일치해야 합니다. 그렇지 않으면 봇에 필요한 권한이 없는 서버에서 명령어가 조용히 실패합니다. 6. 재연결에 안전한 프로세스를 구성합니다. 게이트웨이 연결은 때때로 자체적으로 끊기므로 라이브러리 자체의 재연결 로직을 신뢰하고, 그 로직과 충돌하는 사용자 지정 재시도 루프로 감싸지 않습니다. 7. 플랫폼이 프로세스를 계속 실행하도록 배포합니다. 컨테이너 재시작 정책이나 프로세스 관리자를 사용합니다. 약 2,500개 길드를 넘는 규모를 언급하는 경우에는 단일 연결만으로는 충분하지 않으므로 샤딩도 안내합니다. · 봇이 실제로 사용하지 않는 권한 인텐트(메시지 콘텐츠, 멤버, 프레즌스)를 요청하지 않습니다. 요청하는 각 인텐트는 구축 중인 특정 기능과 연결하며, 불필요한 요청이 검증 요구를 필요 이상으로 빨리 유발하기 때문입니다.