2519 단어
13 분
명령어

포뇨봇 명령어#

공통 안내#

  • 모든 명령어는 !로 시작합니다.
  • 권한 표기:
    • 전체: 누구나 사용 가능
    • 스태프: 방장/부방장/관리자 권한 필요
    • 관리자: 봇 관리자 권한 필요
  • 일부 명령은 대상 지정 방식으로 @멘션, 답장, uid를 지원합니다.

방/시스템 관리#

명령어사용 예시설명권한
!관리방등록 [방아이디|오픈채팅URL]!관리방등록 https://open.kakao.com/o/xxxx관리방 등록관리자
!방등록 [방아이디|오픈채팅URL]|[계약일]!방등록 123456789|30일반방(application) 등록관리자
!방수정 [방아이디|오픈채팅URL]|[+일수/-일수]!방수정 123456789|+7일반방 계약일 증감관리자
!방취소 [방아이디|오픈채팅URL]!방취소 123456789일반방 등록 해제관리자
!관리방취소 [방아이디|오픈채팅URL]!관리방취소 123456789관리방 등록 해제관리자
!방목록!방목록등록된 일반방 목록관리자
!관리방목록!관리방목록등록된 관리방 목록관리자
!room!room현재 방 이름/ID 출력전체
!user!user내 닉네임/ID 출력전체
!명령어!명령어명령어 문서 링크 안내전체

운영/관리#

명령어사용 예시설명권한
!키생성!키생성관리자 인증 키 생성(3분 유효)전체
!키확인 [키]!키확인 ABC123관리자 인증 완료전체
!키파괴!키파괴내 인증 키 삭제전체
!어드민목록!어드민목록관리자 ID 목록 조회관리자
!어드민삭제 [유저아이디]!어드민삭제 123456789관리자 권한 제거관리자
!ban [대상]!ban @user봇 사용 제한 추가 (@멘션/답장/uid)관리자
!unban [대상]!unban UID1234봇 사용 제한 해제 (@멘션/답장/uid)관리자
!메모 [내용]!메모 들낙 주의대상 유저 메모 저장 (@멘션 또는 답장 문맥)스태프
!메모삭제!메모삭제대상 유저 메모 삭제 (@멘션 또는 답장 문맥)스태프
!경고 [대상] [횟수]!경고 @user 1경고 추가스태프
!경고삭제 [대상] [횟수]!경고삭제 @user 1경고 차감스태프
!경고초기화 [대상]!경고초기화 @user경고 0으로 초기화스태프
!채팅청소!채팅청소방 채팅 정리관리자

기본/알림/반응#

명령어사용 예시설명권한
!hi!hi간단 인사 응답전체
!hhi!hhi자기 자신 멘션 메시지 전송전체
!ping!ping지연 시간(pong ms) 확인전체
!react [0~6]!react 1리액션 추가(0은 취소, 답장 권장)전체
!알림켜기!알림켜기멘션/답장 알림 켜기전체
!알림끄기!알림끄기멘션/답장 알림 끄기전체
!윗메!윗메답장한 메시지의 이전 메시지 확인전체(답장 필요)
!밑메!밑메답장한 메시지의 다음 메시지 확인전체(답장 필요)
!읽은사람!읽은사람답장한 메시지를 읽은 사람 목록스태프(답장 필요)

오픈챗봇/키워드 알림#

명령어사용 예시설명권한
!옾챗봇응답목록!옾챗봇응답목록현재 방 옾챗봇 응답 키워드 목록 조회전체
!키워드알림켜기!키워드알림켜기키워드 알림 사용 시작전체
!키워드알림끄기!키워드알림끄기키워드 알림 사용 중지전체
!키워드추가 [키워드]!키워드추가 포뇨봇감지할 키워드 등록전체
!키워드삭제 [키워드]!키워드삭제 포뇨봇등록한 키워드 삭제전체
!키워드목록!키워드목록내 키워드 목록 조회전체

유저/방 정보#

명령어사용 예시설명권한
!정보!정보내 정보 조회전체
!정보 [대상]!정보 @user타인 정보 조회 (@멘션/답장/uid)스태프
!유저포스트목록!유저포스트목록내 오픈프로필 포스트 조회전체
!유저포스트목록 [대상]!유저포스트목록 @user타인 포스트 조회 (@멘션/답장/uid)스태프
!chk!chk내 계정(국내/해외) 확인전체
!chk [대상]!chk @user타인 계정 확인 (@멘션/답장/uid)스태프
!유저목록!유저목록현재/퇴장/강퇴/제한 유저 목록전체
!강퇴목록!강퇴목록강퇴된 멤버 목록 조회전체(봇 방장/부방장 권한 필요)
!유령목록!유령목록유령 유저 통계/목록 조회전체
!방정보!방정보방 메타/채팅 통계 상세 조회전체
!기기정보!기기정보봇 기기 상태(CPU/RAM/업타임)전체

채팅/출석 통계#

명령어사용 예시설명권한
!채팅기록!채팅기록최근 채팅 기록 조회(기본 30개)전체
!채팅기록 [1~300]!채팅기록 100채팅 기록 개수 지정 조회전체
!채팅순위!채팅순위누적 채팅순위전체
!일간채팅순위!일간채팅순위일간 채팅순위전체
!주간채팅순위!주간채팅순위주간 채팅순위전체
!월간채팅순위!월간채팅순위월간 채팅순위전체
!연간채팅순위!연간채팅순위연간 채팅순위전체
!날씨 [지역명]!날씨 서울지역 날씨 상세 조회전체
!출석 / !출석체크 / !ㅊㅊ!ㅊㅊ출석 체크전체
!출석부!출석부오늘 출석부전체
!일간출석부!일간출석부일간 출석 순위전체
!주간출석부!주간출석부주간 출석 순위전체
!월간출석부!월간출석부월간 출석 순위전체
!연간출석부!연간출석부연간 출석 순위전체
!내출석!내출석내 출석 상세 정보전체
!출석달력 [YYYY-MM]!출석달력 2026-02월간 출석 달력 이미지전체

이미지/미디어#

명령어사용 예시설명권한
!tt!tt기본 이미지 1장 전송전체
!ttt!ttt기본 이미지 3장 전송전체
!프사!프사답장한 유저 프로필 이미지 전송전체(답장 필요)
!프사링!프사링답장한 유저 프로필 카카오링크 전송전체(답장 필요)
!사진 [검색어]!사진 고양이이미지 검색 전송전체
!텍스트 [문구]!텍스트 안녕하세요기본 배경 + 문구 이미지 생성전체
!텍스트 [이미지URL]##[문구]!텍스트 https://...jpg##안녕지정 이미지에 문구 추가전체
!텍스트 검색##[검색어]##[문구]!텍스트 검색##벚꽃##봄이다검색 이미지 + 문구전체
!텍스트추가 [문구]!텍스트추가 테스트::ff0000답장한 이미지에 문구 추가 (::색상HEX 지원)전체(답장 필요)

음악#

명령어사용 예시설명권한
!가사찾기 [가사]!가사찾기 사랑했나봐가사 기반 곡 검색전체
!노래가사 [제목]!노래가사 Butter곡 가사 조회전체
!멜론 [곡명]!멜론 Dynamite멜론 곡 카카오링크전체
!멜론차트!멜론차트멜론 TOP 차트전체
!멜론최신!멜론최신멜론 최신 목록전체
!지니차트!지니차트지니 TOP 차트전체
!tts [문장]!tts 안녕하세요문장을 TTS 오디오로 전송전체
!음악 [검색어]!음악 아이유 밤편지노래 검색 후 오디오 전송(대기열 처리)전체
!룰렛 [이름목록] [옵션]!룰렛 철수,영희 --맵=0 --우승자=first룰렛 영상 생성 후 전송전체

공지/포스트#

명령어사용 예시설명권한
!공지!공지현재 공지 공유전체
!공지 [목록번호]!공지 2텍스트 공지 목록 번호 선택 공유전체
!공지추가 [내용]!공지추가 공지 내용텍스트 공지 포스트 추가스태프(봇 방장/부방장 권한 필요)
!공지등록 [목록번호]!공지등록 1해당 포스트를 공지로 등록스태프(봇 방장/부방장 권한 필요)
!공지삭제 [목록번호]!공지삭제 1봇이 작성한 텍스트 공지 삭제스태프(봇 방장/부방장 권한 필요)
!공지수정 [목록번호] [내용]!공지수정 1 수정내용봇이 작성한 텍스트 공지 수정스태프(봇 방장/부방장 권한 필요)
!공지목록!공지목록텍스트 공지 목록 조회(포스트ID 표시)전체
!방포스트목록!방포스트목록방 전체 포스트 목록 조회(포스트ID 표시)전체

카카오 바로가기#

명령어사용 예시설명권한
!카톡 [메뉴]!카톡 선물함카카오 앱 딥링크 전송전체
!옾프!옾프오픈프로필 관련 카카오링크 전송전체

!카톡 지원 메뉴: 선물함, 이모티콘, , 프로필, 카카오페이, 캘린더, 오픈프로필


개발/테스트#

명령어사용 예시설명권한
!py [파이썬코드]!py print(1)임시 파일로 파이썬 코드 실행관리자
!ev [파이썬코드]!ev chat.reply("ok")런타임에서 코드 평가 실행관리자

자동 기능 (명령어 없이 동작)#

  • 입장/퇴장/강퇴 이벤트 추적 및 저장
  • 멘션/답장 알림 큐 처리 (!알림켜기, !알림끄기와 연동)
  • 키워드 알림 큐 처리 (!키워드알림켜기, !키워드알림끄기와 연동)
  • 유저/채팅 타입 통계 누적
  • 관리방 대상 계약 만료 사전 알림
  • 입장 공지 공유 기능은 대시보드에서 특정 포스트ID를 지정할 수 있습니다. 포스트ID를 비워두면 기존 방식대로 자동 선택된 공지를 공유합니다.
명령어
https://blog.ponyobot.kr/posts/cmd/
저자
훈이
게시일
2026-02-06
라이선스
CC BY-NC-SA 4.0