로봇 소개
봇은 Potato에서 실행되는 타사 애플리케이션입니다. 사용자는 메시지, 명령 또는 인라인 요청을 보내 봇과 상호 작용할 수 있습니다.
봇 개발자는 HTTPS 요청을 통해 호출할 수 있습니다.로봇 API다양한 기능을 갖춘 다양한 로봇이 개발되었습니다.
1. 로봇으로 무엇을 할 수 있나요?

로봇은 일반적으로 다음과 같은 목적으로 사용됩니다.
- 뉴스 로봇과 같은 뉴스 알림을 자동으로 게시합니다. 최신 소식을 받은 후, 최대한 빨리 로봇을 구독하는 사용자에게 푸시될 수 있습니다. 또 다른 예로는 서버의 실행 상태를 모니터링할 수 있는 모니터링 알람 로봇이 있습니다. 이상이 발견되면 즉시 메시지를 보내 서비스 관리자에게 알릴 수 있습니다.
- 외부 서비스와 통합하여 감자 채팅을 풍부하게 할 수 있습니다. 예를 들어, gif 이미지 서버와 통합하여 gif 로봇이 다양한 애니메이션 이미지를 검색할 수 있도록 하여 감자 채팅을 더욱 흥미롭고 편리하게 만들 수 있습니다.
BotGif , BotMusic, BotVote
- 맞춤형 도구 서비스. 예를 들어 일기예보 로봇, 번역 로봇, 비행일정 조회 로봇, 사진 로봇 등이 있다.
BotPic
- 감자는 자유롭고 개방적이기 때문에 로봇은 거의 모든 흥미로운 일을 할 수 있습니다.
2. 로봇은 어떻게 작동하나요?
- 기본적으로 봇은 추가 전화번호가 필요하지 않은 Potato의 특수 계정입니다. 사용자는 두 가지 방법으로 봇과 상호 작용할 수 있습니다.
- 봇과 직접 채팅하거나 그룹에 추가하여 봇에 메시지와 명령을 보내세요. 예를 들어 @BotMusic 로봇과 채팅을 할 때 노래명을 직접 보내 노래 정보를 검색할 수 있습니다.
- 인라인으로 상호작용하려면 입력 상자에 @username를 직접 입력하세요.
키워드를 검색하면 로봇이 원하는 콘텐츠를 쿼리하고 채팅창에 표시할 수 있습니다. 사용자는 @pic와 같은 채팅 개체, 그룹 또는 채널에 쿼리된 콘텐츠를 보내도록 선택할 수 있습니다.
스포츠카, 스포츠카 사진을 많이 얻을 수 있습니다.
- 사용자가 보낸 메시지, 명령, 요청은 Potato 서버로 전달되며,
Potato 서버는 메시지를 사용자의 로봇 서비스에 전달하여 Potato 서비스와 로봇 간의 암호화된 상호 작용을 위한 채널을 설정합니다. 로봇과 감자 서버가 통과해야 합니다.로봇 API진행하세요.
- 로봇 개발에 대한 자세한 내용은 다음을 참고하세요. Bot API
3. 로봇을 만드는 방법?

Potato 클라이언트에서 @BotFather를 검색하고 다음 단계를 완료하세요.
- BotFather 채팅 상자를 열고 /newbot 명령을 입력하세요.
- 봇의 닉네임을 입력하세요.
- 봇의 고유한 사용자 이름을 입력하세요.
- 생성 성공 메시지와 토큰을 수신하면 생성이 완료됩니다.
4. 로봇과 일반 사용자의 차이점은 무엇입니까?
- 봇에는 온라인 상태도 없고 마지막으로 본 타임스탬프도 없습니다.
bot태그는 일반 사용자와 로봇을 명확하게 구분할 수 있습니다.
- 로봇의 메시지 캐시 시간은 제한되어 있습니다. 로봇에 보낸 메시지가 처리되었거나 지정된 시간 내에 처리되지 않은 경우 메시지가 캐시에서 지워집니다.
- 보안상의 이유로 봇은 사용자에게 적극적으로 메시지를 보낼 수 없습니다. 사용자는 신뢰를 얻기 위해 구독과 유사하게 먼저 로봇에 메시지를 보내야 하며, 그런 다음 로봇이 사용자에게 메시지를 보낼 수 있습니다.
- 로봇 사용자 이름은 다음으로 시작합니다.bot공식 로봇을 제외한 엔딩.
- 로봇을 그룹에 추가할 때 로봇이 그룹으로부터 메시지를 받으려면 개인 정보 보호 모드를 false로 설정해야 합니다.
- 로봇은 먹거나 잠을 잘 필요가 없으며 하루 24시간 작동한다.
5. 봇은 어디서 찾을 수 있나요?

