云呼-设备呼叫小程序

POST

/device/wx_voip/call_app

这个接口会调用微信开放平台的 /wxa/business/iot/voip/call 发起呼叫接口。接口需要设备开通了微信 VoIP 服务才可以正常使用，否则报错 (14850012(设备不支持呼叫微信小程序))。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "uuid": "e270f24f-ef72-42c7-9acd-b97454fa1b1f",
    "wxa_user_openid": "62",
    "wxa_model_id": "33",
    "wxa_listener_name": "管丽萍",
    "wxa_version_type": "quis do",
    "wxa_query": "consectetur esse enim",
    "wxa_room_type": "laborum Lorem officia ex",
    "wxa_caller_camera_status": 16,
    "wxa_listener_camera_status": 10,
    "payload": "laboris ex"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/device/wx_voip/call_app' \
--header 'X-Tg-App-Id: xxx' \
--header 'X-Tg-Platform: {{platform}}' \
--header 'X-Tg-Sdk-Version: 23910000' \
--header 'X-Tg-App-Store: {{appstore}}' \
--header 'X-Tg-App-Version: {{app_version}}' \
--header 'X-Tg-App-Pkgname: {{pkgname}}' \
--header 'X-Tg-Date: {{currentUTCTime}}' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uuid": "e270f24f-ef72-42c7-9acd-b97454fa1b1f",
    "wxa_user_openid": "62",
    "wxa_model_id": "33",
    "wxa_listener_name": "管丽萍",
    "wxa_version_type": "quis do",
    "wxa_query": "consectetur esse enim",
    "wxa_room_type": "laborum Lorem officia ex",
    "wxa_caller_camera_status": 16,
    "wxa_listener_camera_status": 10,
    "payload": "laboris ex"
}'

返回响应

🟢200成功

application/json

Body

示例

16700013 get_access_token_failed16700018 wechat_iot_voip_call_failed

可能原因:

客户微信小程序开启了 ip 白名单，需要将我们的服务端 ip 加到白名单上，参见 https://developers.weixin.qq.com/doc/service/guide/dev/api/

获取稳定版接口调用凭据接口所需要的其他参数错误

{
    "code": 16700013,
    "msg": "get_access_token_failed",
    "request_id": "xxxxxxxxxxxxxx"
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2026-03-12 16:37:04

获取设备票据

查询SIM卡信息