:AI アシスタントサービスと WeCom の連携

DataWorks AI アシスタントサービスインスタンスの設定

DataWorks コンソールに戻り、インスタンス詳細ページの [基本情報] タブにある [チャネル設定] セクションに移動します。

1. [チャネル設定] セクションで、チャネルとして [WeCom] を選択します。

2. 接続モードとして [URL コールバックを使用] を選択します。

3. 次のパラメーターを入力するか、ランダムに生成します。

   パラメーター	説明	フォーマット要件
   トークン	リクエストの送信元を検証し、リクエストが WeCom サーバーから送信されていることを確認します。	3～32 文字 (英字または数字)
   EncodingAESKey	メッセージの内容を暗号化し、送信中にデータが傍受または改ざんされるのを防ぎます。	フォーマット要件：正確に 43 文字 (数字または英字) である必要があります。 暗号化標準：AES-256-CBC アルゴリズム。

   重要

   トークンと EncodingAESKey は安全に保管し、第三者に開示しないでください。

   トークンと EncodingAESKey は、DataWorks コンソールまたは WeCom 管理コンソールのどちらでも生成できます。一方のコンソールで生成した後、その値をもう一方にコピーします。両方のコンソールでパラメーター値が同一である必要があります。

4. IP ホワイトリストの設定：コールバック URL へのアクセスを、指定された IP 範囲のみに制限します。IP ホワイトリストには、WeCom サーバーの IP を含める必要があります。取得方法の詳細については、「WeCom コールバック IP ドキュメント」をご参照ください。

5. [保存] をクリックします。

   設定を保存した後、インスタンスのステータスが「実行中」に変わるまで待ちます。

インスタンス詳細ページの WeCom チャネル情報で、次の形式のコールバック URL (callbackUrl) を表示できます。

https://ai-assistants.cn-beijing.data.aliyuncs.com/xxxx/plugins/wecom/bot?apikey=sk-ai-assistants-xxxxx

次のステップで WeCom 管理コンソールを設定する際に使用する、完全なコールバック URL (?apikey=... パラメーターを含む) をコピーしてください。ページに「コールバック設定に失敗しました」と表示された場合は、失敗の原因を確認し、設定を再度保存してください。

WeCom 管理コンソールでの設定

1. WeCom 管理コンソールにログインします。

2. [セキュリティと管理] > [管理ツール] > [インテリジェントボット] > [ボットの作成] に移動し、 [API モードで作成] に切り替えます。

3. 接続方法を [URL コールバック] に設定します。

4. 次の 3 つの項目を入力します。

   設定項目	値	説明
   URL	DataWorks コンソールからコピーしたコールバック URL	?apikey=... パラメーターを含む完全な URL
   トークン	DataWorks コンソールで設定したトークンと同じである必要があります	両方のコンソールで同一である必要があります
   EncodingAESKey	DataWorks コンソールで設定した EncodingAESKey と同じである必要があります	両方のコンソールで同一である必要があります (43 文字)

5. [保存] をクリックします。

保存後、WeCom サーバーは自動的にコールバック URL に検証リクエストを送信します。

• 検証成功：WeCom 管理コンソールに成功メッセージが表示され、インスタンスはメッセージの受信を開始できます。

• 検証に失敗しました：Token と EncodingAESKey が完全に一致しているか、インスタンスが実行中の状態であるか、コールバック URL が完全にコピーされているか (?apikey= の部分を含む)、IP ホワイトリストが設定されているかを確認してください。

IP ホワイトリスト

IP ホワイトリストは、不正なリクエストを防ぐために、コールバック URL にアクセスできる IP を制限します。

API キーのローテーション

API キーが漏洩した場合や定期的にローテーションする必要がある場合は、 [URL コールバック] ボタンにカーソルを合わせ、ポップアップウィンドウの更新ボタンをクリックして API キーを更新します。更新後：

• 新しい API キーが生成され、古いコールバック URL は直ちに無効になります。

• WeCom 管理コンソールで新しいコールバック URL を更新する必要があります。

ローテーション後は、WeCom 管理コンソールでコールバック URL を更新してください。そうしないと、メッセージを受信できなくなります。

長寿命接続から URL コールバックへの切り替え

1. チャネル設定で、接続モードを [URL コールバックを使用] に変更します。

2. トークンと EncodingAESKey を入力します。

3. [保存] をクリックした後、「WeCom 管理コンソールでの設定」の説明に従って、WeCom 管理コンソールの設定を完了します。

URL コールバックから長寿命接続への切り替え

1. チャネル設定で、接続モードを [長寿命接続を使用] に変更します。

2. ボット ID とシークレットを入力します。

3. [保存] をクリックすると、Webhook ゲートウェイリソースが自動的にクリーンアップされます。

チャネル設定を変更すると、インスタンスが再起動されます。再起動後、ワークスペースデータ (メモリとスキル) のみが保持されます。カスタム依存関係を再インストールする必要があります。

コールバック URL の検証が失敗する場合

• トークンと EncodingAESKey が、DataWorks コンソールで設定したものと完全に一致しているか確認してください。

• インスタンスが実行中の状態であり、コールバック設定でエラーが表示されていないことを確認してください。

• コールバック URL が (?apikey=... の部分を含めて) 完全にコピーされていることを確認してください。

設定は成功したが、メッセージが受信できない場合

• IP ホワイトリストに WeCom のコールバック IP 範囲が含まれているか確認してください。

• API キーがローテーションされているか確認してください (ローテーションされている場合は、WeCom 管理コンソールでコールバック URL を更新してください)。

• インスタンス詳細ページで、コールバック関連のエラーメッセージがないか確認してください。

インスタンスを削除した後もコールバックがアクティブなままの場合

インスタンスを削除すると、すべてのゲートウェイリソースが自動的にクリーンアップされ、コールバック URL は直ちに無効になります。追加の操作は必要ありません。

ホワイトリストを削除した後にコールバックが機能しない場合

すべてのホワイトリスト IP が削除されると、127.0.0.1 が自動的に追加され、すべての外部アクセスがブロックされます。アクセスを復元するには、WeCom コールバック IP 範囲を再度追加してください。

WeCom サーバーの IP 範囲を取得するにはどうすればよいですか？

「WeCom コールバック IP ドキュメント」をご参照ください。