AIRUDDER API
  1. webhook
AIRUDDER API
  • API 文档介绍
  • Introductions
  • 快速上手
  • Quick Start
  • 鉴权方法
    • 验证并获取令牌
  • Get the Authorization token
    • Token Authentication and Obtain
  • 全局错误代码
    • 全局错误代码
  • Error Codes
    • Error Codes
  • 催收
    • 快速上手
    • 调用任务相关 API
      • 创建外呼拨打任务
      • 列出已创建的任务
      • 停止一个呼叫任务
      • 取消指定任务中的某个电话的拨打
      • 任务结束状态通知
      • 任务电话维度拨打结束状态通知
      • 获取任务详细信息
      • 获取单个案件通话录音
      • 获取任务录音文件
      • 获取机器人列表
      • 根据callid获取电话信息和录音链接
    • 调用计划相关的API
      • 获取策略列表
      • 创建策略计划拨打任务
      • 获取计划状态信息
      • 获取计划内任务轮次信息
      • 列出已创建的任务
      • 停止一个呼叫任务
      • 取消计划中的某个电话的拨打
      • 计划结束状态通知
      • 任务结束状态通知
      • 任务电话维度拨打结束状态通知
      • 获取任务详细信息
      • 获取单个案件通话录音
      • 获取任务录音文件
      • 获取计划内某个电话所有的通话录音
  • Collection
    • Quick Start
    • APIs Related to Calling Tasks
      • Create a Calling Task
      • List the Task Created
      • Cancel a Calling Task
      • Cancel a Certain Call in a Specific Task
      • Webhook of Task
      • Webhook of Call
      • Obtain the Detailed Information of Tasks
      • Obtain a Call Recording
      • Obtain Call Recordings
      • Fetch robot list
    • APIs Related to Calling Plans
      • Obtain the List of Strategies
      • Create a Dialing Plan with Strategy
      • Obtain the Information of Plan Status
      • Obtain the Information of Each Round of the Plan
      • List the Task Created
      • Cancel a Calling Task
      • Cancel a Certain Call in a Plan
      • Webhook of Plan
      • Webhook of Task
      • Webhook of Call
      • Obtain the Detailed Information of Tasks
      • Obtain a Call Recording
      • Obtain Task Recordings
      • Obtain All Call Recordings of a Number in the Plan
  • 营销&电商
    • 快速上手
    • 调用任务相关的API
      • 创建拨打任务
      • 列出已创建的任务
      • 停止一个呼叫任务
      • 取消某个任务电话拨打
      • 获取任务详细信息
      • 任务结束状态通知
      • 任务电话维度拨打结束状态通知
      • 获取单个案件通话录音
      • 获取任务录音文件
      • 获取机器人列表
      • 根据callid获取电话信息和录音链接
    • 调用计划相关的API
      • 获取策略列表
      • 创建策略计划拨打任务
      • 获取计划状态信息
      • 获取计划内任务轮次信息
      • 列出已创建的任务
      • 取消一个呼叫任务
      • 取消计划中的某个电话的拨打
      • 计划结束状态通知
      • 任务结束状态通知
      • 任务电话维度拨打结束状态通知
      • 获取任务详细信息
      • 获取单个案件通话录音
      • 获取任务录音文件
      • 获取计划内某个电话所有的通话录音
  • Telemarketing & E-commerce
    • Quick Start
    • APIs Related to Calling Tasks
      • Create a Calling Task
      • List the Task Created
      • Cancel a Calling Task
      • Cancel a Certain Call in a Specific Task
      • Webhook of task
      • Webhook of Call
      • Obtain the Detailed Information of Tasks
      • Obtain a Call Recording
      • Obtain Task Recordings
      • Fetch robot list
    • APIs Related to Calling Plans
      • Obtain the List of Strategies
      • Create a Dialing Plan with Strategy
      • Obtain the Information of Plan Status
      • Obtain the Information of Each Round of the Plan
      • List the Task Created
      • Cancel a Calling Task
      • Cancel a Certain Call in a Plan
      • Webhook of Plan
      • Webhook of Task
      • Webhook of Call
      • Obtain the Detailed Information of Tasks
      • Obtain a Call Recording
      • Obtain Call Recordings
      • Obtain All Call Records of a Number in the Plan
  • 信审
    • 快速上手
    • 调用任务相关的API
      • 创建拨打任务
      • 列出已创建的任务
      • 停止一个任务拨打
      • 取消某个任务电话拨打
      • 任务结束状态通知
      • 任务电话维度拨打结束状态通知
      • 获取任务详细信息
      • 获取单个案件通话录音
      • 获取任务录音文件
      • 获取机器人列表
      • 根据callid获取电话信息和录音链接
    • 调用计划相关的API
      • 获取策略列表
      • 创建策略计划拨打任务
      • 获取计划状态信息
      • 获取计划内任务轮次信息
      • 列出已创建的任务
      • 停止一个任务拨打
      • 取消计划中的某个电话的拨打
      • 计划结束状态通知
      • 任务结束状态通知
      • 任务电话维度拨打结束状态通知
      • 获取任务详细信息
      • 获取单个案件通话录音
      • 获取任务录音文件
      • 获取计划内某个电话所有的通话录音
  • Info Check
    • Quick Start
    • APIs Related to Calling Tasks
      • Create a Calling Task
      • List the Task Created
      • Cancel a Calling Task
      • Cancel a Certain Call in a Specific Task
      • Webhook of task
      • Webhook of Call
      • Obtain the Detailed Information of Tasks
      • Obtain a Call Recording
      • Obtain Task Recordings
      • Fetch robot list
    • APIs Related to Calling Plans
      • Obtain the List of Strategies
      • Create a Dialing Plan with Strategy
      • Obtain the Information of Plan Status
      • Obtain the Information of Each Round of the Plan
      • List the Task Created
      • Cancel a Calling Task
      • Cancel a Certain Call in a Plan
      • Webhook of Plan
      • Webhook of Task
      • Webhook of Call
      • Obtain the Detailed Information of Tasks
      • Obtain a Call Recording
      • Obtain Call Recordings
      • Obtain All Call Records of a Number in the Plan
  • Workflow 工作流
    • 预测式外呼信息回调
      • PDS 坐席状态更改回调
      • PDS 联系人状态更改回调
      • PDS 任务状态更改回调
    • 创建一个新的Workflow任务
    • 获取workflow模板列表
    • 为workflow任务新增名单
    • 更新workflow任务内的名单信息
    • 取消workflow任务内某个电话的后续流程
    • Workflow外呼电话拨打结束通知 (催收/营销/电商示例)
    • Workflow外呼电话拨打结束通知 (信审示例)
    • 自定义API 节点数据推送
    • 验证 自定义API 节点数据推送
    • 停止workflow任务
    • 获取workflow任务列表
    • 获取workflow实例的子任务列表信息
    • 获取workflow节点运行的外呼任务
    • 获取workflow外呼任务明细 (催收/营销/电商示例)
    • 获取workflow外呼任务明细(信审示例)
    • 根据callee/caseid和taskid/workflow_id获取电话信息和录音链接
    • 根据callid获取电话信息和录音链接
    • 获取workflow里单个电话的所有录音
    • 通过 case_id/callee 查询 workflow_id
    • workflow 名单结束通知
    • workflow 状态变更通知
    • 获取workflow节点运行的WABA任务
    • 获取workflow内WABA任务明细
    • Workflow内WABA消息状态变更通知
    • Workflow内Chatbot会话结束通知
  • Workflow
    • Webhooks of the Info of Predictive Dialer System
      • Webhook of Predictive Dialer Task Status Changes
      • Webhook of Predictive Dialer Contacts Status Changes
      • Webhook of Predictive Dialer Agents Status Changes
    • Create a New WorkFlow Task
    • Obtain the List of Workflow Templates
    • Add lists to an workflow task
    • Update the List Info of Workflow Task
    • Cancel the processes for a specific list
    • Notification of Call Completion in Workflow (Debt Collection/Marketing/E-commerce)
    • Notification of Call Completion in Workflow(Info Check)
    • Custom API Node Data Push
    • Verify the Custom API Node Data Push
    • Stop the Workflow Task
    • Obtain the Workflow Task List
    • Obtain the Subtask List of the Workflow
    • Obtain the Outbound Task List of Workflow
    • Obtain the Outbound Task Details of Workflow(Collection/Telemarketing/E-commerce)
    • Obtain the Outbound Task Details of Workflow(Info Check)
    • Obtain Call Information and Recording Links by callee/caseid and taskid/workflow_id
    • Obtian Call Information and Recording Link by Call ID
    • Obtain All the Recordings of a Single Number in the Workflow
    • Query workflow_id using case_id/callee
    • Notification for Workflow List Completion
    • Notification of Workflow Status Change
    • Obtain the WABA Tasks List of Workflow
    • Obtain the WABA Task Details of Workflow
    • Notification of WABA Message Status Alteration in Workflow
    • Chatbot Session End Notification in Workflow
  • 加解密对接
    • API接口使用AES加解密对接
    • API接口使用AES加解密对接-示例
  • WorkFlow_LeadsGeneration
    • Webhooks of the Info of Predictive Dialer System
      • Webhook of Predictive Dialer Task Status Changes
      • Webhook of Predictive Dialer Agents Status Changes
      • Webhook of Predictive Dialer Contacts Status Changes
    • Create a New WorkFlow Task
    • Obtain the List of Workflow Templates
    • Add Workflow Contacts
    • Update the List Info of Workflow
    • Cancel a Call
    • End Status Notification from the Dimension of Phone Call
    • Stop the Workflow Task
    • Custom API Data Push
    • Verify the Custom API Data Push
    • Obtain the Task List of Workflow
    • Obtain the Subtask List of the Workflow
    • Obtain All the Recordings of a Single Number in the Workflow
  • Flex_Route
    • LendSwift-Outbound-Push-Data-to-AI-Rudder
    • SDR-Webpage-Push-Data-to-Workflow
    • Talmarket Debt-Consolidation Push Data to Make Outboud Call
    • Use AI Rudder Make Outbound Call
  • API_Store
    • Push-Data-to-Boberdoo-After-EnablementData-Inbound-Call
    • AI Rudder Ping Doucet Before Transfer
  • 回调数据加解密对接
  • DIDI营销定制
    • 获取机器人列表
    • 获取机器人详情
    • 创建外呼拨打任务
  • Chatbot
    • 接入准备
    • 错误码
    • HSB关于custom字段使用说明
    • 华为
      • api
        • 用户发送消息
        • 转人工结果
      • webhook
        • 回调机器人回复消息
          POST
        • 回调转人工申请
          POST
        • 结束会话
          POST
    • bot
      • 用户发送消息
      • 回调机器人回复消息
      • 回调转人工申请
      • 回调结束会话
    • 查询可用WABA账号
      POST
    • 查询模版列表
      POST
    • 查询模版详情
      POST
    • 发送模版消息
      POST
    • 查询模版消息发送结果
      POST
    • 回调模版消息发送结果
      POST
    • 发送单个模版消息接口
      POST
    • 回调单个模版消息用户响应
      POST
    • 回调转人工申请
      POST
    • 回调坐席消息发送之后的状态变更
      POST
    • 回调转人工后用户发送的消息
      POST
    • 回调会话结束事件
      POST
    • 转人工结果
      POST
    • 查询会话列表
      POST
    • 查询消息列表
      POST
    • 将用户消息标记为已读
      POST
    • 发送普通消息
      POST
    • 结束会话
      POST
    • 上传文件
      POST
    • 上传文件(谷歌地图缩略图)
      POST
    • 会话结束后上报
      POST
    • 查询公司所有渠道信息
      POST
    • 用户发送的消息事件上报
      POST
    • 渠道发送的消息事件上报
      POST
    • 渠道发送的消息状态变更事件上报
      POST
    • 获取公司信息
      POST
    • 查询运单号物流轨迹
      POST
  • Chatbot English
    • Quick Start
    • Error Code
    • bot
      • User send message
      • Callback bot reply message
      • Callback transfer to agent request
      • Callback for ended session
    • Query available WABA accounts
    • Query the template list
    • Template details
    • Send template message
    • Query the template message sending result
    • Callback template message sending result
    • Send single template message
    • Callback single template message user response
    • Callback agent transfer request
    • Callback status change after the message is sent
    • Callback message sent by user
    • *Callback agent transfer request
    • *Callback for status change after the agent message is sent
    • *Callback for messages sent by the user after transferring to agent
    • Callback for session end event
    • Agent transfer result
    • Query conversation list
    • Query message list
    • *Query message list
    • Mark user message as read
    • Send regular message
    • End session
    • Upload file
    • Upload file (Google maps thumbnail)
    • Report after session ends
  • Inbound Callback
    • inbound业务对接介绍
    • Inbound Business Integration Guide
    • 转人工成功后通知
    • Notification after Successful Transfer to an Agent
    • 电话结束后通知
    • Notification after the Call Ends
  1. webhook

回调机器人回复消息

开发中
POST
https://api.airudder.com
回调机器人回复用户的消息,http 响应码为200则表示成功

请求参数

Header 参数
X-AIRudder-Sign
string 
签名值
必需
Body 参数application/json
event
enum<string> 
事件名称
必需
枚举值:
message.send
call_id
string 
会话唯一标识
必需
channel
string 
会话所属渠道
必需
channel_id
string 
渠道id
必需
user
object 
用户信息
必需
id
string 
用户唯一标识
必需
name
string 
用户名称
可选
messages
array [object {4}] 
必需
消息信息,每次只支持1条消息
>= 1 items<= 1 items
msg_id
string 
消息id
必需
sender_type
enum<string> 
发送人
必需
枚举值:
robot
timestamp
integer 
发送时间戳
必需
content
object 
消息内容
必需
示例
{
    "event": "message.send",
    "call_id": "6cf8c876eeefdca168ae7a08cb93fe20",
    "channel": "HuaWei",
    "channel_id": "hwbcauat",
    "user": {
        "id": "123",
        "name": "nick"
    },
    "messages": [
        {
            // text 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "text",
                "text": "hi"
            }
        },
        {
            // image 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "image",
                "media": {
                    "origin_url": "https://www.airudder.com/xxxx.jpg"
                }
            }
        },
        {
            // video 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "video",
                "media": {
                    "origin_url": "https://www.airudder.com/xxxx.mp4"
                }
            }
        },
        {
            // audio 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "audio",
                "media": {
                    "origin_url": "https://www.airudder.com/xxx.wav"
                }
            }
        },
        {
            // file 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "file",
                "media": {
                    "origin_url": "https://www.airudder.com/xxxx.pdf",
                    "name": "filename"
                }
            }
        },
        {
            // interactive list 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "interactive",
                "interactive": {
                    "type": "list",
                    "body": {
                        "text": "请选择你要咨询的业务类(本次通过list展示)"
                    },
                    "action": {
                        "button": "请选择",// 若list做成弹出式,则字段为按钮文案,否则可不用
                        "sections": [
                            {
                                "title": "查询类",// list 选项一级选项
                                // list 选项二级选项
                                "rows": [
                                    {
                                        "id": "59a3d8ba24ec0d29334775623182facf-3-1-list-0-0-",// 选项的唯一标识
                                        "title": "物流查询"// 选项文案
                                    },
                                    {
                                        "id": "59a3d8ba24ec0d29334775623182facf-3-1-list-0-1-",
                                        "title": "网点查询"
                                    }
                                ]
                            },
                            {
                                "title": "寄件类",
                                "rows": [
                                    {
                                        "id": "59a3d8ba24ec0d29334775623182facf-3-1-list-1-0-",
                                        "title": "大件快递"
                                    },
                                    {
                                        "id": "59a3d8ba24ec0d29334775623182facf-3-1-list-1-1-",
                                        "title": "小件快递"
                                    }
                                ]
                            }
                        ]
                    }
                }
            }
        },
        {
            // interactive button 消息示例
            "msg_id": "9f856b06d44a48e39723ee9c4403cd5a",
            "sender_type": "robot",
            "timestamp": 1722223026,
            "content": {
                "type": "interactive",
                "interactive": {
                    "type": "button",
                    "body": {
                        "text": "请选择您的性别(button)👉👉👉"
                    },
                    "action": {
                        // 按钮集合
                        "buttons": [
                            {
                                "type": "reply",// 每个按钮固定为 reply 类型
                                "reply": {
                                    "id": "59a3d8ba24ec0d29334775623182facf-2-1-button-0-",// 按钮的唯一标识
                                    "title": "男"// 按钮文案
                                }
                            },
                            {
                                "type": "reply",
                                "reply": {
                                    "id": "59a3d8ba24ec0d29334775623182facf-2-1-button-1-",
                                    "title": "女"
                                }
                            },
                            {
                                "type": "reply",
                                "reply": {
                                    "id": "59a3d8ba24ec0d29334775623182facf-2-1-button-2-",
                                    "title": "其他"
                                }
                            }
                        ]
                    }
                }
            }
        }
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.airudder.com' \
--header 'X-AIRudder-Sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "event": "message.send",
    "call_id": "6cf8c876eeefdca168ae7a08cb93fe20",
    "channel": "HuaWei",
    "channel_id": "hwbcauat",
    "user": {
        "id": "123",
        "name": "nick"
    },
    "messages": [
        {
            // text 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "text",
                "text": "hi"
            }
        },
        {
            // image 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "image",
                "media": {
                    "origin_url": "https://www.airudder.com/xxxx.jpg"
                }
            }
        },
        {
            // video 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "video",
                "media": {
                    "origin_url": "https://www.airudder.com/xxxx.mp4"
                }
            }
        },
        {
            // audio 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "audio",
                "media": {
                    "origin_url": "https://www.airudder.com/xxx.wav"
                }
            }
        },
        {
            // file 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "file",
                "media": {
                    "origin_url": "https://www.airudder.com/xxxx.pdf",
                    "name": "filename"
                }
            }
        },
        {
            // interactive list 消息示例
            "msg_id": "c98a99f32afab85d709ba23820fccccb",
            "sender_type": "robot",
            "timestamp": 1722223064,
            "content": {
                "type": "interactive",
                "interactive": {
                    "type": "list",
                    "body": {
                        "text": "请选择你要咨询的业务类(本次通过list展示)"
                    },
                    "action": {
                        "button": "请选择",// 若list做成弹出式,则字段为按钮文案,否则可不用
                        "sections": [
                            {
                                "title": "查询类",// list 选项一级选项
                                // list 选项二级选项
                                "rows": [
                                    {
                                        "id": "59a3d8ba24ec0d29334775623182facf-3-1-list-0-0-",// 选项的唯一标识
                                        "title": "物流查询"// 选项文案
                                    },
                                    {
                                        "id": "59a3d8ba24ec0d29334775623182facf-3-1-list-0-1-",
                                        "title": "网点查询"
                                    }
                                ]
                            },
                            {
                                "title": "寄件类",
                                "rows": [
                                    {
                                        "id": "59a3d8ba24ec0d29334775623182facf-3-1-list-1-0-",
                                        "title": "大件快递"
                                    },
                                    {
                                        "id": "59a3d8ba24ec0d29334775623182facf-3-1-list-1-1-",
                                        "title": "小件快递"
                                    }
                                ]
                            }
                        ]
                    }
                }
            }
        },
        {
            // interactive button 消息示例
            "msg_id": "9f856b06d44a48e39723ee9c4403cd5a",
            "sender_type": "robot",
            "timestamp": 1722223026,
            "content": {
                "type": "interactive",
                "interactive": {
                    "type": "button",
                    "body": {
                        "text": "请选择您的性别(button)👉👉👉"
                    },
                    "action": {
                        // 按钮集合
                        "buttons": [
                            {
                                "type": "reply",// 每个按钮固定为 reply 类型
                                "reply": {
                                    "id": "59a3d8ba24ec0d29334775623182facf-2-1-button-0-",// 按钮的唯一标识
                                    "title": "男"// 按钮文案
                                }
                            },
                            {
                                "type": "reply",
                                "reply": {
                                    "id": "59a3d8ba24ec0d29334775623182facf-2-1-button-1-",
                                    "title": "女"
                                }
                            },
                            {
                                "type": "reply",
                                "reply": {
                                    "id": "59a3d8ba24ec0d29334775623182facf-2-1-button-2-",
                                    "title": "其他"
                                }
                            }
                        ]
                    }
                }
            }
        }
    ]
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
上一页
转人工结果
下一页
回调转人工申请
Built with