← API 參考
渠道方對比

Zalo 接入授權

Zalo 淨係支援 qrcode 登入，唔使預先有憑證 — 使用者身分要等掃完碼先知。

qrcode

Zalo QR 登入：唔使預先有憑證，使用者身分掃咗碼之後由 session payload 揭開。

  1. 1. POST /v1/accounts，provider=zalo、auth_mode=qrcode。
  2. 2. POST /v1/accounts/{account_id}/auth/qr/start，回應入面嘅 auth_payload.token 就係要顯示嘅 QR token。
  3. 3. 輪詢 POST /v1/accounts/{account_id}/auth/qr/check。過期會回 qrcode_expired，要重新叫 qr/start。
  4. 4. 成功後 POST /v1/accounts/{account_id}/runtime/start。

備註

  • QR token 過期會回 status=qrcode_expired，叫 qr/start 重新攞個新嘅就得。
  • 需要配置 Webhook 端點，用嚟接收認證同訊息事件。
  • thread type 0 係朋友對話，1 係 group。發訊息嗰陣會做歸一化。