(Tcl) SimpleTexting - Send MMS Message

Send a multimedia message to an individual contact.

For more information, see https://simpletexting.com/api/docs/#operation/sendMmsPost

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

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

set http [new_CkHttp]

# Implements the following CURL command:

# curl --request POST \
#   --url 'https://app2.simpletexting.com/v1/sendmms?token=YOUR_API_TOKEN&phone=SOME_STRING_VALUE&message=SOME_STRING_VALUE&subject=SOME_STRING_VALUE&mediaUrl=SOME_ARRAY_VALUE' \
#   --header 'accept: application/json' \
#   --header 'content-type: application/x-www-form-urlencoded'

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

CkHttp_SetRequestHeader $http "accept" "application/json"
CkHttp_SetRequestHeader $http "content-type" "application/x-www-form-urlencoded"

set req [new_CkHttpRequest]

CkHttpRequest_AddParam $req "token" "YOUR_API_TOKEN"
CkHttpRequest_AddParam $req "phone" "SOME_10_DIGIT_PHONE_NUMBER"
CkHttpRequest_AddParam $req "message" "Hello: This is a sample MMS message."
CkHttpRequest_AddParam $req "subject" "Starfish"
CkHttpRequest_AddParam $req "mediaUrl" "https://www.chilkatsoft.com/images/starfish.jpg"

CkHttpRequest_AddHeader $req "Accept" "application/json"

# resp is a CkHttpResponse
set resp [CkHttp_PostUrlEncoded $http "https://app2.simpletexting.com/v1/sendmms" $req]
if {[CkHttp_get_LastMethodSuccess $http] == 0} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkHttp $http
    delete_CkHttpRequest $req
    exit
}

set sbResponseBody [new_CkStringBuilder]

CkHttpResponse_GetBodySb $resp $sbResponseBody
set jResp [new_CkJsonObject]

CkJsonObject_LoadSb $jResp $sbResponseBody
CkJsonObject_put_EmitCompact $jResp 0

puts "Response Body:"
puts [CkJsonObject_emit $jResp]

set respStatusCode [CkHttpResponse_get_StatusCode $resp]
puts "Response Status Code = $respStatusCode"
if {$respStatusCode >= 400} then {
    puts "Response Header:"
    puts [CkHttpResponse_header $resp]
    puts "Failed."
    delete_CkHttpResponse $resp

    delete_CkHttp $http
    delete_CkHttpRequest $req
    delete_CkStringBuilder $sbResponseBody
    delete_CkJsonObject $jResp
    exit
}

delete_CkHttpResponse $resp

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

# {
#   "code": 1,
#   "message": "The request succeeded",
#   "smsid": "5bec5b9d0a975a238808ffb2"
# }

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

set code [CkJsonObject_IntOf $jResp "code"]
set message [CkJsonObject_stringOf $jResp "message"]
set smsid [CkJsonObject_stringOf $jResp "smsid"]

delete_CkHttp $http
delete_CkHttpRequest $req
delete_CkStringBuilder $sbResponseBody
delete_CkJsonObject $jResp