Bot API
알림, 고객 서비스, 도구 및 자동화 시나리오에 적합한 간단한 HTTPS 인터페이스를 통해 업데이트를 보내고 받고, 메시지를 보내고, 백엔드 서비스에 연결합니다.
- 메시지, 명령 및 콜백 상호 작용
- 그룹 및 채널 보조 기능
- 인라인 결과 및 맞춤 키보드
Potato Developer Platform
Potato API 사용
서비스에 연결
Bot API, 인증된 로그인 및 미니 프로그램 기능을 통해 자동화 도구, 콘텐츠 서비스 및 비즈니스 경험을 Potato 세션에 도입하세요.
개발 기능
로봇부터 경량 애플리케이션까지
제품 시나리오에 따라 적절한 액세스 방법을 선택하세요. 정식 개발에 앞서 현재 공식 인터페이스 문서, 권한 설명 및 검토 요구 사항을 참조하세요.
로봇
봇은 Potato 내에서 실행되는 타사 애플리케이션입니다. 사용자는 개인 채팅, 그룹 또는 입력 상자에서 메시지, 명령 및 인라인 요청을 통해 이를 호출할 수 있습니다.
- 콘텐츠 구독 및 실시간 알림
- 외부 서비스 통합
- 맞춤형 도구 및 그룹 관리
SDK 로그인 승인
계정 시스템 및 비즈니스 프로세스 구축을 위해 사용자 인증을 통해 필요한 기본 정보를 얻습니다. 서비스를 완료하는 데 필요한 권한만 요청하세요.
- 사용자 인증 프로세스 지우기
- 기본 신원 정보 얻기
- 웹사이트 및 앱 로그인에 적용 가능
감자 애플릿
채팅 및 커뮤니티 시나리오에 배포할 수 있는 경량 애플리케이션이나 미니 게임을 구축하여 콘텐츠, 서비스 및 거래에 대한 더 짧은 액세스 경로를 제공하세요.
- 세션 중 검색 및 공유
- 가벼운 대화형 경험
- 플랫폼 기능에 따른 결제 이용
빠른 시작
기본 액세스를 완료하기 위한 4단계
다음은 일반적인 프로세스입니다. 특정 필드, 인터페이스 주소 및 검토 단계는 공식 문서에 따릅니다.
명확한 시나리오
로봇, 로그인, 미니 프로그램의 대상 사용자와 핵심 프로세스를 결정합니다.
애플리케이션 생성
플랫폼 프로세스에 따라 애플리케이션이나 로봇을 생성하고 인증 정보를 올바르게 유지하세요.
연결 서비스
HTTPS 인터페이스를 통해 업데이트, 비즈니스 로직 및 응답을 처리합니다.
온라인 테스트
오류, 권한, 보안 시나리오를 다루고 공식적으로 출시하기 전에 검토를 완료하세요.
Bot Interactive
대화 시나리오에 적합한 기능
명령
슬래시로 시작하는 명령을 사용하면 기능에 대한 안정적이고 검색 가능한 진입점을 제공할 수 있습니다.
맞춤형 키보드
사전 설정된 옵션을 통해 입력 비용을 줄이고 구조화된 작업을 신속하게 수집합니다.
인라인 모드
사용자가 모든 세션에서 봇 사용자 이름으로 콘텐츠를 검색하고 보낼 수 있습니다.
실시간 업데이트
콜백과 인라인 키보드를 사용하여 기존 메시지를 업데이트하여 세션을 깔끔하게 유지합니다.
그룹 개인정보 보호
최소 가시성 원칙을 따르고 로봇이 작업을 완료하는 데 필요한 정보만 처리합니다.
딥 링크
공유 가능한 포털을 통해 사용자를 지정된 로봇이나 비즈니스 프로세스로 안내하세요.
안전 체크리스트 개발
- 토큰은 서버측에만 저장되며 프론트엔드 코드 작성은 금지됩니다.
- HTTPS를 사용하고 요청 소스와 매개변수를 확인하세요
- 업무 완료에 필요한 데이터만 신청 및 저장
- 민감한 작업에 대한 인증, 전류 제한 및 감사를 추가하세요.
- 토큰 유출 후 접속 기록을 즉시 교체하고 문제를 해결합니다.
- 온라인에 접속하기 전에 개인 정보 보호 지침과 사용자 지원 채널을 준비하세요