接受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": "。"
    }
}

响应参数：