Lua

Twilio Send MMS (using Chilkat HTTP)

See more Twilio Examples

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.

Lua

local chilkat = require("chilkat")

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

local http = chilkat.Http.new()

-- 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

http.login = "TWILIO_ACCOUNT_SID"
http.password = "TWILIO_AUTH_TOKEN"

local req = chilkat.HttpRequest.new()
req.http_verb = "POST"
req.path = "/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json"
req.content_type = "application/x-www-form-urlencoded"
req:add_param("From", "+15005550006")
req:add_param("Body", "body")
req:add_param("To", "+15005551212")
req:add_param("MediaUrl", "https://www.chilkatsoft.com/images/starfish.jpg")

local resp = chilkat.HttpResponse.new()
local success = http:http_req("https://api.twilio.com/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json", req, resp)
if not success then
    print(http.last_error_text)
    return
end

local sbResponseBody = chilkat.StringBuilder.new()
resp:get_body_sb(sbResponseBody)
local jResp = chilkat.JsonObject.new()
jResp:load_sb(sbResponseBody)
jResp.emit_compact = false

print("Response Body:")
print(jResp:emit())

-- A 201 status code indicates success.
local respStatusCode = resp.status_code
print("Response Status Code = " .. respStatusCode)
if respStatusCode >= 400 then
    print("Response Header:")
    print(resp.header)
    print("Failed.")
    return
end

-- 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

local date_created = chilkat.DtObj.new()
local date_updated = chilkat.DtObj.new()
local date_sent = chilkat.DtObj.new()

local sid = jResp:string_of("sid")
jResp:dt_of("date_created", false, date_created)
jResp:dt_of("date_updated", false, date_updated)
jResp:dt_of("date_sent", false, date_sent)
local account_sid = jResp:string_of("account_sid")
local v_to = jResp:string_of("to")
local from = jResp:string_of("from")
local messaging_service_sid = jResp:string_of("messaging_service_sid")
local body = jResp:string_of("body")
local status = jResp:string_of("status")
local num_segments = jResp:string_of("num_segments")
local num_media = jResp:string_of("num_media")
local direction = jResp:string_of("direction")
local api_version = jResp:string_of("api_version")
local price = jResp:string_of("price")
local price_unit = jResp:string_of("price_unit")
local error_code = jResp:string_of("error_code")
local error_message = jResp:string_of("error_message")
local uri = jResp:string_of("uri")
local subresource_urisMedia = jResp:string_of("subresource_uris.media")