(PureBasic) Twilio Send MMS (using Chilkat HTTP)

Send an outgoing MMS message. The only difference with MMS (as compared with SMS) is that a MediaUrl parameter is added to the POST. This means your image must be accessible on the web -- the Twilio server must be able to download the image from the URL you provide to include it in the MMS mesage to be sent.

Also, see Twilio MMS for more information about MMS.

For more information, see https://support.twilio.com/hc/en-us/articles/223179808-Sending-and-receiving-MMS-messages

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkJsonObject.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkDtObj.pb"
IncludeFile "CkHttpRequest.pb"
IncludeFile "CkHttpResponse.pb"
IncludeFile "CkStringBuilder.pb"

Procedure ChilkatExample()

    ; This example assumes the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success.i

    ; Implements the following CURL command:

    ; (See information about using test credentials and phone numbers:  https://www.twilio.com/docs/iam/test-credentials)

    ; curl -X POST https://api.twilio.com/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json \
    ; --data-urlencode "From=+15005550006" \
    ; --data-urlencode "Body=body" \
    ; --data-urlencode "To=+15005551212" \
    ; -u TWILIO_ACCOUNT_SID:TWILIO_AUTH_TOKEN

    ; Use the following online tool to generate HTTP code from a CURL command
    ; Convert a cURL Command to HTTP Source Code

    CkHttp::setCkLogin(http, "TWILIO_ACCOUNT_SID")
    CkHttp::setCkPassword(http, "TWILIO_AUTH_TOKEN")

    req.i = CkHttpRequest::ckCreate()
    If req.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttpRequest::setCkHttpVerb(req, "POST")
    CkHttpRequest::setCkPath(req, "/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json")
    CkHttpRequest::setCkContentType(req, "application/x-www-form-urlencoded")
    CkHttpRequest::ckAddParam(req,"From","+15005550006")
    CkHttpRequest::ckAddParam(req,"Body","body")
    CkHttpRequest::ckAddParam(req,"To","+15005551212")
    CkHttpRequest::ckAddParam(req,"MediaUrl","https://www.chilkatsoft.com/images/starfish.jpg")

    resp.i = CkHttp::ckPostUrlEncoded(http,"https://api.twilio.com/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json",req)
    If CkHttp::ckLastMethodSuccess(http) = 0
        Debug CkHttp::ckLastErrorText(http)
        CkHttp::ckDispose(http)
        CkHttpRequest::ckDispose(req)
        ProcedureReturn
    EndIf

    sbResponseBody.i = CkStringBuilder::ckCreate()
    If sbResponseBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttpResponse::ckGetBodySb(resp,sbResponseBody)
    jResp.i = CkJsonObject::ckCreate()
    If jResp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckLoadSb(jResp,sbResponseBody)
    CkJsonObject::setCkEmitCompact(jResp, 0)

    Debug "Response Body:"
    Debug CkJsonObject::ckEmit(jResp)

    ; A 201 status code indicates success.
    respStatusCode.i = CkHttpResponse::ckStatusCode(resp)
    Debug "Response Status Code = " + Str(respStatusCode)
    If respStatusCode >= 400
        Debug "Response Header:"
        Debug CkHttpResponse::ckHeader(resp)
        Debug "Failed."
        CkHttpResponse::ckDispose(resp)

        CkHttp::ckDispose(http)
        CkHttpRequest::ckDispose(req)
        CkStringBuilder::ckDispose(sbResponseBody)
        CkJsonObject::ckDispose(jResp)
        ProcedureReturn
    EndIf

    CkHttpResponse::ckDispose(resp)

    ; Sample JSON response:
    ; (Sample code for parsing the JSON response is shown below)

    ; {
    ;   "sid": "SM477111c301794f14b11eca5eefd5c350",
    ;   "date_created": "Tue, 18 Aug 2020 15:04:47 +0000",
    ;   "date_updated": "Tue, 18 Aug 2020 15:04:47 +0000",
    ;   "date_sent": null,
    ;   "account_sid": "AC2e9b6bc0f51133df24926f07341d3824",
    ;   "to": "+15005551212",
    ;   "from": "+15005550006",
    ;   "messaging_service_sid": null,
    ;   "body": "body",
    ;   "status": "queued",
    ;   "num_segments": "1",
    ;   "num_media": "0",
    ;   "direction": "outbound-api",
    ;   "api_version": "2010-04-01",
    ;   "price": null,
    ;   "price_unit": "USD",
    ;   "error_code": null,
    ;   "error_message": null,
    ;   "uri": "/2010-04-01/Accounts/AC2e9b6bc0f51133df24926f07341d3824/Messages/SM477111c301794f14b11eca5eefd5c350.json",
    ;   "subresource_uris": {
    ;     "media": "/2010-04-01/Accounts/AC2e9b6bc0f51133df24926f07341d3824/Messages/SM477111c301794f14b11eca5eefd5c350/Media.json"
    ;   }
    ; }

    ; Sample code for parsing the JSON response...
    ; Use the following online tool to generate parsing code from sample JSON:
    ; Generate Parsing Code from JSON

    date_created.i = CkDtObj::ckCreate()
    If date_created.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    date_updated.i = CkDtObj::ckCreate()
    If date_updated.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    date_sent.i = CkDtObj::ckCreate()
    If date_sent.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    sid.s = CkJsonObject::ckStringOf(jResp,"sid")
    CkJsonObject::ckDtOf(jResp,"date_created",0,date_created)
    CkJsonObject::ckDtOf(jResp,"date_updated",0,date_updated)
    CkJsonObject::ckDtOf(jResp,"date_sent",0,date_sent)
    account_sid.s = CkJsonObject::ckStringOf(jResp,"account_sid")
    v_to.s = CkJsonObject::ckStringOf(jResp,"to")
    from.s = CkJsonObject::ckStringOf(jResp,"from")
    messaging_service_sid.s = CkJsonObject::ckStringOf(jResp,"messaging_service_sid")
    body.s = CkJsonObject::ckStringOf(jResp,"body")
    status.s = CkJsonObject::ckStringOf(jResp,"status")
    num_segments.s = CkJsonObject::ckStringOf(jResp,"num_segments")
    num_media.s = CkJsonObject::ckStringOf(jResp,"num_media")
    direction.s = CkJsonObject::ckStringOf(jResp,"direction")
    api_version.s = CkJsonObject::ckStringOf(jResp,"api_version")
    price.s = CkJsonObject::ckStringOf(jResp,"price")
    price_unit.s = CkJsonObject::ckStringOf(jResp,"price_unit")
    error_code.s = CkJsonObject::ckStringOf(jResp,"error_code")
    error_message.s = CkJsonObject::ckStringOf(jResp,"error_message")
    uri.s = CkJsonObject::ckStringOf(jResp,"uri")
    subresource_urisMedia.s = CkJsonObject::ckStringOf(jResp,"subresource_uris.media")


    CkHttp::ckDispose(http)
    CkHttpRequest::ckDispose(req)
    CkStringBuilder::ckDispose(sbResponseBody)
    CkJsonObject::ckDispose(jResp)
    CkDtObj::ckDispose(date_created)
    CkDtObj::ckDispose(date_updated)
    CkDtObj::ckDispose(date_sent)


    ProcedureReturn
EndProcedure