API推出

创建一个推出活动

创建一个推出活动,发送一个POST请求:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/viber

请求参数:

参数	类型	描述
task_name	字符串	活动名称					要求
message_type *	int	消息类型:`2`——促销,`3`——系统					要求
sender_id	int	主动发送者名字ID,您发送活动;你可以得到`sender_id`在“发送者的名单”的方法,使用它你必须注册发送者的名字服务设置					要求
message_live_time	int	信息生命周期(秒),最小60年代,最大86400秒(24小时)					要求
send_date	字符串	发送时间。使用`现在`如果你需要立即发送消息,或者指定的时间格式`YYYY-MM-DD HH: MM: SS`如果你需要安排未来					要求
address_book *	int	邮件列表ID					要求
收件人*	数组	电话号码列表`(18093开云体育备用网址1111111,180931111111,180931111111)`格式					要求
信息*	字符串	消息文本(最大长度是1000个字符)					要求
stretch_time	int	渐进的消息发送。你可以设置值从0到5个小时,和你的活动将被发送到所有接受者在较小的部件在指定的时间框架内。					可选
额外的	对象	其他参数:					可选
		按钮*	按钮的参数:
			文本	字符串	按钮文字	可选
			链接	字符串	按钮链接	可选
		图像*	图像参数:
		图像*	链接	字符串	链接到你的上传图像	可选
		resend_sms	转发形成消息通过短信服务功能:
			状态	布尔	`真正的`如果启用,`假`如果禁用	可选
			sms_text	字符串	SMS消息文本	可选
			sms_sender_name	字符串	短信发送方ID	可选

您可以使用address_book,或收件人参数指定的收件人列表,其中一个参数是必需的。

你可以发送以下类型的信息:

系统或优惠(文本):消息参数;
优惠(文本+按钮+图片):消息,按钮,图像参数;
优惠(文本+按钮):消息,按钮参数;
推广(图片):图像参数。

请注意:当你发送系统消息(“message_type”: 3)中的文本消息参数检查。它必须匹配的文本通过模板。你可以添加和提交批准的模板在你的个人账户注册一个发送方。

请求示例发送消息的文本+按钮+图像格式:

