eTelecom docs
English
English
  • INSTRUCTIONS FOR USE
    • Administration page for cs.etelecom
    • Google Chrome Extension
    • App eTelecom
  • API INTEGRATION
    • Shop
      • Account
      • Usage
    • Partner
      • Account
      • Usage
    • VPBX
      • VoIP SDK
        • Android
        • iOS
        • Web
        • Flutter
      • PBX REST APIs
        • Partner Get Tenant List
        • Partner Add Hotline
        • Partner Get Hotline List
        • Partner Activate Tenant
        • Partner Add Hotline To Tenant
        • Partner Removed Hotline From Tenant
        • Partner Remove Hotline
        • Create Tenant
        • Get Tenant information
        • Get Driver Config
        • Get hotline list
        • Create Account User
        • Get List User
        • Create extension
        • Get extension information
        • Get extension list
        • Assign extension to user
        • Change hotline for extension
        • Remove User Of Extension
        • Get call history
    • Zalo Cloud
      • Instructions for connecting Zalo Cloud
      • Zalo Cloud API
        • Create OA authorization link
        • Connect OA
        • Get refresh token
        • Get OA list
        • Get OA information
        • Update Webhook for OA
        • Get list of users
        • Send Text Consulting
        • Send Consulting message according to user information request form
        • Send advice message with sticker
        • Send message Consulting with attached photo
        • Send message Consulting attached file
        • Send transaction message
        • Upload file
        • Send request for calling permission
        • Check if the customer has granted calling permission
        • Get list of requests for calling permission
        • Create a news template
        • Get sample details
        • Get list of news samples
        • Journey Token Creation
        • Get Journey Token Details
        • Get Journey Token List
        • Get message list
        • Get message details
        • Send ZNS
        • Send ZNS with Journey Token
  • SMS BRANDNAME
    • User manual
    • SMS API
      • Send SMS
      • Get message status
      • Get sample details
Powered by GitBook
On this page
  1. API INTEGRATION
  2. Zalo Cloud
  3. Zalo Cloud API

Get OA information

This API is used to get OA information such as: Message sending quality, ZNS message quota, tag 3 message quota (after-sales),....

PreviousGet OA listNextUpdate Webhook for OA

Last updated 5 months ago

Note:

  • For APIs used for Shop, the API key is: . The base_url information of the .

  • For APIs used for Partner, the API key is: . The base_url information of the .

Request:

curl --location 'BASE_URL.Zalo/GetShopOA' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
  "oa_id": "string"
}'

Response:

{
  "app_id": "string",
  "avatar": "string",
  "connection_id": "string",
  "connection_method": "unknown",
  "cover": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "current_quality": "unknown",
  "daily_quota": 0,
  "daily_quota_promotion": 0,
  "description": "string",
  "estimated_next_month_promotion_quota": 0,
  "expires_at": "2019-08-24T14:15:22Z",
  "is_verified": true,
  "last_week_quality": "unknown",
  "monthly_promotion_quota": 0,
  "name": "string",
  "oa_id": "string",
  "onwer_id": "string",
  "remaining_monthly_promotion_quota": 0,
  "remaining_quota": 0,
  "shop_id": "string",
  "status": "Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "webhook_url": "string"
}

Request body structure

Parameters
Data type
Describe

id

int64

OA ID

Return data attribute structure

Parameters
Data type
Describe

app_id

int64

Application ID

avatar

string

Link to OA cover photo

connection_id

int64

Connection ID

connection_method

string

Connection method

description

string

Describe

is_verified

boolean

True: OA verified

False: OA not verified

name

string

OA Name

id

int64

OA ID

owner_id

int64

Shop owner ID on eTelecom system

shop_id

int64

Shop ID on eTelecom system

status

string

Status

P: Connecting

N: Disconnect

current_quality

string

OA's ZNS notification delivery quality in the last 48 hours.

  • HIGH - Good quality level

  • MEDIUM - Medium quality level

  • LOW - Low quality level

  • UNDEFINED - OA quality level not determined (in case OA did not send any ZNS notification within the evaluation timeframe)

last_week_quality

string

OA's ZNS notification sending quality in the last 7 days.

Return values:

  • HIGH - Good quality level

  • MEDIUM - Medium quality level

  • LOW - Low quality level

  • UNDEFINED - OA quality level not determined (in case OA did not send any ZNS notification within the evaluation timeframe)

daily_quota

int

Number of ZNS OA notifications sent in 1 day.

remaining_quota

int

Number of ZNS OA notifications sent in the remaining day.

daily_quota_promotion

int

Number of ZNS OA after-sales messages sent per day. Note: From November 1st, this attribute will return null value

monthly_promotion_quota

int

Number of ZNS after-sales OA messages sent during the month.

remaining_monthly_promotion_quota

int

The remaining ZNS after-sales OA messages sent during the month.

estimated_next_month_promotion_quota

int

Estimated number of ZNS after-sales messages that OA can send in the next month.

expires_at

string<date-time>

Refresh token expiration time

updated_at

string<date-time>

Update date

created_at

string<date-time>

Date created

<api_key>
Shop
<shop_key>
Partner