OceanBase OAgentは、DingTalk、Lark、WeComの3種類のチャネルでロボットとアシスタントとのやり取りをサポートしています。設定完了後、ロボット内で直接OceanBase OAgentのインテリジェントな対話機能を利用できます。
前提条件
設定する前に、対応するチャネルプラットフォーム（DingTalk、Lark、WeCom）で対応するロボットアプリケーションを作成し、必要な認証情報（APP ID、APP Secretなど）を取得していることを確認してください。
各チャネルのAPP IDとAPP Secretの取得
DingTalk Open Platformにログインし、開発者ダッシュボードに入ります。
アプリケーション開発 > アプリケーションの作成をクリックし、アプリケーション名と説明を入力します。
作成が成功したら、アプリケーション詳細ページの認証情報と基本情報セクションから、Client IDとClient Secretを取得します。
左側のメニューでアプリケーション機能の追加を選択し、ロボット機能を追加します。
ロボット設定ページで、ロボット設定機能を有効にし、ロボット名などの必須項目を入力します。メッセージ受信モードはデフォルトでStreamモードになっています。**公開**をクリックします。
左側のメニューで権限管理を選択し、以下の権限を追加します：
Card.Streaming.WriteCard.Instance.Writeqyapi_robot_sendmsg
左側のメニューでバージョン管理と公開 > 新しいバージョンの作成を選択し、バージョン番号とバージョン説明を入力します。アプリケーションの可視範囲を選択し、**保存**をクリックして公開申請を行います。
DingTalkクライアントでロボットを使用する：
- ダイレクトメッセージでの使用：DingTalk上部の検索ボックスで作成したロボット名を検索し、ダイレクトメッセージ画面でメッセージを送信するとロボットと会話できます。
- グループチャットでの使用：グループチャットに入り（グループの所属組織がロボット作成時の組織と同じであることを確認）、グループ設定 > ロボット > ロボットの追加をクリックします。作成したロボットを検索して追加すると、@ロボットで自動返信を実現できます。
説明
ロボットが公開されており、アプリケーションのデプロイが完了していることを確認してください。グループチャットでロボットが見つからない場合は、グループチャットの所属組織がロボット作成時の組織と同じかどうか、またはグループチャットが社内グループではないかどうかを確認してください。
詳細な設定手順については、OpenClawロボットの手動設定をご参照ください。
Lark Open Platformにログインし、開発者ダッシュボードに入ります。
企業独自アプリケーションの作成をクリックし、アプリケーション名と説明を入力して、**作成**をクリックします。
作成が完了すると、アプリケーションの詳細ページに移動します。アプリケーション機能の追加で、ボット機能を追加します。
左側の権限管理ページに移動し、権限管理ページで**一括インポート**を選択し、上記のJSONを貼り付けて、新規権限の確認をクリックします。以下の権限を有効にします：
最小権限設定：
im:message im:chat contact:user.base:readonly一括インポート権限設定（推奨）：
{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:read", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "event:ip_list", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource" ], "user": [ "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } }バージョン管理とリリース > バージョンの作成をクリックし、バージョン番号と更新の説明を入力します。外部共有を希望する場合は選択し、オンラインリリースの申請をクリックして、管理者の承認を待ちます。
承認が通過すると、アプリケーションの資格情報と基本情報ページに戻り、App IDとApp Secretを取得します。
飞书の開発者ダッシュボードに戻り、イベントとコールバックの設定に入ります。イベント設定の下のサブスクリプション方式をクリックし、長い接続のイベントサブスクリプション方式を有効にします。イベントの追加：少なくともメッセージ受信を追加し、その他のイベントは必要に応じて追加します（例：ボットがグループに参加、グループから削除されるなど）。イベントの設定が完了したら、バージョン管理とリリース > バージョンの作成をクリックして、新しいバージョンをリリースし、設定を有効にします。
飞书クライアントでボットを使用する：
個別チャットでの使用：飛书上部の検索ボックスで作成したボット名を検索し、個別チャット画面に入ってメッセージを送信すると、ボットと対話できます。
グループチャットでの使用：グループチャットに入り、グループ設定 > グループボット > ボットの追加をクリックします。作成したボットを検索して追加した後、@ボット を使用することで、自動返信を実現できます。
説明
ボットがリリース済みで、イベントサブスクリプションの設定が完了していることを確認してください。プライベートチャットで使用する場合は、ペアリング検証が必要な場合があります。詳細については、飛书ボット設定ガイドをご参照ください。
WeCom管理ダッシュボードにログインし、左側のナビゲーションペインでセキュリティと管理 > 管理ツールをクリックし、インテリジェントボット > ボットの作成を選択します。
ページ下部でAPIモードで作成を選択し、表示範囲をクリックして、このボットを使用できるメンバーまたは部門を追加します。
API設定エリアで、接続方式を選択します：長い接続の使用：ドメイン名やIPアドレスがなくてもメッセージを受信し、結果を返すことができます。SDKを使用して長い接続を開始し、Bot IDとSecretを設定するだけで、インテリジェントボットに接続できます。
設定方法エリアでBot IDを取得し、Secretを取得するためにクリックします。
**保存**をクリックして、ボットの作成を完了します。
WeComクライアントでボットを使用する：
個別チャットでの使用：WeCom上部の検索ボックスで作成したボット名を検索し、個別チャット画面に入ってメッセージを送信すると、ボットと対話できます。
グループチャットでの使用：社内グループチャットに入り、グループ設定 > ボットの追加をクリックします。作成したボットを検索して追加した後、@ボット を使用することで、自動返信を実現できます。
説明
ボットが公開され、アプリケーションのデプロイが完了していることを確認してください。インテリジェントボットは社内グループチャットでのみ利用可能で、外部グループは現在サポートされていません。詳細な設定手順については、WeComインテリジェントボット使用ガイドをご参照ください。
OceanBase OAgentチャネルの設定
OB Cloudデータベースコンソールにログインします。
右側上部のナビゲーションバーで、OceanBase OAgent をクリックします。OceanBase OAgentの対話画面が表示されます。
右側上部のナビゲーションバーにある設定ボタンをクリックし、設定するチャネル（DingTalk、Lark、またはWeCom）を選択して、+ 追加 ボタンをクリックします。
表示された設定ページで、以下の情報を入力します：
APP ID：該当プラットフォームのアプリケーションのAPP IDを入力します。
APP Secret：該当プラットフォームのアプリケーションのAPP Secretを入力します。
ユーザーID許可リスト：ユーザーIDを入力します。複数のIDは半角カンマで区切ります。空の場合、すべてのユーザーがアクセス可能であることを意味します。
確定 をクリックして設定を完了します。設定完了後、ボットで直接OceanBase OAgentのインテリジェント対話機能を使用できます。