我们将于 2024 年 7 月 31 日逐步淘汰 Google Business Messages。点击
此处了解详情。
Method: conversations.messages.create
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
从代理向用户发送消息。如果对话不存在,或者客服人员尝试在无权参与的对话中发送消息,会返回 PERMISSION DENIED
错误。
HTTP 请求
POST https://businessmessages.googleapis.com/v1/{parent=conversations/*}/messages
网址采用 gRPC 转码语法。
路径参数
参数 |
parent |
string
必需。包含邮件的会话。解析为“conversations/{conversationId}”。
|
查询参数
参数 |
forceFallback |
boolean
可选。用于发送指定的后备文本而不是其他消息内容的标志。仅适用于未发布的代理。 如果该标志为 true 且未指定后备文字,Business Messages 会返回错误。
|
请求正文
请求正文包含一个 Message
实例。
响应正文
如果成功,响应正文将包含一个新创建的 Message
实例。
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/businessmessages
有关详情,请参阅 OAuth 2.0 概览。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eSends a message from an agent to a user within a specific conversation.\u003c/p\u003e\n"],["\u003cp\u003eReturns a \u003ccode\u003ePERMISSION DENIED\u003c/code\u003e error if the conversation doesn't exist or the agent isn't authorized.\u003c/p\u003e\n"],["\u003cp\u003eAllows sending fallback text instead of the main message content for non-launched agents using the \u003ccode\u003eforceFallback\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/businessmessages\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eUses the \u003ccode\u003ePOST\u003c/code\u003e method with the URL \u003ccode\u003ehttps://businessmessages.googleapis.com/v1/{parent=conversations/*}/messages\u003c/code\u003e to send the message.\u003c/p\u003e\n"]]],[],null,["# Method: conversations.messages.create\n\nSends a message from an agent to a user. If a conversation doesn't exist or an agent tries to send a message in a conversation that it isn't authorized to participate in, returns a `PERMISSION DENIED` error.\n\n### HTTP request\n\n`POST https://businessmessages.googleapis.com/v1/{parent=conversations/*}/messages`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The conversation that contains the message. Resolves to \"conversations/{conversationId}\". |\n\n### Query parameters\n\n| Parameters ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `forceFallback` | `boolean` Optional. A flag to send the specified fallback text instead of other message content. Only available to agents that aren't launched. If the flag is true and fallback text isn't specified, Business Messages returns an error. |\n\n### Request body\n\nThe request body contains an instance of [Message](/business-communications/business-messages/reference/rest/v1/conversations.messages#Message).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Message](/business-communications/business-messages/reference/rest/v1/conversations.messages#Message).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/businessmessages`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]