6. 로봇 특징
Potato 로봇은 채팅에서 두 가지 유형의 버튼, 인라인 버튼과 키보드 버튼을 생성할 수 있고, 일반적인 마크다운 구문을 지원하고, 텍스트 레이아웃을 더욱 아름답게 만들고, 인라인 모드를 지원하는 등 많은 고유한 기능을 가지고 있습니다.
인라인 모드

- 사용자는 채팅 상자의 텍스트 입력 필드에서 직접 인라인 쿼리를 통해 봇과 상호 작용할 수 있습니다. 그들이 해야 할 일은 봇의 사용자 이름으로 메시지를 시작한 다음 쿼리를 입력하는 것뿐입니다.
- 쿼리를 받은 후 인라인 봇은 쿼리 결과를 반환할 수 있습니다. 사용자는 결과 중 하나를 클릭하여 선택하고 해당 결과는 사용자의 현재 열려 있는 채팅으로 전송됩니다.
이렇게 하면 사람들은 모든 채팅, 그룹 또는 채널에서 쿼리를 보낼 수 있습니다.
키보드
- 물론, 전통적인 챗봇은 인간의 언어를 이해하도록 가르칠 수 있습니다. 그러나 때로는 사용자가 좀 더 편리한 입력을 제공하기를 원할 때도 있습니다. 바로 이 경우 맞춤형 키보드가 매우 유용해집니다.
- 봇이 메시지를 보낼 때마다 미리 정의된 회신 옵션이 있는 특수 키보드를 통해 메시지를 전달할 수 있습니다(ReplyKeyboardMarkup 참조).
메시지를 받은 감자 클라이언트는 사용자에게 키보드를 표시합니다. 아무 버튼이나 탭하면 해당 명령이 즉시 전송됩니다. 이렇게 하면 봇과의 상호 작용을 크게 단순화할 수 있습니다.
- 현재 키보드는 텍스트와 이모티콘을 지원합니다. 다음은 몇 가지 사용자 정의 키보드 예입니다.



- 키보드 보내기 버튼을 참고하세요Bot API
sendTextMessage 인터페이스.
인라인 버튼
- 어떤 경우에는 채팅방에 메시지를 보내지 않고 이를 수행하고 싶을 수도 있습니다. 예를 들어 사용자가 설정을 변경하거나 검색 결과를 탐색하는 경우입니다.
이 경우 해당 메시지에 직접 통합되는 내장 키보드를 사용할 수 있습니다.
- 사용자 정의 응답 키보드와 달리 내장 키보드의 버튼을 눌러도 메시지가 채팅방으로 전송되지 않습니다.
대신 내장 키보드는 콜백 버튼, URL 버튼, 인라인 전환 버튼 등 뒤에서 작동하는 버튼을 지원합니다.
- 콜백 버튼을 사용할 때 봇은 기존 메시지를 업데이트하거나 키보드만 업데이트하여 채팅을 깔끔하게 유지할 수 있습니다.
내장 키보드가 작동하는 모습을 보려면 다음 예시 봇을 확인하세요. @music, @vote
명령
- 명령은 로봇과 통신하는 보다 유연한 방법을 제공합니다. 다음 구문을 사용할 수 있습니다.
- /command [선택 사항] [매개변수]
- 명령은 "/" 기호로 시작해야 하며 32자를 초과할 수 없습니다. 명령에는 라틴 문자, 숫자, 밑줄을 사용할 수 있습니다. 다음은 몇 가지 예입니다.
/get_messages_stats
/set_timer 10min Alarm!
/get_timezone London, UK
- 봇과의 모든 채팅에서 입력란에 추가(/) 버튼을 표시합니다. 탭하면 "/"를 입력하고 명령 목록이 표시됩니다.
- 메시지에서 /command를 강조 표시합니다. 사용자가 강조 표시된 명령을 클릭하면 해당 명령이 즉시 전송됩니다.

