Sending MMS vs. SMS in Powerpack API
The procedure to send MMS messages using Powerpack is similar to the procedure for sending SMS messages, with a few minor changes. To send an MMS message using Powerpack, replace the src parameter in the JSON body with powerpack_uuid and provide the Powerpack UUID to be used to send out the messages.
The Powerpack must have at least one MMS long code or toll-free number associated with it in order to send an MMS using Powerpack.
MMS number addition in Powerpack
Long code number
For Powerpack to identify your long code number as able to send MMS messages, you must add the number as a MMS number by using the command “argument service = mms”. Refer to the Plivo API Reference Doc for more detail.
Toll-free number
Some toll-free numbers are capable of sending both MMS and SMS messages. Our system automatically identifies that number type when you add it to Powerpack and will utilize the toll-free number for both MMS and SMS numbers. If the toll-free number is capable of sending only SMS, then the Powerpack will utilize the number only for SMS messages, and not for MMS messages.
Sending MMS using Powerpack
Example from Postman:
CURL request snippet:
curl --location --request POST 'https://api.plivo.com/v1/Account/{{Auth_ID}}/Message/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic xxxxxxxxxxxxxx==' \
--data-raw '{
"powerpack_uuid": "{{powerpack_uuid}}",
"dst": "{{destination_number}}",
"text": "This is a Sample MMS using Powerpack",
"media_urls": ["{{media_url_1}}", "{{media_url_2}}", "{{media_url_3}}"],
"media_ids": "["{{media_id_1}}", "{{media_idl_2}}"]",
"url": "{{callback_url}}",
"type": "mms",
"log": "true"
}'
What if my Powerpack doesn't have any MMS numbers?
To send out MMS messages using Powerpack, you must have at least one MMS number in the Powerpack. If the given Powerpack doesn't have any MMS numbers, it will fail to find a source number in the number pool, which will cause your MMS send to fail.
If sending an MMS message fails at the API level, you'll receive the following error: Your message could not be queued at this time. If the problem persists, please contact support@plivo.com.
What happens when the default Powerpack is enabled and I try sending MMS with an SMS number from Powerpack?
If your Powerpack has an MMS number, it will be identified and used to send out the message. If the given source number doesn't have MMS capability, sending the MMS message will fail.
What happens if I give an invalid Powerpack UUID while sending MMS messages?
If you give an invalid Powerpack UUID, then sending MMS will fail at the API level, with the following error: Your message could not be queued at this time. If the problem persists, please contact support@plivo.com.