Sample code for 30+ languages & platforms
C++ Requires Chilkat v11.0.0+

Download the media files from a Twilio MMS

See more Twilio Examples

Supply the Message SID of a received or sent MMS. List its media records, then request each media resource without the .json extension to download the file bytes. Twilio may return a temporary HTTPS download URL. The example uses a separate HTTP client for that URL so the Twilio API key stays with the API host.

Run in an empty output directory. Files are written as mms-media-1.bin, mms-media-2.bin, and so on. The code prints the media SID and MIME type alongside each filename. An empty media list produces a count of zero.

Twilio documentation

Chilkat C++ Downloads

C++
#include <CkHttp.h>
#include <CkStringBuilder.h>
#include <CkHttpResponse.h>
#include <CkJsonObject.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    //  Load an API key for the Twilio account from private application configuration.
    CkHttp http;
    http.put_RequireSslCertVerify(true);
    http.put_BasicAuth(true);
    http.put_Login("YOUR_API_KEY_SID");
    http.put_Password("YOUR_API_KEY_SECRET");

    CkStringBuilder url;
    url.Append("https://api.twilio.com/2010-04-01/Accounts/");
    url.Append("YOUR_ACCOUNT_SID");
    url.Append("/Messages");
    url.Append("/");
    url.Append("YOUR_MESSAGE_SID");
    url.Append("/Media");
    CkStringBuilder mediaBase;
    mediaBase.AppendSb(url);
    url.Append(".json");
    //  Handle the API redirect explicitly so a signed download uses no Twilio credentials.
    http.put_FollowRedirects(false);
    CkHttp download;
    download.put_RequireSslCertVerify(true);
    CkHttpResponse fileResp;
    CkStringBuilder fileUrl;
    CkStringBuilder filename;
    CkStringBuilder mediaSid;
    int saved = 0;
    CkHttpResponse resp;
    CkJsonObject reply;

    bool more = true;
    while ((more == true)) {
        success = http.HttpNoBody("GET",url.getAsString(),resp);
        if (resp.get_StatusCode() == 0) {
            std::cout << "No HTTP response from Twilio." << "\r\n";
            return;
        }

        bool parsed = reply.Load(resp.bodyStr());
        if ((success != true) || (resp.get_StatusCode() != 200)) {
            std::cout << "Twilio returned HTTP " << resp.get_StatusCode() << "\r\n";
            if ((parsed == true) && (reply.JsonTypeOf("code") == 2)) {
                std::cout << "Twilio error: " << reply.IntOf("code") << "  " << reply.stringOf("message") << "\r\n";
            }

            return;
        }

        if (parsed != true) {
            std::cout << "Expected a JSON response from Twilio." << "\r\n";
            return;
        }

        if (reply.JsonTypeOf("media_list") != 4) {
            std::cout << "Expected an array of media items." << "\r\n";
            return;
        }

        int count = reply.SizeOfArray("media_list");
        int i = 0;
        while ((i < count)) {
            reply.put_I(i);
            mediaSid.SetString(reply.stringOf("media_list[i].sid"));
            if (mediaSid.get_Length() == 0) {
                std::cout << "Media item is missing its SID." << "\r\n";
                return;
            }

            fileUrl.SetString(mediaBase.getAsString());
            fileUrl.Append("/");
            fileUrl.AppendSb(mediaSid);
            success = http.HttpNoBody("GET",fileUrl.getAsString(),fileResp);
            if ((fileResp.get_StatusCode() >= 300) && (fileResp.get_StatusCode() < 400)) {
                fileUrl.SetString(fileResp.getHeaderField("Location"));
                if (fileUrl.StartsWith("https://",false) != true) {
                    std::cout << "Expected an HTTPS media download URL." << "\r\n";
                    return;
                }

                success = download.HttpNoBody("GET",fileUrl.getAsString(),fileResp);
            }

            if ((success != true) || (fileResp.get_StatusCode() != 200)) {
                std::cout << "Media download failed for " << mediaSid.getAsString() << ". HTTP " << fileResp.get_StatusCode() << "\r\n";
                return;
            }

            filename.SetString("mms-media-");
            filename.AppendInt(saved + 1);
            filename.Append(".bin");
            success = fileResp.SaveBodyBinary(filename.getAsString());
            if (success == false) {
                std::cout << fileResp.lastErrorText() << "\r\n";
                return;
            }

            std::cout << filename.getAsString() << "  " << mediaSid.getAsString() << "  " << reply.stringOf("media_list[i].content_type") << "\r\n";
            saved = saved + 1;
            i = i + 1;
        }

        if (reply.IsNullOf("next_page_uri") == true) {
            more = false;
        }
        else {
            url.SetString(reply.stringOf("next_page_uri"));
            if (url.StartsWith("/2010-04-01/Accounts/",true) != true) {
                std::cout << "Expected a Twilio relative next-page URI." << "\r\n";
                return;
            }

            url.Prepend("https://api.twilio.com");
        }

    }

    std::cout << "Media files saved: " << saved << "\r\n";
    }