# 发送whatsapp消息
## 推送消息给所有接收者
当whatsapp公众号发送消息时相当于bot发送消息。需[opt-in](https://developers.facebook.com/docs/whatsapp/guides/opt-in)后才能推送消息，即当天发送过消息的用户才能进行消息的推送。whatsapp把需要推送的消息推送给所有[接收者](/project/advanced-tool/api/whatsapp-xiao-xi-ru-kou.md)，消息类型可以为文字、图片、文档等。
### 限制
１、一个调用whatsapp接口的频率常态不能超过20 request per second，瞬时值不能超过60 request per second。落实到发消息的层面，发一条消息需要一个request，并且在给用户消息之前还需要有一个request来确认是否可以发push notification给这个用户。因此发消息给新用户的频率限制就是10 users per second。
２、每天可以发送push notification的用户数的限制：
限制分为三个tier，tier1：每天可以最多发notification到1000个用户。tier2：每天可以最多发notification到10000个用户。tier3：每天可以最多发notification到10万个用户。
升级方式：tier1->tier2：需满足在不超过7天内发送notification到2000个用户。 tier2->tier3：需满足在不超过7天内发送notification到20000个用户。
### 发送请求
您可以用任意一个已经启用的API Key([怎样申请APIKey](https://bothubdocs.gitbook.io/project/~/edit/drafts/-LCWfeDNA9QGt2vCxD8D/untitled-2/api-jie-shao/kai-shi-shi-yong-api)) 向手机号用户发送消息，消息可以是文字、图片、文档等。这个请求的说明如下：
| 请求属性 | 属性名 | 说明 |
| --------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 地址 | | [/channels/{](https://whatsappapi.bothub.ai/channels//messages)[bot\_phone](https://whatsappapi.bothub.ai/channels//messages)[}/messages](https://whatsappapi.bothub.ai/channels//messages) |
| 请求方式 | POST | |
| Header | APIKEY | 您的API KEY. |
| Header | Content-Type | application/json |
| Form Data | id | 由WhatsApp分配的消息ID |
| Form Data | to | channel的手机号 |
| Form Data | timestamp | 信息发送的时间戳 |
| Form Data | source | 消息来源 (botchat/livechat ) |
| Form Data | type | 消息类型（text/image/document/audio） |
| Form Data | text | 当type=text 时显示。形式如下方Text message样例。 |
| Form Data | image | 当type=image 时显示。形式如下方Image message样例。 |
| Form Data | document | 当type=document 时显示。形式如下方Document message样例。 |
| Form Data | audio | 当type=audio 时显示。形式如下方Audio message样例。 |
### **请求样例**
{% code title="Text message" %}
```javascript
{
"id": "",
"to": "",
"timestamp": "",
"source": "",
"type": "text",
"text": {
"body": "Hello world"
}
}
```
{% endcode %}
{% code title="Image message" %}
```javascript
{
"id": "",
"to": "",
"timestamp": "",
"source": "",
"type": "image",
"image": {
"url": "your-media-url",
"caption": "your-image-caption",
"extension": ""
}
}
```
{% endcode %}
{% code title="Document message" %}
```javascript
{
"id": "",
"to": "",
"timestamp": "",
"source": "",
"type": "document",
"document": {
"url": "your-document-url",
"caption": "your-document-caption",
"extension": ""
}
}
```
{% endcode %}
{% code title="Audio message" %}
```javascript
{
"id": "",
"to": "",
"timestamp": "",
"source": "",
"type": "document",
"audio": {
"url": "your-audio-url",
"caption": "your-audio-caption",
"extension": ""
}
}
```
{% endcode %}
### 请求返回值
* 成功返回值样例
```javascript
{
"result": true,
"data": {}
}
```
* 失败返回值样例
```javascript
{
"error": {
"code": 10011,
"error_subcode": 0,
"type": "",
"message": "Request already processed",
"request_id": 35122312158
}
}
```
### 错误码列表
| 返回值 | 内容 |
| ----- | ---------------------- |
| 10000 | 内部错误 |
| 10001 | 未指定API KEY |
| 10002 | 无效的API KEY |
| 10003 | 未指定Request id |
| 10004 | 未指定调用API的种类 |
| 10005 | 无效的API种类 |
| 10005 | 无效的API种类 |
| 10006 | Bot不存在或者已经被删除 |
| 10011 | Request id与之前的重复 |
| 10100 | 参数无效 |
| 18000 | 内部错误 |
| 19000 | 回调超时 |
| 41006 | 未指定id |
| 41007 | 未指定to |
| 41008 | 未指定type |
| 41009 | 未指定timestamp |
| 41010 | 未指定image |
| 41011 | 未指定document |
| 41012 | 未指定text |
| 41013 | 未指定audio |
| 41014 | 无效的type |
| 41015 | 未指定text内的body |
| 41016 | 未指定document内的caption |
| 41017 | 未指定document内的url |
| 41018 | 未指定document内的extension |
| 41019 | 未指定image内的caption |
| 41021 | 未指定image内的url |
| 41022 | 未指定image内的extension |
| 41023 | 未指定audio内的caption |
| 41024 | 未指定audio内的url |
| 41025 | 未指定audio内的extension |
| 41035 | 未指定source |
| 41036 | source值不正确 |
| 80001 | BSP错误 |
| 80002 | network error |
###
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://bothub.gitbook.io/project/advanced-tool/api/fa-song-whatsapp-xiao-xi.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.