Sample code for 30+ languages & platforms
Tcl 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 Tcl Downloads

Tcl

load ./chilkat.dll

set success 0

#  Assumes Chilkat is unlocked. See Global Unlock Sample.
#  Load an API key for the Twilio account from private application configuration.
set http [new_CkHttp]

CkHttp_put_RequireSslCertVerify $http 1
CkHttp_put_BasicAuth $http 1
CkHttp_put_Login $http "YOUR_API_KEY_SID"
CkHttp_put_Password $http "YOUR_API_KEY_SECRET"

set url [new_CkStringBuilder]

CkStringBuilder_Append $url "https://api.twilio.com/2010-04-01/Accounts/"
CkStringBuilder_Append $url "YOUR_ACCOUNT_SID"
CkStringBuilder_Append $url "/Messages"
CkStringBuilder_Append $url "/"
CkStringBuilder_Append $url "YOUR_MESSAGE_SID"
CkStringBuilder_Append $url "/Media"
set mediaBase [new_CkStringBuilder]

CkStringBuilder_AppendSb $mediaBase $url
CkStringBuilder_Append $url ".json"
#  Handle the API redirect explicitly so a signed download uses no Twilio credentials.
CkHttp_put_FollowRedirects $http 0
set download [new_CkHttp]

CkHttp_put_RequireSslCertVerify $download 1
set fileResp [new_CkHttpResponse]

set fileUrl [new_CkStringBuilder]

set filename [new_CkStringBuilder]

set mediaSid [new_CkStringBuilder]

set saved 0
set resp [new_CkHttpResponse]

set reply [new_CkJsonObject]

