salesmartly_robot
    salesmartly_robot
    • 自定义机器人消息接受文档
    • 自定义机器人回复接口
      POST

    自定义机器人消息接受文档

    URL#

    用户 自定义机器人 配置页面自定义填写

    Content-Type:#

    application/json

    HTTP 请求方式#

    post

    请求 Body#

    参数类型说明
    project_idint项目ID
    chat_user_idstring用户ID
    messagestring消息内容(如文本消息直接返回,其他消息则以url格式返回)
    message_typeint消息类型(0-未定义消息 1-文本 2-图片 4-文件 6-视频 12-音频 20-艾特消息 22-贴纸 23-位置 29-联系人名片 35-无法解密消息)
    robot_idint机器人ID
    robot_namestring机器人名称
    channelint渠道类型
    channel_idint渠道账号ID
    modulestring推送场景(online-正常用户 preview-机器人预览)
    midstring该条消息的官方消息ID
    sequence_idstring该条消息的SaleSmartly消息ID

    请求示例#

    文件消息
    {
        "project_id": 1,
        "chat_user_id": "aa123456",
        "message": "https://assets-cdn.salesmartly.com/%A3.md",
        "message_type": "4",
        "robot_id": 1,
        "robot_name": "自定义机器人",
        "channel": 1,
        "channel_id": 1,
        "module": "online",
        "mid":"ABC123",
        "sequence_id":"1720000000000"
    }
    

    返回请求 Body#

    参数是否必传类型说明
    project_id是int项目ID
    chat_user_id是string用户ID
    message是string消息内容(如文本消息直接返回,WhatsappApp自定义链接卡片消息返回详细的链接和文本,其他消息则以url格式返回)
    message_type是int消息类型(1-文本 2-图片 4-文件 6-视频 12-音频 40-图文消息 47-WhatsappApp自定义链接卡片消息)
    robot_id是int机器人ID
    robot_name是string机器人名称
    channel是int渠道类型
    channel_id是int渠道账号ID
    module是string推送场景(online-正常用户 preview-机器人预览)
    duration否int音频类型必传(秒)
    caption_type否string图文消息类型必传(图的类型('image', 'video', 'document'))
    description否string图文消息和WhatsappApp自定义链接卡片消息类型必传,描述
    image_url否stringWhatsappApp自定义链接卡片消息类型必传,卡片展示的图片
    match_text否stringWhatsappApp自定义链接卡片消息类型必传,message参数中的链接,必须携带http或https
    title否stringWhatsappApp自定义链接卡片消息类型必传,卡片展示的标题

    返回请求示例#

    文本消息
    {
        "project_id": 1,
        "chat_user_id": "aa123456",
        "message": "test",
        "message_type": "1",
        "robot_id": 1,
        "robot_name": "自定义机器人",
        "channel": 1,
        "channel_id": 1,
        "module": "online"
    }
    
    图片消息
    {
        "project_id": 1,
        "chat_user_id": "aa123456",
        "message": "https://test.jpg",
        "message_type": "2",
        "robot_id": 1,
        "robot_name": "自定义机器人",
        "channel": 1,
        "channel_id": 1,
        "module": "online"
    }
    
    文件消息
    {
        "project_id": 1,
        "chat_user_id": "aa123456",
        "message": "https://test.jpg",
        "message_type": "4",
        "robot_id": 1,
        "robot_name": "自定义机器人",
        "channel": 1,
        "channel_id": 1,
        "module": "online"
    }
    
    视频消息
    {
        "project_id": 1,
        "chat_user_id": "aa123456",
        "message": "https://test.mp4",
        "message_type": "6",
        "robot_id": 1,
        "robot_name": "自定义机器人",
        "channel": 1,
        "channel_id": 1,
        "module": "online"
    }
    
    音频消息
    {
        "project_id": 1,
        "chat_user_id": "aa123456",
        "message": "https://test.mp3",
        "message_type": "12",
        "robot_id": 1,
        "robot_name": "自定义机器人",
        "channel": 1,
        "channel_id": 1,
        "module": "online",
        "duration": 10
    }
    
    图文消息(以普通图片为例)
    {
        "project_id": 1,
        "chat_user_id": "aa123456",
        "message": "https://test.jpg",
        "message_type": "40",
        "robot_id": 1,
        "robot_name": "自定义机器人",
        "channel": 1,
        "channel_id": 1,
        "module": "online",
        "caption_type": "image",
        "description": "这是一张图片"
    }
    
    WhatsappApp自定义链接卡片消息
    {
        "project_id": 1,
        "chat_user_id": "aa123456",
        "message": "这个是我们的链接https://www.salesmartly.com",
        "message_type": "47",
        "robot_id": 1,
        "robot_name": "自定义机器人",
        "channel": 1,
        "channel_id": 1,
        "module": "online",
        "description": "SaleSmartly专注于智能客服",
        "image_url": "https://salesmartly.jpg",
        "match_text": "https://www.salesmartly.com",
        "title": "SaleSmartly智能客服官网"
    }
    
    修改于 2025-09-05 09:17:20
    下一页
    自定义机器人回复接口
    Built with