Bulk Messaging

Plivo’s Bulk Messaging feature lets you send a single message to multiple destination numbers via a single API request.

To do this, use a list of destination numbers separated with the delimiter < — for example, 14156667777<14157778888<14158889999.

The API verifies that each destination number is in the correct format and removes duplicates. Valid destination numbers are accepted, and a list of invalid destination numbers is returned in the message response.

The Message API supports up to 1,000 unique destination numbers.

Note that messages to all recipients may not be delivered instantly. Messages are dequeued for delivery based on the rate limits configured for your account.

​

Returns

A unique message_uuid is generated for each valid destination number, and the entire list of UUIDs is returned in the message_uuid parameter in the response body.

The list of invalid destination numbers is returned in the invalid_number parameter in the response body.

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.messages.create(
    powerpack_uuid='<powerpack_uuid>',
    dst='+12025551111<+12025552222',
    text='Hello, this is sample text',
    url='https://<yourdomain>.com/sms_status/',
)
print(response)
#prints only the message_uuid
print(response.message_uuid)

{
  "api_id": "984bc856-9231-11e7-b886-067c5485c240",
  "invalid_number": [
    "jsgf3dsjh28372"
  ],
  "message": "message(s) queued",
  "message_uuid": [
    "6da4afba-2bcf-4a87-9eff-d2f88577b0f1",
    "6da384ba-19js-aand-2h3g-r2f8ja0700f1"
  ]
}