MUSUWAMUSUWA

API

オーケストレーション

仮想メンバーオーケストレーションAPI。

インデックスに戻る

認証: Authorization: Bearer sbot_…

GET/api/v1/bots/listChatVirtualMembers
Bot Token

listChatVirtualMemberslistChatVirtualMembers (付加価値機能)

グループ内の派遣可能なメンバーをリストします。ボットはアクティブなメンバーである必要があります。デフォルトでは開かれていないため、サポートを通じて申請してください。

  • 必填 query：chat_id（群会话 ID）
  • 可选 query：limit (1-200，默认 50)、offset (≥0，默认 0)
  • 返回：{ items: [{ virtual_user_id, name, username, avatar, joined_at }], pagination: { total, limit, offset } }
  • 403: 機能がアクティブ化されていない、ロボットがグループに含まれていない、または会話がグループ チャットではありません
POST/api/v1/bots/simulateSendMessage
Bot Token

simulateSendMessagesimulateSendMessage (付加価値機能)

選択された配信可能メンバーとして、グループ内でテキスト、写真、ドキュメント、音声、動画、または位置情報メッセージを送信します。アクセス要件は `listChatVirtualMembers` と同じで、すべての呼び出しはコンプライアンスのために記録されます。

  • すべてのメッセージに必須: chat_id と virtual_user_id は listChatVirtualMembers から取得します
  • メッセージタイプ: オプションの type、デフォルトは text；text、photo / image、document / file、audio、video、および location を受け入れます
  • テキスト: text は必須で、1-1000文字を含む必要があります
  • メディア: file_id は必須; オプションの caption は1000文字に制限されています; duration、width、height、performer、title、および thumbnail_url を適用可能な場合に使用します
  • 位置: latitude (-90..90) および longitude (-180..180) は必須; オプションの name (≤200) および address (≤500)
  • すべてのタイプに対してオプション: reply_to_message_id (≤128); メディア file_id をアップロード資格情報と完全なエンドポイントを通じて取得
  • 返される: 対応する送信エンドポイントと同じメッセージオブジェクトの形状
  • 400: 欠落、サポートされていない、または無効なフィールド; 403: 機能が無効 / メンバーがグループにいない / メンバーが利用できない; 404: 仮想メンバーが見つかりません