查询单条消息渠道信息

查询单条指定消息渠道的详细信息。

注： 此 API 接口可用于查询 SMS 消息渠道、WhatsApp 消息渠道和 Facebook 消息渠道的信息。如需查询在线咨询渠道的信息，请参见 查询单条在线咨询渠道信息。

请求 URL

GET {base_url}/{api_path}/message_channel/get?access_token={access_token}

请求参数

表 1.
参数 是否必填 类型 说明
id 是 Integer 消息渠道的唯一 ID。
注： 可使用 查询特定消息渠道 接口查询消息渠道 ID。

响应参数

表 2.
参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
data Object<Msg_Channel> 消息渠道详情。
Msg_Channel
表 3.
参数 类型 说明
id Integer 消息渠道的唯一 ID。
name String 消息渠道名称。
domain_type String Webhook URL 所使用的域名类型。
  • fqdn：Yeastar FQDN。
  • nat：通过 NAT 映射公网 IP 后的域名。
webhook_gid String Webhook 的全局唯一标识。
webhook_url String 用于消息推送 webhook 的 Webhook URL。
type String 消息渠道类型。
  • sms
  • whatsapp
  • facebook
channel String 消息渠道的运营商。
  • general
  • apidaze
  • athena
  • bandwidth
  • flowroute
  • ixica
  • siptrunk
  • skyetel
  • telnyx
  • twilio
  • vetta
  • voicemeup
  • whatsapp
  • facebook
account_data Array<Auth_Info> 运营商要求的消息渠道连接所需信息。
verify_token String 用于 Webhook 验证的令牌。
phone_number_id String 号码 ID。
注： 此参数仅在查询 WhatsApp 消息渠道时会返回信息。
business_account_id String WhatsApp 账户 ID。
注： 此参数仅在查询 WhatsApp 消息渠道时会返回信息。
send_rate Integer 消息发送速率，表示 PBX 通过该消息渠道每秒可发送的消息数量。
auto_close_session Integer 是否自动关闭在指定时间内无任何互动的消息会话。
  • 0：禁用。
  • 1：启用。
session_expired_time Integer 会话超时时间 (天)。消息会话在超过此指定时间未有任何互动后将自动关闭。
dids Array<Msg_Routing> 消息渠道的消息路由规则详情。
accompanying_msg String 发送聊天文件时附带的默认文本内容。
注： 此参数仅在查询 Apidaze SMS 短信渠道时返回信息。
Auth_Info
参数 类型 说明
k String 运营商要求的对接信息的字段名。
v String 对接信息字段值。
Msg_Routing
参数 类型 说明
id Integer DID 号码的唯一 ID。
omnichannel_id Integer DID 号码绑定的消息渠道的唯一 ID。
did_number String 与消息渠道绑定的 DID 号码。
destination_id String 消息接收目的地的 ID。
destination_number String 消息接收目的地的号码。
destination_name String 消息接收目的地的名称。
members Array<Members> 允许使用此 DID 号码创建会话以发送消息的成员。
destination_type String 消息接收目的地的类型。
  • extension：分机用户。
  • queue：消息队列。
  • api：第三方分析平台 (消息通过二次开发接口传递)
Members
参数 类型 说明
text String 成员的名称。
text2 String 成员信息，依据成员类型而定。
  • 对于分机，此参数返回分机号码。
  • 对于分机组，此参数返回分机组名称。
  • 对于部门，此参数返回为空。
value String 成员的唯一 ID。
type String 成员类型。
  • extension：分机。
  • ext_group：分机组。
  • organization：部门。

示例

请求示例

查询消息渠道 (ID：3) 的信息。

GET /openapi/v1.0/message_channel/get?access_token=IhFe7Gv1L3chn45Bwmxz3GKKKmjXAaDs&id=3 HTTP/1.1
Host: 192.168.5.150:8088

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "data": {
        "id": 3,
        "name": "WhatsApp Channel",
        "webhook_gid": "90c8a2b5b3434471bd73e7c802952f96",
        "type": "whatsapp",
        "channel": "whatsapp",
        "account_data": [
            {
                "k": "access_token",
                "v": "EAAXmEG1QQccBO9wpYSY3r1ZApPu4mmEUvOszfHil3mYLn8xnIlOtirhNoZAybL3TKFHxhgFzdOO9ZBk2XVRPnAHNZCCRmrKZClsM4VCqBPqJWRIt3yaZAjYJZC79UO2pTYaJbtSlIhvHEmSdXXgzmGpsfMFCHEh4N3bY7rsarAf214VP2JFbwNihmXQZAmeSFwZDZD"
            },
            {
                "k": "app_secret",
                "v": "41665cf6ef8971b3e1778432ffc2f077"
            }
        ],
        "auto_close_session": 1,
        "session_expired_time": 1,
        "dids": [
            {
                "did_number": "+15550193510",
                "destination_id": "5",
                "destination_number": "",
                "members": [
                    {
                        "text": "Default_All_Extensions",
                        "text2": "Default_All_Extensions",
                        "value": "1",
                        "type": "ext_group"
                    }
                ],
                "destination_type": "api"
            }
        ],
        "webhook_url": "https://docs.example.yeastar.com/api/v1.0/webhook/whatsapp/90c8a2b5b3434471bd73e7c802952f96",
        "send_rate": 80,
        "phone_number_id": "11577555571069",
        "verify_token": "braxzqj5z8md6e29",
        "domain_type": "fqdn",
        "accompanying_msg": "",
        "business_account_id": "10615155550235"
    }
}