Skip to content

PNS API Error Webhook

henryou edited this page Apr 10, 2023 · 1 revision

概要

  • 进行不存在绑定关系的呼叫时会出现呼叫失败,将错误呼叫信息推送给指定URL。

URL配置

  • 通过提供URL,给研发人员进行配置

请求方式

  • Method: POST
  • Content-Type: application/json

重试规则

一般情况下,话单信息将在通话结束后推送回指定的地址。收到HTTP 200 OK代表已接受回执推送,本次请求将视为已完成。 如果收到HTTP ERROR信息,NXCLOUD将在60分钟内,每分钟重试推送。直到成功为止,如果超过60分钟仍然失败,则不再重复推送。

推送字段说明

参数名 类型 说明
code int 返回码,0代表成功,其他失败
msg string 返回码描述
requestId string 请求id
data struct 数据

data中参数如下:

参数名 类型 说明
action string 请求接口
requestParams struct 请求参数
occurrenceTime string 请求时间

requestParams中参数如下:

参数名 类型 说明
caller string 主叫号码
did string did号码(中间号码X)

推送Demo

{
  "code": 10013,
  "msg": "binding not exist",
  "requestId": "1640920940635361280",
  "data": {
    "action": "queryAXB",
    "requestParams": {
      "caller": "852121199",
      "did": "85299999999"
    },
    "occurrenceTime": "2023-03-29 11:36:53"
  }
}

简介

短信

语音

云呼叫中心(NXLink)

云呼叫中心(AI自动外呼)

Flash Call

短链

邮件验证码

DID号码

通用

号码检测

WhatsApp

Viber

Zalo ZNS

Super Message API

隐私号(旧)

PNS

坐席(旧版)

AI Agent(对外api)

Clone this wiki locally