Zalo 向け ConnectWiz
アーリーアクセスベトナムの利用者7,000万人。OA は1つ。トークンの子守はゼロ。
Zalo はリフレッシュトークンを使うたびに入れ替えます。多くの連携を静かに殺す、あの認証情報の踊りです。ConnectWiz は送信の途中で起きる入れ替えを処理し、新しい組を保存し、一度だけ再試行して、会話を止めません。
Chào bạn! Đơn #4419 đang trên đường giao, dự kiến đến trước 17h hôm nay 🚚
このチャネルを選ぶ理由
なぜ Zalo がベトナムのビジネスチャネルなのか
ベトナムの商いが話す場所
Zalo はベトナムの既定のメッセンジャーです。注文も、質問も、信頼も、顧客が最初に確認するのはここです。
ベトナム語優先の AI
Wiz はベトナム語を判別し、自社のコンテンツをもとにベトナム語で回答します。チームは双方向の翻訳でそのあとを引き継げるので、ベトナム語の話者は必要ありません。
拠点なしでの越境
ベトナム語で即座に応答する Zalo の OA があれば、越境の事業者が実際に顧客を失っている言語とチャネルの壁がなくなります。
接続とセキュリティ
プラグインの後付けではなく、チャネルとして設計
Zalo のイベントはすべて、会話に触れる前に暗号的に検証され、重複が排除されます。橋渡しを信頼できるものにするのは、こうした退屈な保証です。
本物の OA 接続
アプリの認証情報、アクセストークン、リフレッシュトークン、そして OA のシークレット。この5点を、公式アカウントのプロフィールを読んで検証します。アプリ ID 以外はすべて、保存時に暗号化されます。
入れ替えを生き延びる
送信が期限切れのトークンに当たると、ConnectWiz は組を更新し、新しいトークンを両方とも保存し、一度だけ再試行します。多くの Zalo 連携が取り違えるこの踊りを、専用のテストで押さえています。
署名つきの受信
イベントはすべて、Zalo の複合署名方式で一定時間をかけて検証されます。偽装された Webhook は入口で跳ね返されます。
癖はこちらで吸収する
Zalo は標準の bearer ではなく、裸のヘッダーにトークンを載せることを求めます。文書化されている癖で、クライアント側が処理するので、その存在を知る必要はありません。
受信トレイ
1通目から受信トレイの機能をひととおり
振り分け済みの会話
Zalo のメッセージは、部署への振り分け、割り当て、タグ、@メンション付きの内部メモ、そして履歴の全体を伴う会話として届きます。デスクトップでも、担当者向けモバイルアプリでも同じです。
まず Wiz が答える
AI エージェントは自社のコンテンツをもとに52言語で回答し、スレッドを添えて担当者にエスカレーションします。担当者はワンクリックで AI に戻せます。ほかのチャネルとまったく同じ頭脳です。
顧客レコードは1つ
Zalo の識別子は、メールやほかのすべてのチャネルと同じ CRM の連絡先に加わります。人は1人、履歴は1本、同意の状態も1つです。
双方向の翻訳
担当者は受信メッセージを必要に応じて自分の言語で読み、下書きは顧客の言語に翻訳して送れます。処理はメッセージ単位で、次に読む人のためにキャッシュされます。
営業時間を把握
営業時間外のメッセージには見込み時間を正直に伝え、翌朝のキューの先頭に置きます。初回応答時間が測るのはボットではなく人です。
テキストを確実に
現時点の適用範囲は、テキストの双方向メッセージです。Zalo の公式 API を通じて送られ、会話の上で追跡され、黙って捨てられることはありません。
技術的な仕組み
「アーリーアクセス」を安全に運用できる内部の仕組み
台帳で重複なしを保証
イベントはすべて、処理の前に idempotency キーを確保します。Zalo の再送はデータベース層で止まります。
全チャネルと同じ処理経路
振り分け、AI の起動、ブロック、履歴は、どのチャネルも使う同じコード経路です。
失敗は理由を返す
拒否された送信は、理由をスレッドに載せて失敗として記録されます。沈黙で済ませることはありません。
テキストのイベントだけ。これは意図
現時点で処理するのは、利用者のテキストイベントだけです。ほかの Zalo のイベント種別は、受け取ったうえで脇に置きます。あとから気づく形にせず、ここに書いておきます。
包み隠さない適用範囲
ここでの「アーリーアクセス」の意味を、書面で
勝手にではなく、一緒に有効化
連携は実装と検証を終えていますが、無条件に「稼働中」と表示できるだけの本番トラフィックはまだ通していません。そのため、当社のチームが並走しながらワークスペースごとに有効化します。バッジはその状態を指しています。
現時点はテキストのみ
メディア、ボタン、リッチ要素はロードマップ上にあり、意図的に約束していません。まだ存在しない作成機能を売り込むページは、得る信頼より失う信頼のほうが大きいからです。
楽観的な配信
送信は API レベルで確認できますが、メッセージ単位の配信確認はこのチャネルではまだ実装していません。スレッド上でも実装済みのようには見せていません。
コンソールでの作業は1回
Zalo には Webhook を登録する API がないため、Zalo の OA コンソールでコールバック URL を設定する作業だけは一度だけ手で行います。パネルにも、そのとおり正直に記録します。
ロードマップと卒業条件
次に実装するもの、そしてバッジが変わる条件
卒業の基準はマーケティングではなく計測です。チャネルを端から端まで検証できるだけの本番トラフィックを通すこと。それができた時点でバッジが外れ、以下が順に実装されます。
メディアは双方向
画像とファイルが最初の卒業項目です。
対話的な要素
Zalo のリッチなメッセージ種別は、メディアのあとに続きます。順番は偽りません。
配信確認
現時点では API レベルでの確認まで。配信確認は卒業とともに実装します。
スタンダードチャネル
費用
ConnectWiz 側
- Zalo は スタンダードチャネル：プランに含まれるチャネル枠から1つ選ぶか、 月額 $9 の追加オプションとして利用できます。アーリーアクセス期間中も同じ価格です。
- アーリーアクセスでは人手が増えます。追加費用なしで、有効化も監視も一緒に行います
- 会話はプランの通常の会話数に計上され、AI の回答は AI クレジットから消費されます
Zalo 側
自社の Zalo アカウント、認証、プラットフォーム側の規約は、自社と Zalo のあいだに残ります。ConnectWiz は上乗せをせず、アカウントの関係を代理することもありません。