ボット API
シンプルな HTTPS インターフェイスを介して更新の送受信、メッセージの送信、バックエンド サービスへの接続を行うことができ、通知、カスタマー サービス、ツール、自動化のシナリオに適しています。
- メッセージ、コマンド、コールバックの相互作用
- グループとチャネルの補助機能
- インライン結果とカスタムキーボード
Potato Developer Platform
Potato API の使用
サービスに接続します
ボット API、承認されたログイン、ミニ プログラム機能を通じて、自動化ツール、コンテンツ サービス、ビジネス エクスペリエンスを Potato セッションに導入します。
開発機能
ロボットから軽量アプリケーションまで
製品シナリオに従って適切なアクセス方法を選択します。正式な開発の前に、現在の公式インターフェイスのドキュメント、権限の説明、要件を確認してください。
ロボット
ボットは、Potato 内で実行されるサードパーティ アプリケーションです。ユーザーは、メッセージ、コマンド、プライベート チャット、グループ、または入力ボックスのインライン リクエストを介してこれを呼び出すことができます。
- コンテンツサブスクリプションとリアルタイム通知
- 外部サービス統合
- カスタマイズされたツールとグループ管理
SDK へのログインを承認します
アカウントシステムや業務プロセスを構築するために、ユーザー認証を通じて必要な基本情報を取得します。サービスを完了するために必要な権限のみをリクエストしてください。
- ユーザー認証プロセスをクリアする
- 基本的な ID 情報を取得する
- Web サイトとアプリのログインに適用可能
ポテト アプレット
チャットやコミュニティのシナリオに展開できる軽量のアプリケーションやミニゲームを構築して、コンテンツ、サービス、トランザクションへのより短いアクセス パスを提供します。
- セッション中の検出と共有
- 軽量インタラクティブエクスペリエンス
- プラットフォームの機能に応じて支払いにアクセスする
クイックスタート
基本的なアクセスを完了するための 4 つの手順
一般的なプロセスは次のとおりです。特定のフィールド、インターフェイス アドレス、およびレビュー手順は、公式文書の対象となります。
明確なシナリオ
ターゲット ユーザーと、ロボット、ログイン、またはミニ プログラムのコア プロセスを決定します。
アプリケーションの作成
プラットフォームのプロセスに従ってアプリケーションまたはロボットを作成し、認証資格情報を適切に保管します。
接続サービス
HTTPS インターフェイスを通じて更新、ビジネス ロジック、応答を処理します。
オンラインテスト
エラー、権限、セキュリティ シナリオをカバーし、正式にリリースする前にレビューを完了します。
ボットインタラクティブ
会話のシナリオに適した機能
コマンド
スラッシュで始まるコマンドを使用して、機能への安定した検出可能なエントリ ポイントを提供します。
カスタマイズされたキーボード
プリセット オプションにより入力コストを削減し、構造化された操作を迅速に収集します。
インライン モード
ユーザーがどのセッションでもボット ユーザー名でコンテンツを検索し、送信できるようにします。
リアルタイム更新
コールバックとインライン キーボードを使用して既存のメッセージを更新し、セッションをクリーンな状態に保ちます。
グループのプライバシー
可視性を最小限にするという原則に従い、ロボットがタスクを完了するために必要な情報のみを処理します。
ディープリンク
共有可能なポータルを通じて、ユーザーを指定されたロボットまたはビジネス プロセスに誘導します。
安全性チェックリストの作成
- トークンはサーバー側にのみ保存され、フロントエンドコードの書き込みは禁止されます。
- HTTPS を使用し、リクエスト ソースとパラメータを確認します。
- ビジネスを完了するために必要なデータのみを申請して保存します。
- 機密性の高い操作に対する認証、電流制限、監査を追加します。
- トークンが漏洩した後、アクセス レコードを直ちにローテーションしてトラブルシューティングします。
- オンラインになる前に、プライバシーに関する指示とユーザー サポート チャネルを準備します。
構築を始める準備はできましたか?
最初にロボットに関する入門情報をお読みください。ビジネスまたはプラットフォームへのアクセスのサポートが必要な場合は、直接お問い合わせください。