您可以使用 messages
节点向您的客户发送文本消息。
/messages
发出 POST
请求获得您想向其发送消息的用户的 WhatsApp 编号后,使用此编号发送文本消息。在 type
字段中指定 text
。
POST /v1/messages { "preview_url": false | true, "recipient_type": "individual", "to": "whatsapp-id", "type": "text", "text": { "body": "your-text-message-content" } }
如需了解有关参数的更多信息,请参阅以下文档:
如果您希望设置消息的格式,请参阅在文本消息中设置格式。
默认情况下,移动 WhatsApp 应用程序会识别网址,并将其处理为可点击形式。如要添加网址预览,请在消息正文中添加 "preview_url": true
,并确保网址以 http://
或 https://
开头。如果 IP 地址不匹配,则必须提供主机名。
请注意,此处 preview_url
的使用方法不同于云端 API。请参阅“云端 API”下的消息文档。
{ "preview_url": true, "to": "whatsapp-id", "text": { "body": "You have to check out this amazing messaging service https://www.whatsapp.com/" }
大多数情况下,当您发送网址时,无论是否包含预览,消息收件人都会看到可以点击的网址。
仅在发生下列任一事项后,系统才会显示网址预览:
若请求成功,响应包含 messages
对象,其中带有新建消息的编号。
{ "messages": [{ "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU" }] }
若请求失败,响应会包含错误消息。如需更多信息,请参阅错误和状态代码。