Sample code for 30+ languages & platforms
Unicode C

MessageMedia - Send Messages

See more MessageMedia Examples

Submit one or more (up to 100 per request) SMS, MMS, or text to voice messages for delivery.

Chilkat Unicode C Downloads

Unicode C
#include <C_CkHttpW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkHttpResponseW.h>
#include <C_CkStringBuilderW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    HCkJsonObjectW json;
    HCkHttpResponseW resp;
    HCkStringBuilderW sbResponseBody;
    HCkJsonObjectW jResp;
    int respStatusCode;
    const wchar_t *message_id;
    const wchar_t *callback_url;
    const wchar_t *status;
    const wchar_t *content;
    const wchar_t *destination_number;
    BOOL delivery_report;
    const wchar_t *format;
    const wchar_t *message_expiry_timestamp;
    const wchar_t *MyKey;
    const wchar_t *AnotherKey;
    const wchar_t *scheduled;
    const wchar_t *source_number;
    const wchar_t *source_number_type;
    int i;
    int count_i;

    success = FALSE;

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

    http = CkHttpW_Create();

    // Implements the following CURL command:

    // curl --request POST \
    //      --header "Content-Type: application/json" \
    //      --header "Accept: application/json" \
    //      --data-binary "{
    //     \"messages\": [
    //         {
    //             \"callback_url\": \"https://my.callback.url.com\",
    //             \"content\": \"My first message\",
    //             \"destination_number\": \"+61491570156\",
    //             \"delivery_report\": true,
    //             \"format\": \"SMS\",
    //             \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",
    //             \"metadata\": {
    //                 \"myKey\": \"myValue\",
    //                 \"anotherKey\": \"anotherValue\"
    //             },
    //             \"scheduled\": \"2016-11-03T11:49:02.807Z\",
    //             \"source_number\": \"+61491570157\",
    //             \"source_number_type\": \"INTERNATIONAL\"
    //         },
    //         {
    //             \"callback_url\": \"https://my.callback.url.com\",
    //             \"content\": \"My second message\",
    //             \"destination_number\": \"+61491570158\",
    //             \"delivery_report\": true,
    //             \"format\": \"MMS\",
    //             \"subject\": \"This is an MMS message\",
    //             \"media\": [ \"https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg\" ],
    //             \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",
    //             \"metadata\": {
    //                 \"myKey\": \"myValue\",
    //                 \"anotherKey\": \"anotherValue\"
    //             },
    //             \"scheduled\": \"2016-11-03T11:49:02.807Z\",
    //             \"source_number\": \"+61491570159\",
    //             \"source_number_type\": \"INTERNATIONAL\"
    //         }
    //     ]
    // }" \
    // https://private-anon-ecbaffbc28-messages32.apiary-mock.com/v1/messages

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

    // Use this online tool to generate code from sample JSON:
    // Generate Code to Create JSON

    // The following JSON is sent in the request body.

    // {
    //   "messages": [
    //     {
    //       "callback_url": "https://my.callback.url.com",
    //       "content": "My first message",
    //       "destination_number": "+61491570156",
    //       "delivery_report": true,
    //       "format": "SMS",
    //       "message_expiry_timestamp": "2016-11-03T11:49:02.807Z",
    //       "metadata": {
    //         "myKey": "myValue",
    //         "anotherKey": "anotherValue"
    //       },
    //       "scheduled": "2016-11-03T11:49:02.807Z",
    //       "source_number": "+61491570157",
    //       "source_number_type": "INTERNATIONAL"
    //     },
    //     {
    //       "callback_url": "https://my.callback.url.com",
    //       "content": "My second message",
    //       "destination_number": "+61491570158",
    //       "delivery_report": true,
    //       "format": "MMS",
    //       "subject": "This is an MMS message",
    //       "media": [
    //         "https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg"
    //       ],
    //       "message_expiry_timestamp": "2016-11-03T11:49:02.807Z",
    //       "metadata": {
    //         "myKey": "myValue",
    //         "anotherKey": "anotherValue"
    //       },
    //       "scheduled": "2016-11-03T11:49:02.807Z",
    //       "source_number": "+61491570159",
    //       "source_number_type": "INTERNATIONAL"
    //     }
    //   ]
    // }

    json = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(json,L"messages[0].callback_url",L"https://my.callback.url.com");
    CkJsonObjectW_UpdateString(json,L"messages[0].content",L"My first message");
    CkJsonObjectW_UpdateString(json,L"messages[0].destination_number",L"+61491570156");
    CkJsonObjectW_UpdateBool(json,L"messages[0].delivery_report",TRUE);
    CkJsonObjectW_UpdateString(json,L"messages[0].format",L"SMS");
    CkJsonObjectW_UpdateString(json,L"messages[0].message_expiry_timestamp",L"2016-11-03T11:49:02.807Z");
    CkJsonObjectW_UpdateString(json,L"messages[0].metadata.myKey",L"myValue");
    CkJsonObjectW_UpdateString(json,L"messages[0].metadata.anotherKey",L"anotherValue");
    CkJsonObjectW_UpdateString(json,L"messages[0].scheduled",L"2016-11-03T11:49:02.807Z");
    CkJsonObjectW_UpdateString(json,L"messages[0].source_number",L"+61491570157");
    CkJsonObjectW_UpdateString(json,L"messages[0].source_number_type",L"INTERNATIONAL");
    CkJsonObjectW_UpdateString(json,L"messages[1].callback_url",L"https://my.callback.url.com");
    CkJsonObjectW_UpdateString(json,L"messages[1].content",L"My second message");
    CkJsonObjectW_UpdateString(json,L"messages[1].destination_number",L"+61491570158");
    CkJsonObjectW_UpdateBool(json,L"messages[1].delivery_report",TRUE);
    CkJsonObjectW_UpdateString(json,L"messages[1].format",L"MMS");
    CkJsonObjectW_UpdateString(json,L"messages[1].subject",L"This is an MMS message");
    CkJsonObjectW_UpdateString(json,L"messages[1].media[0]",L"https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg");
    CkJsonObjectW_UpdateString(json,L"messages[1].message_expiry_timestamp",L"2016-11-03T11:49:02.807Z");
    CkJsonObjectW_UpdateString(json,L"messages[1].metadata.myKey",L"myValue");
    CkJsonObjectW_UpdateString(json,L"messages[1].metadata.anotherKey",L"anotherValue");
    CkJsonObjectW_UpdateString(json,L"messages[1].scheduled",L"2016-11-03T11:49:02.807Z");
    CkJsonObjectW_UpdateString(json,L"messages[1].source_number",L"+61491570159");
    CkJsonObjectW_UpdateString(json,L"messages[1].source_number_type",L"INTERNATIONAL");

    CkHttpW_SetRequestHeader(http,L"Content-Type",L"application/json");
    CkHttpW_SetRequestHeader(http,L"Accept",L"application/json");

    resp = CkHttpResponseW_Create();
    success = CkHttpW_HttpJson(http,L"POST",L"https://private-anon-ecbaffbc28-messages32.apiary-mock.com/v1/messages",json,L"application/json",resp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkHttpW_Dispose(http);
        CkJsonObjectW_Dispose(json);
        CkHttpResponseW_Dispose(resp);
        return;
    }

    sbResponseBody = CkStringBuilderW_Create();
    CkHttpResponseW_GetBodySb(resp,sbResponseBody);

    jResp = CkJsonObjectW_Create();
    CkJsonObjectW_LoadSb(jResp,sbResponseBody);
    CkJsonObjectW_putEmitCompact(jResp,FALSE);

    wprintf(L"Response Body:\n");
    wprintf(L"%s\n",CkJsonObjectW_emit(jResp));

    respStatusCode = CkHttpResponseW_getStatusCode(resp);
    wprintf(L"Response Status Code = %d\n",respStatusCode);
    if (respStatusCode >= 400) {
        wprintf(L"Response Header:\n");
        wprintf(L"%s\n",CkHttpResponseW_header(resp));
        wprintf(L"Failed.\n");
        CkHttpW_Dispose(http);
        CkJsonObjectW_Dispose(json);
        CkHttpResponseW_Dispose(resp);
        CkStringBuilderW_Dispose(sbResponseBody);
        CkJsonObjectW_Dispose(jResp);
        return;
    }

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

    // {
    //   "messages": [
    //     {
    //       "message_id": "04fe9a97-a579-43c5-bb1a-58ed29bf0a6a",
    //       "callback_url": "https://my.url.com",
    //       "status": "delivered",
    //       "content": "My first message",
    //       "destination_number": "+61491570156",
    //       "delivery_report": true,
    //       "format": "SMS",
    //       "message_expiry_timestamp": "2016-11-03T11:49:02.807Z",
    //       "metadata": {
    //         "myKey": "myValue",
    //         "anotherKey": "anotherValue"
    //       },
    //       "scheduled": "2016-11-03T11:49:02.807Z",
    //       "source_number": "+61491570157",
    //       "source_number_type": "INTERNATIONAL"
    //     }
    //   ]
    // }

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

    // Chilkat functions returning "const char *" return a pointer to temporary internal memory owned and managed by Chilkat.
    // See this example explaining how this memory should be used: const char * functions.

    i = 0;
    count_i = CkJsonObjectW_SizeOfArray(jResp,L"messages");
    while (i < count_i) {
        CkJsonObjectW_putI(jResp,i);
        message_id = CkJsonObjectW_stringOf(jResp,L"messages[i].message_id");
        callback_url = CkJsonObjectW_stringOf(jResp,L"messages[i].callback_url");
        status = CkJsonObjectW_stringOf(jResp,L"messages[i].status");
        content = CkJsonObjectW_stringOf(jResp,L"messages[i].content");
        destination_number = CkJsonObjectW_stringOf(jResp,L"messages[i].destination_number");
        delivery_report = CkJsonObjectW_BoolOf(jResp,L"messages[i].delivery_report");
        format = CkJsonObjectW_stringOf(jResp,L"messages[i].format");
        message_expiry_timestamp = CkJsonObjectW_stringOf(jResp,L"messages[i].message_expiry_timestamp");
        MyKey = CkJsonObjectW_stringOf(jResp,L"messages[i].metadata.myKey");
        AnotherKey = CkJsonObjectW_stringOf(jResp,L"messages[i].metadata.anotherKey");
        scheduled = CkJsonObjectW_stringOf(jResp,L"messages[i].scheduled");
        source_number = CkJsonObjectW_stringOf(jResp,L"messages[i].source_number");
        source_number_type = CkJsonObjectW_stringOf(jResp,L"messages[i].source_number_type");
        i = i + 1;
    }



    CkHttpW_Dispose(http);
    CkJsonObjectW_Dispose(json);
    CkHttpResponseW_Dispose(resp);
    CkStringBuilderW_Dispose(sbResponseBody);
    CkJsonObjectW_Dispose(jResp);

    }