发送whatsapp消息

推送消息给所有接收者

当whatsapp公众号发送消息时相当于bot发送消息。需opt-in后才能推送消息，即当天发送过消息的用户才能进行消息的推送。whatsapp把需要推送的消息推送给所有接收者，消息类型可以为文字、图片、文档等。

限制

１、一个调用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) 向手机号用户发送消息，消息可以是文字、图片、文档等。这个请求的说明如下：

请求样例

Text message：

{
    "id": "<unique message identifier>",
    "to": "<phone number of the user>",
    "timestamp": "<timestamp>",
    "source": "<botchat / livechat>",
    "type": "text",
    "text": {
        "body": "Hello world"
    }
}

Image message：

{
    "id": "<unique message identifier>",
    "to": "<phone number of the user>",
    "timestamp": "<timestamp>",
    "source": "<botchat / livechat>",
    "type": "image",
    "image": {
        "url": "your-media-url",
        "caption": "your-image-caption",
        "extension": "<see the list of available extensions>"
    }
}

Document message：

{
    "id": "<unique message identifier>",
    "to": "<phone number of the user>",
    "timestamp": "<timestamp>",
    "source": "<botchat / livechat>",
    "type": "document",
    "document": {
        "url": "your-document-url",
        "caption": "your-document-caption",
        "extension": "<see the list of available extensions>"
    }
}

Audio message：

{
    "id": "<unique message identifier>",
    "to": "<phone number of the user>",
    "timestamp": "<timestamp>",
    "source": "<botchat / livechat>",
    "type": "document",
    "audio": {
        "url": "your-audio-url",
        "caption": "your-audio-caption",
        "extension": "<see the list of available extensions>"
    }
}

请求返回值

• 成功返回值样例

{
    "result": true,
    "data": {}
}

• 失败返回值样例

{
    "error": {
        "code": 10011,
        "error_subcode": 0,
        "type": "",
        "message": "Request already processed",
        "request_id": 35122312158
    }
}

错误码列表