Bland.Ai
  1. 通话
Bland.Ai
  • 入门指南
  • 基本
    • 发送呼叫(简单)
      POST
    • 使用 Pathways 发送呼叫(简单)
      POST
  • 通话
    • 发送呼叫
      POST
    • 使用 AI 分析通话
      POST
    • 停止当前通话
      POST
    • 列出通话
      GET
    • 通话详情
      GET
    • 声音录制
      GET
    • 获取更正的成绩单
      GET
  • 网络代理
    • 创建网络代理
      POST
    • 更新网络代理设置
      POST
    • 授权网络代理呼叫
      POST
    • 删除网络代理
      POST
    • 列出网络代理
      GET
  • 对话途径
    • 获取单一途径信息
      GET
    • 创建途径
      POST
    • 更新途径
      POST
    • 删除途径
      DELETE
  • 呼入号码
    • 购买呼入号码
      POST
    • 更新入站详细信息
      POST
    • 列出呼入号码
      GET
    • 呼入号码详情
      GET
  • 呼出号码
    • 购买呼出号码
      POST
    • 列出呼出号码
      GET
  • 声音
    • 列出声音
    • 语音详情
    • 生成音频样本
  • 定制工具
    • 创建自定义工具
    • 更新自定义工具
    • 列出自定义工具
    • 自定义工具详细信息
  • 自定义 Twilio 帐户
    • 创建加密密钥
    • 删除加密密钥
    • 上传呼入电话号码
    • 删除呼入电话号码
  • 子账号
    • 创建子账户
    • 将积分转移到子账户
    • 轮换子账户 API 密钥
    • 禁用子账户
    • 列出子账户
    • 列出子账户详细信息
  • 批次
    • 发送一批呼叫
    • 使用 AI 分析批次
    • 停止活动批次
    • 列出批次
    • 批次详情
    • 检索批量分析
  • 短信
    • A2P 注册
    • 检查短信 A2P 状态
    • 更新短信提示
    • 短信对话分析
    • 获取短信
    • 切换短信回复方式
    • 更新短信 Webhook
  • 账户
    • 帐户详细资料
  1. 通话

通话详情

开发环境
开发环境
GET
/v1/calls/{call_id}
检索通话的详细信息、元数据和文字记录。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://dev-cn.your-api-server.com/v1/calls/' \
--header 'authorization: <authorization>'
响应示例响应示例
成功示例
{
  "call_id": "d9cce3f3-23cf-4fa7-b62c-8be8119b8715",
  "call_length": 0.75,
  "batch_id": null,
  "to": "+12223334444",
  "from": "+17163511654",
  "request_data": {
    "phone_number": "+12223334444",
    "wait": true,
    "language": "ENG"
  },
  "completed": true,
  "created_at": "2024-04-27T23:51:18.025251+00:00",
  "inbound": false,
  "queue_status": "completed",
  "endpoint_url": "api.prod.bland.ai",
  "max_duration": 30,
  "error_message": null,
  "variables": {
    "now": "Sat Apr 27 2024 18:51:25 GMT-0500 (Central Daylight Time)",
    "now_utc": "Sat, 27 Apr 2024 23:51:25 GMT",
    "short_from": "7163511654",
    "short_to": "2223334444",
    "from": "+17163511654",
    "to": "+12223334444",
    "call_id": "d9cce3f3-23cf-4fa7-b62c-8be8119b8715",
    "phone_number": "+12223334444",
    "city": "SAN FRANCISCO",
    "country": "US",
    "state": "CA",
    "zip": "12345",
    "input": {
      "date": "2024-04-28",
      "rooms": 3
    }
  },
  "answered_by": "human",
  "record": false,
  "recording_url": null,
  "c_id": "d9cce3f3-23cf-4fa7-b62c-8be8119b8715",
  "metadata": {},
  "summary": "The call was a conversation between a hotel booking service assistant and a customer. The customer expressed interest in booking a hotel room for tomorrow and needing three rooms. The assistant booked book the reservation for three rooms for the next day. Then, the call ended with the assistant thanking the customer for choosing their service.",
  "price": 0.068,
  "started_at": "2024-04-27T23:51:25+00:00",
  "local_dialing": false,
  "call_ended_by": "ASSISTANT",
  "pathway_logs": null,
  "analysis_schema": null,
  "analysis": null,
  "concatenated_transcript": "user: Hello? \n assistant: Hi there! I'm calling from the hotel booking service. I'd love to help you with your reservation. Could you let me know what day you'd like to book your hotel for and how many rooms you'll need? \n user: Hopefully, tomorrow, I'm thinking. ...",
  "transcripts": [
    {
      "id": 7395694,
      "created_at": "2024-04-27T23:51:28.568385+00:00",
      "text": "Hello?",
      "user": "user",
      "c_id": "d9cce3f3-23cf-4fa7-b62c-8be8119b8715",
      "status": null,
      "transcript_id": null
    },
    {
      "id": 7395698,
      "created_at": "2024-04-27T23:51:30.689815+00:00",
      "text": "Hi there! I'm calling from the hotel booking service. I'd love to help you with your reservation. Could you let me know what day you'd like to book your hotel for and how many rooms you'll need?",
      "user": "assistant",
      "c_id": "d9cce3f3-23cf-4fa7-b62c-8be8119b8715",
      "status": null,
      "transcript_id": "c58ee235-0763-4ae1-a734-17fbba505c52"
    }
  ],
  "status": "completed",
  "corrected_duration": "45",
  "end_at": "2024-04-27T23:52:10.000Z"
}

请求参数

Path 参数
call_id
string 
必需
您要检索其详细信息的呼叫的唯一标识符。
Header 参数
authorization
string 
必需
示例值:
<authorization>

返回响应

🟢200成功
application/json
Body
call_id
string 
呼叫的唯一标识符。
必需
call_length
number 
必需
通话时长(以分钟为单位)。
batch_id
null 
必需
如果调用是批次的一部分,它将batch_id位于此处。
to
string 
必需
接到电话的电话号码。
from
string 
必需
拨打电话的电话号码。
request_data
object 
必需
原始api请求中参数的详细信息。
phone_number
string 
必需
wait
boolean 
必需
language
string 
必需
completed
boolean 
必需
通话是否已经完成。如果它与“queue_status”的值不同,则这将是最新的状态。
created_at
string 
必需
呼叫是呼入还是呼出。将false用于拨出电话。
started_at
string 
呼叫接通的时间。
必需
end_at
string 
必需
max_duration如果呼叫仍处于连接状态(由于),则呼叫将自动结束的时间。
inbound
boolean 
必需
queue_status
string 
必需
endpoint_url
string 
必需
处理调用的部署的 URL。除非调用是在自定义企业部署上处理的,否则将始终为“api.prod.bland.ai”。
max_duration
integer 
必需
如果发生错误,这将包含错误的描述。否则,它将为空。
error_message
null 
必需
调用期间创建的变量 - 系统变量以及使用dynamic_data自定义工具生成的变量。 例如,如果您使用dynamic_dataAPI 请求生成一个名为 的变量appointment_time,您将在此处看到它(代理的输入和响应变量)。
variables
object 
必需
如果在原始 API 请求中answered_by_enabled设置为true,则该字段包含以下值之一: - human:呼叫由人工接听。 - voicemail:电话由答录机或语音信箱应答。 - unknown:通话开始时没有足够的音频来做出决定。 - no-answer: 电话无人接听。 - null:未启用,或仍在处理结果。 如果answered_by_enabled设置为true,则在呼叫结束后处理呼叫音频时,Webhook 可能需要长达一分钟的时间才能触发。
now
string 
必需
now_utc
string 
必需
short_from
string 
必需
short_to
string 
必需
from
string 
必需
to
string 
必需
call_id
string 
必需
phone_number
string 
必需
city
string 
必需
country
string 
必需
state
string 
必需
zip
string 
必需
input
object 
必需
answered_by
string 
必需
通话声音是否被录音。
recording_url
null 
必需
通话录音的 URL。仅当在原始 API 请求中record设置为时才可用。true
metadata
object 
必需
有关通话的元数据。这可以包括有关客户、客户的信息或您想要包含的任何其他数据。 metadata这与在原始 API 请求中设置的发送调用的设置相同。
summary
string 
必需
基于通话结束时生成的文字记录的通话简短摘要。
price
number 
必需
通话费用以美元计算。
local_dialing
boolean 
必需
呼叫时您的帐户是否启用了本地拨号。
call_ended_by
string 
必需
通话是由布兰德的系统还是线路的另一端结束的。 ASSISTANT: 客服人员结束通话。 USER:用户结束通话。
pathway_logs
null 
必需
路径调用将在此处包含额外的日志,其中包含有关整个流程中所选节点和内部推理的更多详细信息。
analysis_schema
null 
必需
提供的结构用于调用后分析。这是描述呼叫结束后将填充的数据结构的原始框架。
analysis
null 
必需
通话后分析填写的数据。这是由分析模式生成的原始数据。
concatenated_transcript
string 
必需
包含通话中所有文本的单个字符串。不包括系统消息和自动生成的数据。
transcripts
array [object {7}] 
必需
通话期间所说的一系列短语。 每个指标包括: id created_at text user(可以是user、assistant、robot、 或agent-action)
id
integer 
必需
created_at
string 
必需
text
string 
必需
user
string 
必需
c_id
string 
必需
status
null 
必需
transcript_id
string  | null 
必需
status
string 
必需
呼叫的状态。这是呼叫的最新状态,但仅适用于已成功创建的呼叫。
corrected_duration
string 
必需
更正后的呼叫持续时间(以秒为单位)。这是通话的实际长度,而不是max_duration.
修改于 2024-05-10 07:07:54
上一页
列出通话
下一页
声音录制
Built with