Batch Message Requests

8MS Batch Message Requests

Batch requests are those that cause messages to be sent to SMS/800 for a list of toll free numbers. The comma-separated list of numbers is specified using the dnlist parameter.

Batch API calls have several parameters in common. The common parameters are rundate, comment, and flowmax.

API batches may be scheduled. The run date/time is specified using the rundate parameter. The format of this value is:

mm/dd/yy hh:mmX

where X is the meridiem (A or P).

To run a batch immediately, don't use this parameter.

If rundate contains a future date/time or timeout is set to 0 batch requests will always return immediately with an Information Incomplete message. In all other cases the api request will wait until the batch completes or the timeout is reached.

An API batch may have a comment associated with it. The comment is specified using the comment parameter. This comment will be seen in the Batch Log screen.

The number of messages per hour sent to SMS/800 may be limited in a batch. This is intended to avoid exceeding the per Resp Org CPU percent allocation defined by SMS/800. The maximum messages per hour is set in the parameter flowmax.

For companies that are on an 8MS Plan Type of Transactions, please note the following. All Batch API calls count as one GUI transaction for each number plus a single API transaction for the call itself.

The following batch requests are supported by the 8MS API: