> For the complete documentation index, see [llms.txt](https://docs.innopaas.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.innopaas.com/api-reference/whatsapp-business-api/whatsapp-business-api/zhang-hao-account.md).

# 账号（Account）

## 获取余额

### **请求接口**

| **GET** | <https://api.innopaas.com/api/whatsapp/v3/account/getBalance> |
| ------- | ------------------------------------------------------------- |

### **响应参数**

| 字段              | 数据类型    | 是否必填 | 描述                                                  |
| --------------- | ------- | ---- | --------------------------------------------------- |
| payType         | Integer | 是    | 1:预付费账号，2:后付费账号                                     |
| preBalance      | Double  | 是    | 预付费余额,payType=1时，校验余额                               |
| postBalance     | Double  | 是    | 后付费授信余额,payType=2时，校验余额，如果isCreditUnlimit=1，授信额度不受限 |
| isCreditUnlimit | Integer | 是    | 后付费授信是否限制，0:限制 ，1不限制                                |

### **响应示例**

```json
{
    "code": "0",
    "message": "Success",
    "data": {
        "payType": "",
        "preBalance": "innopaas street1.",
        "postBalance": "my test2",
        "isCreditUnlimit": "admin@innopaas.com",
        }
}
```

## 授权Waba到InnoPaaS

### **请求接口**

| POST | <https://api.innopaas.com/api/whatsapp/v3/business/authorized> |
| ---- | -------------------------------------------------------------- |

### **请求参数**

| 字段                  | 数据类型   | 是否必填 | 描述                                                                                                                                                                                                            |
| ------------------- | ------ | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| event               | String | 是    | 授权事件：Business App授权FINISH\_WHATSAPP\_BUSINESS\_APP\_ONBOARDINGWaba Sender 授权FINISH\_WHATSAPP\_BUSINESS\_PHONE\_ONBOARDINGMMLITE授权FINISH\_WHATSAPP\_MMLITE\_ONBOARDINGADS广告授权FINISH\_WHATSAPP\_ADS\_ONBOARDING |
| type                | String | 是    | *固定值：WA\_EMBEDDED\_SIGNUP*                                                                                                                                                                                    |
| code                | String | 是    | 授权Code                                                                                                                                                                                                        |
| data                | Object | 是    | 具体授权信息                                                                                                                                                                                                        |
| --waba\_id          | String | 否    | Waba Id, Business App授权，Waba Sender 授权\*，必填\*                                                                                                                                                                 |
| --phone\_number\_id | String | 否    | 绑定号码Id, Business App授权，Waba Sender 授权\*，必填\*                                                                                                                                                                  |
| --business\_id      | String | 否    | BS企业ID，Business App 授权，Waba Sender 授权 ，MMLITE授权时，*必填*                                                                                                                                                         |
| --waba\_ids         | String | 否    | Waba Id列表，MMLITE授权时，*必填*                                                                                                                                                                                      |
| --page\_ids         | String | 否    | *页面ID列表，CTWA、PageId授权时，必填*                                                                                                                                                                                    |
| --dataset\_ids      | String | 否    | *​数据集ID列表 。​*CTWA、数据集授权时，必填                                                                                                                                                                                   |
| --catalog\_ids      | String | 否    | *​目录ID列表 。​*CTWA、数据集授权时，必填                                                                                                                                                                                    |

### **请求示例**

```json
{
    "event":"FINISH_WHATSAPP_BUSINESS_PHONE_ONBOARDING",
    "type":"WA_EMBEDDED_SIGNUP",
    "code":"asodaosdoausiduaoisduoiasudiuahsdisadaisjdoajsdkj",
    "data":{
         "business_id":123123123123123,
         "waba_id":123123123123123,
         "phone_number_id":12121212
     }
}
```

### **响应示例**

```json
{
"code": "0",
"message": "Success",
}
```

## 获取Waba列表信息

### **请求接口**

| POST | <https://api.innopaas.com/api/whatsapp/v3/account/wabaInfo> |
| ---- | ----------------------------------------------------------- |

### **响应参数**

| 字段         | 数据类型   | 是否必填 | 描述                                                                                      |
| ---------- | ------ | ---- | --------------------------------------------------------------------------------------- |
| wabaId     | String | 是    | WhatsApp商业账户唯一标识                                                                        |
| wabaName   | String | 是    | WhatsApp商业账户名称                                                                          |
| wabaStatus | String | 是    | 状态​**PENDING**​:审核中​**APPROVED**​:审核通过​**REJECTED**​:驳回​**PAUSED**​:暂停​**DISABLED**​:禁用 |

### **响应示例**

```json
{
    "code": "0",
    "message": "Success",
    "data": [
        {
            "wabaId": "***123****",
            "wabaName": "PT TIG TECH ",
            "wabaStatus": "APPROVED"
        },
        {
            "wabaId": "*****456****",
            "wabaName": "PT TIG CODE ",
            "wabaStatus": "APPROVED"
        }
    ]
}
```

## 获取Waba 号码信息

### **请求接口**

| POST | <https://api.innopaas.com/api/whatsapp/v3/account/phoneInfo> |
| ---- | ------------------------------------------------------------ |

### **请求参数**

| 字段     | 数据类型   | 是否必填 | 描述               |
| ------ | ------ | ---- | ---------------- |
| wabaId | String | 是    | WhatsApp商业账户唯一标识 |

### **请求示例**

```json
{
    "wabaId":"27899******57661"
}
```

### **响应参数**

| 字段                 | 数据类型   | 是否必填 | 描述      |
| ------------------ | ------ | ---- | ------- |
| id                 | String | 是    | *手机号id* |
| displayPhoneNumber | String | 是    | 显示号码    |
| verifiedName       | String | 是    | 名称      |
| status             | String | 是    | 号码状态    |
| qualityRating      | String | 是    | 号码质量    |
| messageLimit       | String | 是    | 消息限制    |

### **响应示例**

```json
{
"code": "0",
"message": "Success",
"data": [
    {
        "id": "3142****760025",
        "displayPhoneNumber": "+62 852-****-0016",
        "verifiedName": "name",
        "status": "CONNECTED",
        "qualityRating": "GREEN",
        "messageLimit": "TIER_250"
    }
]}
```