Use this method to send high-volume SMS or MMS traffic. When used, the Wavix platform only checks if the request payload is well-formed JSON and runs basic lookups. The method returns the unique message identifier, which can be used to periodically poll the message status. Additional information on the destination number, such as MCC and MNC codes, number of segments, and charge for the message, is provided after the message is processed by Wavix.
If the callback_url parameter is specified in the request, the platform automatically forwards a DLR report to it once the message is received by the destination phone number.
An SMS message can be sent with a numeric or alphanumeric Sender ID registered on the Wavix platform, while MMS can be only sent to U.S. and Canadian phone numbers only using a 10-digit numeric or a short code as Sender ID.
This endpoint requires authentication.
POST /messages/asyncMessaging
| HTTP Status Code | Error Description | Exception Class |
|---|---|---|
403 | Request failed. Messaging service is disabled on your account. | |
422 | Request failed. The response indicates the reason of failure. |
curl -X POST \
--url 'https://api.wavix.com/v2/messages/async?appid=appid' \
-H 'Accept: application/json'\
-H 'Content-Type: application/json' \
--data-raw '{
"from": "Wavix",
"to": "447712345661",
"message_body": {
"text": "SMS message"
}
}'