← API リファレンス
プロバイダ比較

Zalo 認証

Zalo は qrcode ログインのみ対応。事前に資格情報は不要で、ユーザーは QR スキャン時に判明します。

qrcode

Zalo QR ログイン：事前の資格情報は不要。ユーザー情報は QR スキャン後に session ペイロードから判明します。

  1. 1. POST /v1/accounts に provider=zalo、auth_mode=qrcode を指定。
  2. 2. POST /v1/accounts/{account_id}/auth/qr/start のレスポンスにある auth_payload.token が表示用の QR トークン。
  3. 3. POST /v1/accounts/{account_id}/auth/qr/check をポーリング。失効すると qrcode_expired が返り、qr/start で取り直す必要がある。
  4. 4. 成功したら POST /v1/accounts/{account_id}/runtime/start。

注記

  • 失効した QR トークンは status=qrcode_expired を返します。qr/start を呼び直して取り直してください。
  • 認証イベントとメッセージイベントを受け取るため、Webhook エンドポイントの設定が必要です。
  • thread type の 0 は友だち会話、1 はグループです。メッセージ送信時に正規化されます。