直接发送消息

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

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请求成功被接受。