{“接受者”:[/ /接受者数组380931111111,380931111112,开云体育备用网址380931111113),“address_book”: null, / /主要有两种选择:要么把地址簿ID,或者一组接收者最大(1000人)“消息”:“玛格丽特,你已经批准了50%的折扣在所有项目化妆品类别”,“message_type”: 2,“message_live_time”: 1000年,/ /秒(60秒最小,最大86400秒(24小时),“sender_id”: 1, / /活跃用户的id,活动将从“send_date”:“现在”,按以下格式/ /或日期YYYY-MM-DD HH: ii: ss“额外”:{"按钮":{“文本”:“买化妆品”,“链接”:“//www.alanlshields.com/”},“图像”:{“链接”:“//www.alanlshields.com/images/image.png”},“resend_sms”:{“状态”:真的,“sms_text”:“sms消息的文本”,“sms_sender_name”:“sendpulse”}}}开云体育手机网页版登录入口官网

请求示例发送消息只包含文本:

{“接受者”:[/ /数组的接受者380931111111,380931111112,380开云体育备用网址931111113),“address_book”: null, / /有两个选择:要么把地址簿ID,或者发送收件人数组,1000人最大的“消息”:“玛格丽特,你已经批准了50%的折扣在所有项目在“化妆品“类别”,
/ /最大容积长度是1000符号“message_type”: 2,“message_live_time”: 1000年,/ /秒(最小60秒,最大86400秒(24小时),“sender_id”: 1, / / id积极发送者的名字“send_date”:“现在”,按以下格式/ /或日期YYYY-MM-DD HH: ii: ss“额外”:{" resend_sms ": {
/ /状态表明转发形成了“状态”:真的,/ / sms文本“sms_text”:“sms消息的文本”,/ /发送者名字短信“sms_sender_name”:“sendpulse”}}}开云体育手机网页版登录入口官网

请求示例发送消息只包含一个图像:

{“接受者”:[/ /数组的接受者380931111111,380931111112,380开云体育备用网址931111113),“address_book”: null, / /有两个选择:要么把地址簿ID,或者发送收件人数组,1000人最大的“消息”:空,“message_type”: 2,“message_live_time”: 1000年,/ /秒(最小60年代,最大86400年代(24小时)“sender_id”: 1、/ / ID积极发送者的名字“send_date”:“现在”,按以下格式/ /或日期YYYY-MM-DD HH: ii: ss“额外”:{/ /额外的数据“图像”:{/ /图像在消息“链接”:“//www.alanlshields.com/images/image.png”/ /图片链接},“resend_sms”:{/ /状态指示重新发送选项打开“状态”:真的,/ / sms文本“s开云体育手机网页版登录入口官网ms_text”:“sms文本”,/ /短信发送者的名字“sms_sender_name”:“sendpulse”}}}

请求示例包含文本+按钮发送消息:

{“接受者”:[/ /数组的接受者380931111111,380931111112,38开云体育备用网址0931111113),“address_book”: null, / /发送地址本ID,或者发送接收数组,“消息”:“玛格丽特,你已经批准了50%的折扣在所有项目”“化妆品”“类别”,/ / max容积长度是1000符号
“message_type”: 2,“message_live_time”: 1000年,/ /秒(最小60秒,最大86400自(24小时),“sender_id”: 1、“send_date”:“现在”,“额外”:{“按钮”:{“文本”:“买化妆品”,“链接”:“//www.alanlshields.com”},“resend_sms”:{“状态”:真的,“sms_text”:“文本短信”,“sms_se开云体育手机网页版登录入口官网nder_name”:“sendpulse”}}}

请求示例逐步发送:

{“接受者”:[380683850429],“消息”:“测试”、“message_type”: 2,“message_live_time”: 1000年,“sender_id”: 4647年,“send_date”:“现在”,“stretch_time”: 1}

如果请求成功,你将收到一个回复:

{“结果”:真的,“数据”:{“address_book_id”:空,“button_link”:空,“button_text”:空,“image_link”:空,“消息”:“玛格丽特,你已经批准了50%的折扣在所有项目在“化妆品“类别”、“message_live_time”:“1000”,“message_type”: 3,“resend_sms”: 0,“send_date”:“2019-03-26 12:40:05”、“sender_id”: 4501年,“sms_sender_name”:空,“sms_text”:空,“task_id”: 90241年,“task_name”:“推出个人竞选名单2019-03-26 40分“}}

编辑一个推出活动

编辑一个推出活动,发送一个POST请求:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/viber/update

请求参数:

参数	类型	描述
main_task_id	int	活动ID	要求
task_name	字符串	活动名称	可选
消息	字符串	消息文本	可选
message_type	int	消息类型:`2`——开云体育重庆时时彩市场营销、`3`——事务	要求
button_text	字符串	文本的按钮;如果不指定,`零`响应将遵循	可选
button_link	字符串	转让链接;如果不指定,`零`响应将遵循	可选
image_link	字符串	形象定位;如果不指定,`零`响应将遵循	可选
address_book	int	邮件列表;如果不指定,`零`响应将遵循	可选
sender_id	int	发件人ID(在发送的时候);你可以在“发送者的名单”方法; 确保用户注册发件人id服务设置	要求
message_live_time	int	信息生命周期(秒)	可选
send_date	字符串	发送日期	可选

如果请求成功,你将收到一个回复:

{“结果”:真的,“数据”:{“address_book_id”:空,“button_link”:空,“button_text”:空,“image_link”:空,“消息”:“玛格丽特,你已经批准了50%的折扣在所有项目在“化妆品“类别”、“message_live_time”:“1000”,“message_type”:“3”,“send_date”:“2019-03-26 15:16:00”、“sender_id”:“4495”,“task_id”: 9380939,“task_name”:“推出个人竞选名单2019-03-26 15:15”}}

取消推出活动

取消预定推出活动,发送一个PUT请求到:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/v2/viber-service/tasks/cancel

请求参数:

参数	类型	描述
task_id	int	活动ID	要求

如果请求成功,你将收到一个回复:

{"数据":{“结果”:真}}

得到活动的列表

活动列表,发送一个get请求:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/viber/task

请求参数:

参数	类型	描述
限制	int	数量的记录	可选
抵消	int	抵消(第一个记录显示)	可选

如果请求成功,你将收到一个回复:

[{" id ": 9380939,“名字”:“推出个人竞选名单上2019-03-26 15:02”、“消息”:“简,你已经批准了50%的折扣在所有项目在“化妆品“类别”、“button_text”:空,“button_link”:空,“image_link”:空,“address_book”:空,“sender_name”:“YAMAMAY”、“sender_id”: 4495年,“message_live_time”: 1000年,“send_date”:“2019-03-29 10:00:00”,“状态”:“适度”,“创建”:“2019-03-26 12:50:02 "},{" id ": 9380926,“名字”:“推出个人竞选名单2019-03-26 48”、“消息”:“玛格丽特,你已经批准了50%的折扣在所有项目在“化妆品“类别”、“button_text”:空,“button_link”:空,“image_link”:空,“address_book”: 0,“sender_name”:“YAMAMAY”、“sender_id”: 4495年,“message_live_time”: 1000年,“send_date”:“2019-03-29 10:00:00”,“状态”:空,“创建”:“2019-03-26”12:48:23}]

反应参数:

参数	类型	描述
id	int	活动ID
的名字	字符串	活动名称
消息	字符串	消息文本
button_text	字符串	文本的按钮,如果不指定,将返回`零`
button_link	字符串	点击链接,如果未指定,将返回`零`
image_link	字符串	图片链接,如果未指定,将返回`零`
address_book_id	int	邮件列表ID,如果手动键入,将返回`零`
sender_name	字符串	发送者的名字,这是用来发送
sender_id	int	发件人ID
message_live_time	int	一生的消息(以秒为单位)
send_date	字符串	日期被送
状态	字符串	任务的状态
创建	字符串	日期创建活动

统计活动

活动的统计数据,发送一个get请求:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/viber/task/ {id}

请求参数:

参数	类型	描述
id	int	活动ID	要求

如果请求成功,你将收到一个回复:

{" id ": 38岁的“名称”:“Viber_Campaign_38”、“消息”:“推出消息文本”、“button_text”:“按钮”,“button_link”:“//www.alanlshields.com”,“image_link”:空开云体育手机网页版登录入口官网,“address_book”:空,“sender_name”:“infoservice”、“send_date”:“2017-06-22 09:51:35”,“状态”:“发送”,“统计”:{“发送”:1、“交付”:1、“读”:0,“重定向”:0,改用:0,“错误”:0},“创建”:“2017-06-22 09:51:22”}

反应参数:

参数	类型	描述
id	int	活动ID
的名字	字符串	活动名称
消息	字符串	消息文本
button_text	字符串	文本的按钮,如果不指定,将返回`零`
button_link	字符串	点击链接,如果未指定,将返回`零`
image_link	字符串	图片链接,如果未指定,将返回`零`
address_book_id	int	邮件列表ID,如果手动键入,将返回`零`
sender_name	字符串	发送者的名字,这是用来发送
sender_id	int	发件人ID
message_live_time	int	一生的消息(以秒为单位)
send_date	字符串	日期被送
状态	字符串	任务状态
统计数据	对象	活动数据:
		发送	int	发送消息的数量
		交付	int	数量的交付信息
		读	int	读取消息数量
		重定向	int	按钮点击率
		未交付的	int	未交付的消息数量
		错误	int	错误的数量
创建	字符串	创建活动的日期

发送者的名单

发送者的名单,发送一个get请求:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/viber/senders

如果请求成功,你将收到一个回复:

[{" id ": 1、“状态”:“验证”,“名字”:“名字”,“service_type”:“测试服务”、“web_site”:“//www.alanlshields.com”、“描述”:“我们正在测试的最后变体开云体育手机网页版登录入口官网信息”,“国家”:“英国”、“traffic_type”:“公共信息”,“admin_comment”:“你的名字已经被批准,非常感谢您选择我们的服务。开云体育手机网页版登录入口官网Sendpulse团队”}]

反应参数:

参数	类型	描述
id	int	发件人ID
状态	字符串	发送方现状
的名字	字符串	发送者的名字
service_type	字符串	类型的服务
web_site	字符串	网站
描述	字符串	服务的描述
国家	字符串	收件人的国家
traffic_type	字符串	类型的流量
admin_comment	字符串	评论的管理,如果评论存在,文本将被归还,否则,API将返回`零`

得到一个发送者的名字

发送者的名字,发送一个get请求:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/viber/senders/ {id}

请求参数:

参数	类型	描述
id	int	发件人ID	要求

如果请求成功,你将收到一个回复:

{" id ": 1、“状态”:“验证”、“名称”:“infoservice”、“service_type”:“测试服务”、“web_site”:“//www.alanlshields.com”、“描述”:“我们正在测试开云体育手机网页版登录入口官网的最后变体信息”,
“国家”:“英国”、“traffic_type”:“公共信息”,
“admin_comment”:“你的名字已经被批准,非常感谢您选择我们的服务。开云体育手机网页版登录入口官网Sendpulse团队”
}

反应参数:

参数	类型	描述
id	int	发件人ID
状态	字符串	发送方现状
的名字	字符串	发送者的名字
service_type	字符串	类型的服务
web_site	字符串	网站
描述	字符串	服务的描述
国家	字符串	收件人的国家
traffic_type	字符串	类型的流量
admin_comment	字符串	评论的管理,如果评论存在,文本将被归还,否则,API将返回`零`

得到一个推出竞选收件人列表

推出竞选收件人列表,发送一个get请求:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/viber/task/ {id} /接受者

请求参数:

参数	类型	描述
id	int	活动ID	要求

如果请求成功,你将收到一个回复:

{“task_id”: 44岁的“收件人”:[{“电话”:380934760182,“address_book_id”: 850852年,“状态”:“发送”、“send_date”:“2017-06-23 08:54:01”、“价格”:0.74,“货币”:“却是前文所提到的”,“last_update”:“2017-06-23”08:53:38}]}

反应参数:

参数	类型	描述
task_id	int	活动ID
收件人	数组	收件人列表:
		电话	int	收件人的电话号码
		address_book_id	int	邮件列表包含电话号码的ID,人工输入的API将返回`零`
		状态	字符串	状态消息发送到这个数字的(发送;交付;交付和打开;交付和阅读;交付;阅读并点击完成后;不交付;错误)
		send_date	字符串	发送时间
		价格	浮动	价格的消息
		货币	字符串	实际用户的货币和价格信息显示在这个货币
		last_update	字符串	最后统计数据更新

得到一个黑名单的联系人列表

在黑名单的联系人列表发送一个GET请求:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/v2/viber-service/phone-exception

请求参数:

参数	类型	描述
限制	int	数量的记录	可选
抵消	int	抵消(第一个记录显示)	可选

如果请求成功,你将收到一个回复:

{“数据”:{“列表”:[{" id ": 164年,“user_id”: 7046460,电话:73832370050,“描述”:“”,“add_date”:“2021-11-05 13:34:03 "}, {" id ": 165年,“user_id”: 7046460,电话:73912050915,“描述”:“”,“add_date”:“2021-11-05”13:34:03}],“总”:29}}

电话号码添加到黑名单

添加一个电话号码到黑名单,发送一个POST请求:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/v2 / viber-service / phone-exception

请求参数:

参数	类型	描述
手机	数组	例如,列表的电话号码(“380977217975”、“380977217977”、“380977217978”)	要求
描述	字符串	描述一个数字添加到黑名单的原因	可选

如果请求成功,你将收到一个回复:

{“结果”:真的,“计数器”:{“添加”:7,“存在”:0}}

从黑名单中删除一个电话号码

从黑名单中删除一个电话号码,发送一个DELETE请求到:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/v2 / viber-service / phone-exception

请求参数:

参数	类型	描述
手机	数组	例如,列表的电话号码(“380977217975”、“380977217977”、“380977217978”)	要求

如果请求成功,你将收到一个回复:

{“结果”:真的,“删除”:7}