set more 1
while {$more == 1} {
    set success [CkHttp_HttpNoBody $http "GET" [CkStringBuilder_getAsString $url] $resp]
    if {[CkHttpResponse_get_StatusCode $resp] == 0} then {
        puts "No HTTP response from Twilio."
        delete_CkHttp $http
        delete_CkStringBuilder $url
        delete_CkStringBuilder $mediaBase
        delete_CkHttp $download
        delete_CkHttpResponse $fileResp
        delete_CkStringBuilder $fileUrl
        delete_CkStringBuilder $filename
        delete_CkStringBuilder $mediaSid
        delete_CkHttpResponse $resp
        delete_CkJsonObject $reply
        exit
    }

    set parsed [CkJsonObject_Load $reply [CkHttpResponse_bodyStr $resp]]
    if {expr [$success != 1]  ||  [[CkHttpResponse_get_StatusCode $resp] != 200]} then {
        puts "Twilio returned HTTP [CkHttpResponse_get_StatusCode $resp]"
        if {expr [$parsed == 1]  &&  [[CkJsonObject_JsonTypeOf $reply "code"] == 2]} then {
            puts "Twilio error: [CkJsonObject_IntOf $reply code]  [CkJsonObject_stringOf $reply message]"
        }

        delete_CkHttp $http
        delete_CkStringBuilder $url
        delete_CkStringBuilder $mediaBase
        delete_CkHttp $download
        delete_CkHttpResponse $fileResp
        delete_CkStringBuilder $fileUrl
        delete_CkStringBuilder $filename
        delete_CkStringBuilder $mediaSid
        delete_CkHttpResponse $resp
        delete_CkJsonObject $reply
        exit
    }

    if {$parsed != 1} then {
        puts "Expected a JSON response from Twilio."
        delete_CkHttp $http
        delete_CkStringBuilder $url
        delete_CkStringBuilder $mediaBase
        delete_CkHttp $download
        delete_CkHttpResponse $fileResp
        delete_CkStringBuilder $fileUrl
        delete_CkStringBuilder $filename
        delete_CkStringBuilder $mediaSid
        delete_CkHttpResponse $resp
        delete_CkJsonObject $reply
        exit
    }

    if {[CkJsonObject_JsonTypeOf $reply "media_list"] != 4} then {
        puts "Expected an array of media items."
        delete_CkHttp $http
        delete_CkStringBuilder $url
        delete_CkStringBuilder $mediaBase
        delete_CkHttp $download
        delete_CkHttpResponse $fileResp
        delete_CkStringBuilder $fileUrl
        delete_CkStringBuilder $filename
        delete_CkStringBuilder $mediaSid
        delete_CkHttpResponse $resp
        delete_CkJsonObject $reply
        exit
    }

    set count [CkJsonObject_SizeOfArray $reply "media_list"]
    set i 0
    while {$i < $count} {
        CkJsonObject_put_I $reply $i
        CkStringBuilder_SetString $mediaSid [CkJsonObject_stringOf $reply "media_list[i].sid"]
        if {[CkStringBuilder_get_Length $mediaSid] == 0} then {
            puts "Media item is missing its SID."
            delete_CkHttp $http
            delete_CkStringBuilder $url
            delete_CkStringBuilder $mediaBase
            delete_CkHttp $download
            delete_CkHttpResponse $fileResp
            delete_CkStringBuilder $fileUrl
            delete_CkStringBuilder $filename
            delete_CkStringBuilder $mediaSid
            delete_CkHttpResponse $resp
            delete_CkJsonObject $reply
            exit
        }

        CkStringBuilder_SetString $fileUrl [CkStringBuilder_getAsString $mediaBase]
        CkStringBuilder_Append $fileUrl "/"
        CkStringBuilder_AppendSb $fileUrl $mediaSid
        set success [CkHttp_HttpNoBody $http "GET" [CkStringBuilder_getAsString $fileUrl] $fileResp]
        if {expr [[CkHttpResponse_get_StatusCode $fileResp] >= 300]  &&  [[CkHttpResponse_get_StatusCode $fileResp] < 400]} then {
            CkStringBuilder_SetString $fileUrl [CkHttpResponse_getHeaderField $fileResp "Location"]
            if {[CkStringBuilder_StartsWith $fileUrl "https://" 0] != 1} then {
                puts "Expected an HTTPS media download URL."
                delete_CkHttp $http
                delete_CkStringBuilder $url
                delete_CkStringBuilder $mediaBase
                delete_CkHttp $download
                delete_CkHttpResponse $fileResp
                delete_CkStringBuilder $fileUrl
                delete_CkStringBuilder $filename
                delete_CkStringBuilder $mediaSid
                delete_CkHttpResponse $resp
                delete_CkJsonObject $reply
                exit
            }

            set success [CkHttp_HttpNoBody $download "GET" [CkStringBuilder_getAsString $fileUrl] $fileResp]
        }

        if {expr [$success != 1]  ||  [[CkHttpResponse_get_StatusCode $fileResp] != 200]} then {
            puts "Media download failed for [CkStringBuilder_getAsString $mediaSid]. HTTP [CkHttpResponse_get_StatusCode $fileResp]"
            delete_CkHttp $http
            delete_CkStringBuilder $url
            delete_CkStringBuilder $mediaBase
            delete_CkHttp $download
            delete_CkHttpResponse $fileResp
            delete_CkStringBuilder $fileUrl
            delete_CkStringBuilder $filename
            delete_CkStringBuilder $mediaSid
            delete_CkHttpResponse $resp
            delete_CkJsonObject $reply
            exit
        }

        CkStringBuilder_SetString $filename "mms-media-"
        CkStringBuilder_AppendInt $filename [expr $saved + 1]
        CkStringBuilder_Append $filename ".bin"
        set success [CkHttpResponse_SaveBodyBinary $fileResp [CkStringBuilder_getAsString $filename]]
        if {$success == 0} then {
            puts [CkHttpResponse_lastErrorText $fileResp]
            delete_CkHttp $http
            delete_CkStringBuilder $url
            delete_CkStringBuilder $mediaBase
            delete_CkHttp $download
            delete_CkHttpResponse $fileResp
            delete_CkStringBuilder $fileUrl
            delete_CkStringBuilder $filename
            delete_CkStringBuilder $mediaSid
            delete_CkHttpResponse $resp
            delete_CkJsonObject $reply
            exit
        }

        puts [CkStringBuilder_getAsString $filename]  [CkStringBuilder_getAsString $mediaSid]  [CkJsonObject_stringOf $reply {media_list[i].content_type}]
        set saved [expr $saved + 1]
        set i [expr $i + 1]
    }
    if {[CkJsonObject_IsNullOf $reply "next_page_uri"] == 1} then {
        set more 0
    }     else {
        CkStringBuilder_SetString $url [CkJsonObject_stringOf $reply "next_page_uri"]
        if {[CkStringBuilder_StartsWith $url "/2010-04-01/Accounts/" 1] != 1} then {
            puts "Expected a Twilio relative next-page URI."
            delete_CkHttp $http
            delete_CkStringBuilder $url
            delete_CkStringBuilder $mediaBase
            delete_CkHttp $download
            delete_CkHttpResponse $fileResp
            delete_CkStringBuilder $fileUrl
            delete_CkStringBuilder $filename
            delete_CkStringBuilder $mediaSid
            delete_CkHttpResponse $resp
            delete_CkJsonObject $reply
            exit
        }

        CkStringBuilder_Prepend $url "https://api.twilio.com"
    }

}
puts "Media files saved: $saved"

delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkStringBuilder $mediaBase
delete_CkHttp $download
delete_CkHttpResponse $fileResp
delete_CkStringBuilder $fileUrl
delete_CkStringBuilder $filename
delete_CkStringBuilder $mediaSid
delete_CkHttpResponse $resp
delete_CkJsonObject $reply