跳转至

模板路由

功能概述

根据设置的路由条件,将符合条件的消息发送到设置的应用服务器地址,不直接发送给目标用户,根据应用服务器返回的响应结果决定是否下发。适用于对接自己或其他第三方内容审核服务的应用场景。需要在开发者后台开通此功能。

  1. 支持将单聊、群组、聊天室的消息数据先发送到开发者应用服务器进行检查,再由开发者决定此条消息是否继续下发。

  2. 调用 Server API 接口发送的消息,默认不会发送到应用服务器。

  3. 融云服务器只会请求 1 次,超时时间为 3 秒,如果请求失败或者超时,服务器默认将下发此条消息。

  4. 消息为图片、视频类消息时,开发者如果需要获取图片、视频等文件信息,可通过消息中携带的地址进行下载,融云文件存储有效期为 6 个月。

  5. 模板路由与消息路由功能可以同时使用,模板路由中被拒绝下发的消息,不执行消息路由同步操作。

示例说明

HTTP 方法:POST

表单参数

名称 类型 说明
appKey String 应用 App Key。
fromUserId String 发送用户 Id。
targetId String 目标会话 Id,根据会话类型可能为单聊 Id、群聊 Id、聊天室 Id。
msgType String 消息类型,文本消息 RC:TxtMsg 、 图片消息 RC:ImgMsg 其他消息类型请参见消息类型说明文档
content String 发送消息内容,参考融云消息类型表.示例说明
channelType String 会话类型,二人会话是 PERSON 、讨论组会话是 PERSONS 、群组会话是 GROUP 、聊天室会话是 TEMPGROUP
msgTimeStamp String 服务端收到客户端发送消息时的服务器时间(1970年到现在的毫秒数)。
messageId String 消息唯一标识。

提示

消息发送到应用服务器后,应用服务器需要返回 HTTP 应答码 200,同时返回 pass 属性,根据 pass 状态决定是否进行下发。

返回值

名称 类型 说明
pass Int 1 表示正常下发此条消息,0 表示拒绝不下发此条消息。

示例

signature (数据签名)计算方法:将系统分配的 App Secret、Nonce (随机数)、timestamp (时间戳)三个字符串按先后顺序拼接成一个字符串并进行 SHA1 哈希计算。

假设开发者注册的接收地址:http://example.com/receive_message.php

Request:

POST /receive_message.php?timestamp=1408710653491&nonce=14314&signature=45beb7cc7307889a8e711219a47b7cf6a5b000e8 HTTP/1.1
Host: example.com
Content-Type: application/x-www-form-urlencoded

appKey=123&content={"content":"123"}&fromUserId=fid123&targetId=tid123&msgType=RC:TxtMsg&messageId=596E-P5PG-4FS2-7OJK&msgTimeStamp=1408710653491&channelType=PERSON

Response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"pass":1}