直接发送消息

post

https://api.ycloud.com/v2/whatsapp/messages/sendDirectly

直接发送出站WhatsApp消息。

消息同步提交到WhatsApp Business API。通常用于发送OTP和即时消息。

如果我们尝试请求WhatsApp Business API并收到错误响应，响应体字段error.whatsappApiError将被包含。

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

WhatsApp Business API 默认支持每个商务电话号码最多 80 MPS（每秒消息数）。吞吐量包括入站和出站消息以及所有消息类型。

👍
For more specific request examples, seeWhatsApp Messaging Examples.

👍
Configure Webhooks to keep track of message status updates. See also WhatsApp Message Updated Webhook Examples

🚧
See WhatsApp Errors for error handling.

Body Params

请提供 to 或 recipient 中的一个；如果两者都提供，则以 to 为准并忽略 recipient。

from

string

required

发送者的电话号码，格式为E.164。

string

接收者的电话号码，格式为E.164。未提供 recipient 时必需。

recipient

string

接收方 WhatsApp Business-scoped user ID（BSUID）或 parent BSUID。未提供 to 时必需。

customerProfile

object

接收方资料信息。username-only 或 BSUID 发送场景会用于持久化 WhatsApp username。

type

string

enum

required

WhatsApp出站消息类型。
另请参阅WhatsApp消息。

template

object

当type为template时必需。

text

object

当type为text时必需。

image

object

当type为image时必需。

video

object

当type为video时必需。

audio

object

当type为audio时必需。

document

object

当type为document时必需。

sticker

object

当type为sticker时必需。

location

object

当type为location时必需。

interactive

object

当type为interactive时必需。

contacts

array of objects

当type为contacts时必需。

contacts

reaction

object

当type为reaction时必需。

context

object

用于提及您正在回复的特定消息。回复可以是任何消息类型。

externalId

string

用于引用对象的唯一字符串（推荐）。这可以是订单号或类似标识符，可用于将对象与您的内部系统进行对账。

200请求成功被接受。