将消息加入队列

post

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

将出站WhatsApp消息加入队列以进行发送。

队列中的消息将异步提交到WhatsApp Business API。

对于 WhatsApp template 消息，引用的模板必须是 APPROVED 状态。ARCHIVED 模板不可发送。

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

您可以以每个商务电话号码 200 MPS（每秒消息数）的速率将消息加入队列。这些排队的消息会以 60 MPS 的速率提交给 WhatsApp Business API。

👍
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

from

string

required

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

string

required

接收者的电话号码，格式为E.164。

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

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

filterUnsubscribed

boolean

可选。
如果设置为true，消息将不会发送给已取消订阅您账户的用户。默认为false。

仅用于POST /v2/whatsapp/messages。如果用户已取消订阅，我们将推送webhook通知，whatsappMessage.errorCode设置为RECIPIENT_UNSUBSCRIBED。

不适用于POST /v2/whatsapp/message/sendDirectly。

filterBlocked

boolean

可选。
如果设置为true，消息将不会发送给您阻止列表中的用户。默认为false。

仅用于POST /v2/whatsapp/messages。如果用户在您的阻止列表中，我们将推送webhook通知，whatsappMessage.errorCode设置为RECIPIENT_IN_BLOCK_LIST。

不适用于POST /v2/whatsapp/message/sendDirectly。

Response

200请求成功被接受。