
# 接受TELEGRAM消息接口
#### 场景描述
接受TELEGRAM消息。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/telegram/message/{chanId}，例如域名是service.besclouds.com。
表1接口URI参数说明 
| 序号 | 名称     | 参数类型   | 是否必选  | 说明   |
|:---|:---|:---|:---|:---|
| 1  | chanId | string | False | 渠道Id |
   
#### 请求说明
表2请求参数说明 
| 序号        | 名称             | 参数类型            | 是否必选  | 说明               |
|:---|:---|:---|:---|:---|
| 1         | requestBody    | object          | False | 请求体json          |
| 1.1       | update_id      | number          | False | 更新的唯一标识符         |
| 1.2       | message        | object          | False | 消息体json          |
| 1.2.1     | message_id     | number          | False | 消息唯一标识           |
| 1.2.2     | from           | object          | False | 发送者json          |
| 1.2.2.1   | id             | number          | False | 发送者id            |
| 1.2.2.2   | is_bot         | boolean         | True  | 是否机器人            |
| 1.2.2.3   | first_name     | string          | False | 名字               |
| 1.2.2.4   | username       | string          | False | 用户名              |
| 1.2.2.5   | language_code  | string          | False | 用户语言标识           |
| 1.2.3     | chat           | object          | False | 消息所属对话           |
| 1.2.3.1   | id             | number          | True  | 消息id             |
| 1.2.3.2   | first_name     | string          | False | 名字               |
| 1.2.3.3   | username       | string          | False | 用户名              |
| 1.2.3.4   | type           | string          | False | 消息类型             |
| 1.2.4     | date           | number          | False | 发送时间             |
| 1.2.5     | photo          | array\[object\] | False | 图片数组             |
| 1.2.5.1   | file_id        | string          | False | 图片id             |
| 1.2.5.2   | file_unique_id | string          | False | 图片唯一标识           |
| 1.2.5.3   | file_size      | number          | False | 图片大小             |
| 1.2.5.4   | width          | number          | False | 宽                |
| 1.2.5.5   | height         | number          | False | 高                |
| 1.2.6     | text           | string          | False | 文本消息内容           |
| 1.2.7     | voice          | object          | False | 音频json           |
| 1.2.7.1   | duration       | number          | False | 音频时长             |
| 1.2.7.2   | mime_type      | string          | False | 音频的MIME类型        |
| 1.2.7.3   | file_id        | string          | False | 音频id             |
| 1.2.7.4   | file_unique_id | string          | False | 音频唯一标识           |
| 1.2.7.5   | file_size      | number          | False | 音频大小             |
| 1.2.8     | video          | object          | False | 视频json           |
| 1.2.8.1   | duration       | number          | False | 视频时长             |
| 1.2.8.2   | width          | number          | False | 宽                |
| 1.2.8.3   | height         | number          | False | 高                |
| 1.2.8.4   | file_name      | string          | False | 视频名称             |
| 1.2.8.5   | mime_type      | string          | False | 视频的MIME类型        |
| 1.2.8.6   | thumb          | object          | False | 视频缩略图json        |
| 1.2.8.6.1 | file_id        | string          | False | 缩略图id            |
| 1.2.8.6.2 | file_unique_id | string          | False | 缩略图唯一标识          |
| 1.2.8.6.3 | file_size      | number          | False | 缩略图大小            |
| 1.2.8.6.4 | width          | number          | False | 缩略图宽             |
| 1.2.8.6.5 | height         | number          | False | 缩略图高             |
| 1.2.8.7   | file_id        | string          | False | 视频id             |
| 1.2.8.8   | file_unique_id | string          | False | 视频唯一标识           |
| 1.2.8.9   | file_size      | number          | False | 视频大小             |
| 1.2.9     | forward_from   | object          | False | 原始消息json，针对转发的消息 |
| 1.2.9.1   | id             | number          | False | 消息id             |
| 1.2.9.2   | is_bot         | boolean         | False | 是否机器人            |
| 1.2.9.3   | first_name     | string          | False | 名字               |
| 1.2.9.4   | username       | string          | False | 用户名              |
| 1.2.9.5   | language_code  | string          | False | 用户语言标识           |
| 1.2.10    | forward_date   | number          | False | 原始消息发送时间，针对转发的消息 |
   
#### 响应说明
- **响应状态码: 200**

- **响应状态码: 400**
  错误的请求：请检查请求路径及参数。
  
- **响应状态码: 401**
  未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 404**
  请求的内容未找到：请检查请求的路径。
  
- **响应状态码: 500**
  业务失败：请依次确认您请求中各参数的取值。
  
 
#### 错误码
无
#### 报文样例
请求参数：
```
{
    "update_id": 731746899,
    "message": {
        "message_id": 15,
        "from": {
            "id": 5903736207,
            "is_bot": false,
            "first_name": "TianWe",
            "username": "tianwe3263",
            "language_code": "zh-hans"
        },
        "chat": {
            "id": 5903736207,
            "first_name": "TianWe",
            "username": "tianwe3263",
            "type": "private"
        },
        "date": 1671505017,
        "text": "。"
    }
}
```
响应参数：
```
{“resultMsg”：“200”}
```
