OpenClawでベトナムの通信アプリZaloに接続する

Zalo はベトナムで最も広く使用されているインスタントメッセージングアプリで、7,000 万人以上のユーザーを擁し、ベトナム市場では欠かせないコミュニケーションチャンネルです。OpenClaw はプラグインシステムを通じて Zalo Official Account（OA）への接続をサポートしており、ベトナムのユーザーに AI 駆動のインテリジェントカスタマーサポートや自動化サービスを提供できます。

前提準備

設定を開始する前に、以下を準備する必要があります。

OpenClaw インスタンスがデプロイ済みで正常に動作していること
Zalo Official Account（Zalo OA 管理プラットフォームでの登録が必要）
Zalo OA の App ID と Secret Key
パブリックにアクセス可能な webhook コールバックアドレス

Zalo Official Account の作成

Zalo OA がまだない場合は、まず oa.zalo.me で登録・作成する必要があります。Zalo OA にはいくつかのタイプがありますが、AI ボットのシーンでは通常の OA を作成すれば十分です。登録時には企業情報と連絡先の提供が必要です。

作成完了後、OA 管理画面の「設定」>「開発者」ページに移動すると、App ID と Secret Key が確認できます。同時にこのページで webhook URL を設定し、関連するイベントを購読する必要があります。

Zalo 開発者設定の構成

Zalo OA の開発者設定で、以下の操作を完了する必要があります。

Webhook URL の設定：コールバックアドレスを OpenClaw インスタンスの Zalo エンドポイントに設定します。形式は https://your-domain.com/webhooks/zalo です。

イベントの購読：「ユーザーがメッセージを送信」イベントタイプにチェックを入れます。これにより、ユーザーが OA にメッセージを送信した際に、Zalo がメッセージを webhook アドレスに転送します。

OA Access Token の取得：OAuth フローを通じて長期有効な Access Token を取得します。Zalo の Access Token には有効期限があり、Refresh Token を使用して定期的に更新する必要があります。OpenClaw の Zalo プラグインには Token の自動更新メカニズムが組み込まれています。

Zalo プラグインのインストール

OpenClaw プラグインシステムを通じてインストールします。

openclaw plugin install zalo

インタラクティブコマンドで設定します。

openclaw channels login zalo

プロンプトに従って App ID、Secret Key、Access Token を入力します。

openclaw.json の設定

手動設定の方法:

{
  "channels": {
    "zalo": {
      "enabled": true,
      "appId": "your-app-id",
      "secretKey": "your-secret-key",
      "accessToken": "your-access-token",
      "refreshToken": "your-refresh-token"
    }
  }
}

Refresh Token を設定すると、OpenClaw は Access Token の期限切れ前に自動的に Refresh Token を使用して新しいトークンを取得し、サービスの中断を防ぎます。

メッセージタイプの処理

Zalo OA は複数のメッセージタイプをサポートしています。OpenClaw の Zalo プラグインは以下のタイプの受信メッセージを処理できます。

テキストメッセージ：最も基本的なインタラクション方式。ユーザーがテキストを送信し、AI がテキストで返信
画像メッセージ：ユーザーが送信した画像は説明テキストに変換されるか、マルチモーダル AI モデルに渡されて処理
スタンプとエモーション：このタイプのメッセージは通常無視され、AI の返信はトリガーされません

送信する返信については、プラグインは主にテキストメッセージ形式を使用します。AI の返信に画像リンクが含まれる場合、画像メッセージ形式での送信を設定できます。

Zalo OA のメッセージルール

Zalo は OA のメッセージ送信にいくつかの重要な制限ルールを設けています。

OA はユーザーが能動的にメッセージを送信してから 48 時間以内にのみ返信できます。48 時間を超えた後にユーザーに能動的に連絡する必要がある場合は、「プロアクティブプッシュ」の配分（月間制限あり）を使用する必要があります。OpenClaw は各ユーザーの最終メッセージ時刻を自動的にトラッキングし、48 時間のウィンドウ内では通常通り返信し、ウィンドウを超えた場合は警告ログを記録します。

また、Zalo は OA が送信するメッセージの内容がプラットフォームポリシーに準拠し、違反コンテンツを含まないことを要求しています。

セキュリティ設定

allowlist を使用してインタラクション可能なユーザーの範囲を制限します。

{
  "channels": {
    "zalo": {
      "allowlist": ["user_id_1", "user_id_2"]
    }
  }
}

Zalo OA 自体がフォロー制のモデルであるため——ユーザーは先に OA をフォローしないとメッセージを送信できません——すでに自然なフィルタリング層が存在します。OpenClaw の allowlist と DM ペアリング機能を組み合わせることで、アクセス制御をさらに厳格にできます。

ベトナム市場に関する注意事項

ベトナムのユーザー向けに AI サービスをデプロイする際は、以下の点に注意してください。まず、AI モデルがベトナム語（声調符号付きの文字を含む）を適切に処理できる必要があります。次に、ベトナムのユーザーはスタンプやエモーションパックを使ったコミュニケーションを好むため、Bot はこれらの非テキストメッセージをエレガントに処理できるべきです。最後に、Zalo のベトナムでの使用ピーク時間帯は主に午前と夜間に集中しているため、これらの時間帯にはサービスの安定性を確保することを推奨します。

マルチチャンネル共存

Zalo チャンネルは OpenClaw の他のすべてのチャンネルと同時に動作できます。ビジネスがベトナムと国際市場の両方を対象としている場合、Zalo でベトナムのローカルユーザーにサービスを提供し、同時に WhatsApp、Telegram などで国際ユーザーにサービスを提供できます。すべてのチャンネルが同じ AI モデルバックエンドとナレッジベース設定を共有するため、運用の複雑さが大幅に軽減されます。