- 그룹에 여러 봇이 있는 경우 혼란을 피하기 위해 명령에 봇 사용자 이름을 추가할 수 있습니다.
- /start @TriviaBot
- /start @ApocalypseBot
- 이는 제안 목록을 통해 명령을 선택할 때 자동으로 수행됩니다. 봇은 사용자 이름에 따른 명령을 처리할 수 있어야 합니다.
명령 설정
- 사용자가 봇을 더 쉽게 사용할 수 있도록 모든 개발자가 몇 가지 기본 명령을 지원하는 것이 좋습니다.
- /start--예를 들어 인사말 메시지를 보내 사용자와의 상호 작용을 시작합니다. 이 명령을 사용하여 추가 매개변수를 로봇에 전달할 수도 있습니다.
- /help - 도움말 메시지를 반환합니다. 봇이 수행할 수 있는 작업과 명령 목록에 대한 짧은 텍스트일 수 있습니다.
- 사용자가 처음으로 봇과 대화를 열면 다음과 같은 메시지가 표시됩니다.시작버튼.
도움말 및 설정 링크는 봇 프로필 페이지의 메뉴에서 사용할 수 있습니다.
개인 정보 보호 모드
- 봇은 그룹을 자동으로 관리하거나 알림을 보내기 위해 그룹에 추가되는 경우가 많습니다. 다양한 요구 사항에 따라 로봇의 개인 정보 보호 모드에 대해 다양한 설정을 지정해야 합니다.
- 기본적으로 로봇의 개인 정보 보호 모드는 켜져 있으므로 로봇은 그룹 내 사용자가 보낸 메시지를 받지 않으며 관련 없는 메시지를 대량으로 처리할 필요가 없어 서버 리소스가 절약됩니다.
- 로봇의 비즈니스가 그룹으로부터 메시지를 받아야 하는 경우 개인정보 보호 모드를 비활성화해야 합니다.
- @BotFather에서 개인정보 보호 모드를 활성화 또는 비활성화합니다.
7. BotFather
감자 로봇에 대해 자세히 알아보려면 맨 위로 이동하세요. »
@BotFatherPotato 개인 로봇을 만들고 로봇을 관리하는 데 도움을 줄 수 있습니다.
새 봇 만들기
- 사용
/newbot로봇 생성을 시작하는 명령입니다. 로봇 닉네임과 로봇 이름 설정만 입력하면 개인 로봇 생성이 완료됩니다.@BotFather새 로봇의 인증을 위해 토큰이 생성됩니다.
- 로봇 닉네임은 로봇 명함을 생성하는 데 사용됩니다.
- 봇 이름을 사용하면 사용자가 봇을 검색할 수 있습니다. 봇 이름은 a-z, 0-9 및 _를 사용해야 합니다. 최소 길이는 5자이고 최대 길이는 24자입니다.
숫자로 시작하고 봇으로 끝날 수 없습니다(대소문자를 구분하지 않음).
- 생성된 토큰(예: "110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw")은 로봇에 승인되고 감자에 요청을 보냅니다.
Bot API 서비스에 필요합니다.
새 토큰 생성
- 토큰이 도난당한 것을 발견했거나 업데이트하고 싶다면 다음을 사용할 수 있습니다.
/token명령어는 새 토큰을 생성합니다.
BotFather 명령
- /mybots - 로봇 토큰, 편집, 설정, 삭제 및 기타 기능을 포함한 편리한 제어 기능을 갖춘 로봇 목록을 반환합니다.
봇 편집
- /setname - 로봇 이름 편집
- /setdescription -
'이 봇은 무엇을 할 수 있나요?'에 표시되는 봇을 설명하는 짧은 텍스트(최대 512자)인 봇 프로필을 편집합니다.
- /setabouttext - 더 짧은 텍스트(최대 120자)로 봇을 편집합니다. 이 정보는 봇의 프로필 페이지와 다른 사람과 공유할 때 표시됩니다.
이 정보도 전송됩니다.
- /setuserpic - 로봇 아바타를 편집하고 로봇에 적합한 아바타를 설정합니다.
- /setcommands -
사용자가 봇과의 채팅 상자에 /를 입력할 때 명령 설명 목록과 함께 표시되는 봇 명령을 편집합니다. 지침에는 영숫자 문자와 밑줄을 사용하고 대소문자를 구분하지 않고 최대 32자이며 지침 텍스트 설명을 사용하는 것이 좋습니다.
- /deletebot - 봇 삭제
8. 인라인 모드
- 편리한 명령 모드 외에도 Potato에서는 다음을 사용할 수 있습니다.인라인 모드봇과 상호작용하세요. 이 기능을 활성화하면 사용자는 모든 채팅 대화 상자에서 @bot 이름으로 봇을 호출할 수 있으며 개발자는 해당 기능에 대한 피드백을 제공하는 인라인 푸시 메시지를 받게 됩니다.

