This service sends message(s) to many users via a provided receiver list. Unlike sendmsgserv, a valid session between the service and each user is not required (you can message followers who have been inactive for a while). It works asynchronously.
Send the service username/password in the Header using Basic Authentication.
| Field | Value | Description |
|---|---|---|
| *txnid | string | Request id value |
| *receiver | object | |
| *type | int | Recipient address type. Values: 0 -> Hashed address 1 -> All addresses following the service 2 -> MSISDN (plain number) |
| *address | string | Address in the type specified by type. If type is 0, address is hashed (value provided by bipussu). If type is 1, address must not be in the request. If type is 2, provide the address in 905XXXXXXXXX format. |
| *composition | object | |
| *list | list | Messages to send; at least 1 item required. |
| *type | int | Message type. Values: 0 – Text 2 – Photo 3 – Audio 4 – Video 5 – Sticker 6 – Caps 7 – Location 9 – Finish Line 10 – Contact 13 – Template Media Message 14 – Document. Additional parameters depend on the selected type. |
| expire | int | Seconds until the message disappears. Values: 3, 5, 10, 60 |
| extra params | Additional parameters depending on content type. See content type formats. |
| Field | Value | Description |
|---|---|---|
| *txnid | string | Request id value |
| *resultcode | string | Response code. 0 for success; failures see Error Codes. |
| *list | list | Filled if successful and reporting is available. |
| *resultcode | int | Send result. 0 for success; otherwise see Error Codes. |
| *receiver | string | Recipient. |
| *reportid | string | Id of the message sent to the user. |
| *numberofmessage | int | Number of messages to the user. |
| *totalnumberofmessage | int | Total number of messages sent to the user. |
Validations follow the same rules as the single-user service; see Error Handling and Validations sections for details.