Zig

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.

Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

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

    const http = try chilkat.Http.init();
    defer http.deinit();

    // 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.setLogin("TWILIO_ACCOUNT_SID");
    http.setPassword("TWILIO_AUTH_TOKEN");

    const req = try chilkat.HttpRequest.init();
    defer req.deinit();
    req.setHttpVerb("POST");
    req.setPath("/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json");
    req.setContentType("application/x-www-form-urlencoded");
    req.addParam("From", "+15005550006");
    req.addParam("Body", "body");
    req.addParam("To", "+15005551212");
    req.addParam("MediaUrl", "https://www.chilkatsoft.com/images/starfish.jpg");

    const resp = try chilkat.HttpResponse.init();
    defer resp.deinit();
    http.httpReq("https://api.twilio.com/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json", req, resp) catch {
        std.debug.print("{s}\n", .{try http.getLastErrorText(alloc)});
        return;
    };

    const sb_response_body = try chilkat.StringBuilder.init();
    defer sb_response_body.deinit();
    resp.getBodySb(sb_response_body) catch {};
    const j_resp = try chilkat.JsonObject.init();
    defer j_resp.deinit();
    j_resp.loadSb(sb_response_body) catch {};
    j_resp.setEmitCompact(false);

    std.debug.print("Response Body:\n", .{});
    std.debug.print("{s}\n", .{try j_resp.emit(alloc)});

    // A 201 status code indicates success.
    const resp_status_code = resp.getStatusCode();
    std.debug.print("Response Status Code = {d}\n", .{resp_status_code});
    if (resp_status_code >= 400) {
        std.debug.print("Response Header:\n", .{});
        std.debug.print("{s}\n", .{try resp.getHeader(alloc)});
        std.debug.print("Failed.\n", .{});
        return;
    }

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

    const date_created = try chilkat.DtObj.init();
    defer date_created.deinit();
    const date_updated = try chilkat.DtObj.init();
    defer date_updated.deinit();
    const date_sent = try chilkat.DtObj.init();
    defer date_sent.deinit();

    _ = try j_resp.stringOf(alloc, "sid");
    j_resp.dtOf("date_created", false, date_created) catch {};
    j_resp.dtOf("date_updated", false, date_updated) catch {};
    j_resp.dtOf("date_sent", false, date_sent) catch {};
    _ = try j_resp.stringOf(alloc, "account_sid");
    _ = try j_resp.stringOf(alloc, "to");
    _ = try j_resp.stringOf(alloc, "from");
    _ = try j_resp.stringOf(alloc, "messaging_service_sid");
    _ = try j_resp.stringOf(alloc, "body");
    _ = try j_resp.stringOf(alloc, "status");
    _ = try j_resp.stringOf(alloc, "num_segments");
    _ = try j_resp.stringOf(alloc, "num_media");
    _ = try j_resp.stringOf(alloc, "direction");
    _ = try j_resp.stringOf(alloc, "api_version");
    _ = try j_resp.stringOf(alloc, "price");
    _ = try j_resp.stringOf(alloc, "price_unit");
    _ = try j_resp.stringOf(alloc, "error_code");
    _ = try j_resp.stringOf(alloc, "error_message");
    _ = try j_resp.stringOf(alloc, "uri");
    _ = try j_resp.stringOf(alloc, "subresource_uris.media");
}