- 먼저 당신은@BotFather에 사용/setinline이 기능의 인라인 모드를 켜고 사용자가 @robotname일 때 봇의 쿼리 내용을 알려주도록 쿼리 프롬프트를 설정합니다(예:
GIF 검색) 또는 /empty를 사용하여 이 기능을 끄세요.
- 자세한 내용은 다음을 참조하세요.Bot API
Manual。
인라인 쿼리 결과
- Potato는 현재 기사, 웹 페이지, 사진, 비디오 및 GIF와 같은 5가지 유형의 인라인 쿼리 결과 표시를 지원합니다.

- 클라이언트는 콘텐츠 유형에 따라 수직 또는 수평 스크롤을 사용하여 결과를 표시할 수 있습니다.

- 사용자는 쿼리 결과를 클릭하여 현재 쿼리 내용을 보내고 지웁니다.
인라인/PM 모드 전환
- 일부 내장된 봇은 YouTube와 같은 외부 서비스의 계정에 연결하는 등의 이점을 누릴 수 있습니다. 우리는 봇과의 비공개 채팅과 사용자가 인라인 결과를 공유하려는 채팅 간에 쉽게 전환할 수 있는 방법을 제공했습니다.

- 인라인 결과 위에 특별한 "PM으로 전환" 버튼을 표시할 수 있습니다. 이 버튼을 누르면 봇과의 비공개 채팅이 열리고 선택한 매개변수를 전달하여 사용자에게 관련 설정 작업을 묻는 메시지를 표시할 수 있습니다. 완료되면 사용할 수 있습니다switch_inline_query사용자 정의 키보드는 사용자를 원래 채팅 인터페이스로 되돌립니다.
퍼지다
- 인라인으로 전송된 메시지의 헤더에는 봇 정보가 포함됩니다.
- 사용자가 메시지 제목에서 봇 사용자 이름을 클릭하면 쿼리 내용이 입력 상자에 자동으로 삽입됩니다.
인라인 모드 예
- 인라인 기능이 포함된 다음 공식 봇을 사용할 수 있습니다.
@gif – GIF search
@music – MUSIC search
@app – APP search
@vote – Search polls
9. ADBot
참고:
- 먼저 ADBot를 관리할 그룹에 추가해야 합니다.
- ADBot은 슈퍼 그룹 관리만 지원합니다.
- ADBot는 슈퍼 그룹 관리자로 설정되어야 하며 해당 권한이 부여되어야 합니다.
차단된 키워드를 추가하는 방법
- 사용
/manage자신이 관리자인 그룹을 확인한 후 ADBot에서 관리할 그룹을 선택하는 명령입니다.
- 예:
- "추가" 버튼을 클릭하거나
/add관리 그룹에 차단 키워드를 추가하는 명령입니다.
- 예:
참고:
- 키워드 길이는 64비트로 제한되며 하나의 메시지는 하나의 키워드로 간주됩니다.
- 그룹에는 최대 100개의 고유 키워드를 추가할 수 있습니다.
- /done 명령을 사용하여 현재 작업을 제출하거나 종료합니다.
관리되는 그룹 메시지에 차단된 키워드 정보가 포함되어 있으면 삭제됩니다. URL을 차단하려면 ".com" 또는 "www"와 같은 키워드를 추가하면 됩니다.
- 예:
.
ADBot을 관리자로 설정하고 해당 권한을 부여하세요.
- As follows:
Delete keywords
- 예:
발차기 기능 활성화 여부
- 그룹 내 광고 사용자를 추방하는 기능은 기본적으로 꺼져 있습니다. 이용해주세요
/manage명령의 "킥" 버튼(권장) 또는/kick이 기능을 확인하거나 설정하는 명령입니다.
- 예:
새로운 사용자 그룹 확인 기능
- 신규 사용자가 그룹에 가입할 때 인증 코드를 요구하는 기능은 기본적으로 꺼져 있습니다.
이용해주세요
/manage명령의 "인증 코드" 버튼(권장) 또는/captch이 기능을 확인하거나 설정하는 명령입니다.
- 예: