Sample code for 30+ languages & platforms
Unicode C Requires Chilkat v11.0.0+

Clickatell One API: Upload and send a WhatsApp PDF

See more Clickatell Examples

Send a local invoice.pdf during the customer’s open WhatsApp service window. Upload the binary PDF for one recipient, then reference the returned fileId in a separate message to the same recipient. The upload and message submission have separate acceptance results.

Clickatell API reference

Chilkat Unicode C Downloads

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

void ChilkatSample(void)
    {
    HCkHttpW http;
    const wchar_t *recipient;
    HCkBinDataW pdf;
    BOOL loaded;
    HCkHttpResponseW upload;
    BOOL uploaded;
    HCkJsonObjectW media;
    BOOL decoded;
    const wchar_t *fileId;
    HCkJsonObjectW body;
    HCkHttpResponseW resp;
    BOOL sent;
    HCkJsonObjectW reply;
    BOOL parsed;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    http = CkHttpW_Create();
    CkHttpW_putRequireSslCertVerify(http,TRUE);
    //  Load the key for this One API integration from your application configuration.
    CkHttpW_SetRequestHeader(http,L"Authorization",L"ONE_API_KEY");
    CkHttpW_SetRequestHeader(http,L"Accept",L"application/json");

    recipient = L"PHONE_NUMBER";
    pdf = CkBinDataW_Create();
    loaded = CkBinDataW_LoadFile(pdf,L"invoice.pdf");
    if (loaded != TRUE) {
        wprintf(L"Could not read invoice.pdf.\n");
        CkHttpW_Dispose(http);
        CkBinDataW_Dispose(pdf);
        return;
    }

    //  Restrict this customer's invoice to that customer's number.
    CkHttpW_SetUrlVar(http,L"recipient",recipient);
    upload = CkHttpResponseW_Create();
    uploaded = CkHttpW_HttpBd(http,L"POST",L"https://platform.clickatell.com/v1/media?fileName=invoice.pdf&to={$recipient}",pdf,L"application/pdf",upload);
    if ((uploaded != TRUE) || (CkHttpResponseW_getStatusCode(upload) != 201)) {
        wprintf(L"PDF upload failed. HTTP status %d\n",CkHttpResponseW_getStatusCode(upload));
        CkHttpW_Dispose(http);
        CkBinDataW_Dispose(pdf);
        CkHttpResponseW_Dispose(upload);
        return;
    }

    media = CkJsonObjectW_Create();
    decoded = CkJsonObjectW_Load(media,CkHttpResponseW_bodyStr(upload));
    if ((decoded != TRUE) || (CkJsonObjectW_BoolOf(media,L"accepted") != TRUE)) {
        wprintf(L"Upload was not accepted: %s\n",CkJsonObjectW_stringOf(media,L"error.description"));
        CkHttpW_Dispose(http);
        CkBinDataW_Dispose(pdf);
        CkHttpResponseW_Dispose(upload);
        CkJsonObjectW_Dispose(media);
        return;
    }

    fileId = CkJsonObjectW_stringOf(media,L"fileId");
    if ((CkJsonObjectW_JsonTypeOf(media,L"fileId") != 1) || (fileId == L"")) {
        wprintf(L"Upload returned no file ID.\n");
        CkHttpW_Dispose(http);
        CkBinDataW_Dispose(pdf);
        CkHttpResponseW_Dispose(upload);
        CkJsonObjectW_Dispose(media);
        return;
    }

    body = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(body,L"messages[0].channel",L"whatsapp");
    CkJsonObjectW_UpdateString(body,L"messages[0].to",recipient);
    CkJsonObjectW_UpdateString(body,L"messages[0].media.fileId",fileId);
    CkJsonObjectW_UpdateString(body,L"messages[0].media.contentType",L"application/pdf");
    CkJsonObjectW_UpdateString(body,L"messages[0].media.fileName",L"invoice.pdf");

    resp = CkHttpResponseW_Create();
    sent = CkHttpW_HttpJson(http,L"POST",L"https://platform.clickatell.com/v1/message",body,L"application/json",resp);
    if (CkHttpResponseW_getStatusCode(resp) == 0) {
        wprintf(L"No HTTP response. Check the message report before resending.\n");
        CkHttpW_Dispose(http);
        CkBinDataW_Dispose(pdf);
        CkHttpResponseW_Dispose(upload);
        CkJsonObjectW_Dispose(media);
        CkJsonObjectW_Dispose(body);
        CkHttpResponseW_Dispose(resp);
        return;
    }

    reply = CkJsonObjectW_Create();
    parsed = CkJsonObjectW_Load(reply,CkHttpResponseW_bodyStr(resp));
    if ((sent != TRUE) || (CkHttpResponseW_getStatusCode(resp) != 202)) {
        wprintf(L"Send returned HTTP %d\n",CkHttpResponseW_getStatusCode(resp));
        if (CkJsonObjectW_HasMember(reply,L"error.description") == TRUE) {
            wprintf(L"%s\n",CkJsonObjectW_stringOf(reply,L"error.description"));
        }

        CkHttpW_Dispose(http);
        CkBinDataW_Dispose(pdf);
        CkHttpResponseW_Dispose(upload);
        CkJsonObjectW_Dispose(media);
        CkJsonObjectW_Dispose(body);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    if (CkJsonObjectW_HasMember(reply,L"error.code") == TRUE) {
        if (CkJsonObjectW_IsNullOf(reply,L"error.code") != TRUE) {
            wprintf(L"Submission error %s  %s\n",CkJsonObjectW_stringOf(reply,L"error.code"),CkJsonObjectW_stringOf(reply,L"error.description"));
            CkHttpW_Dispose(http);
            CkBinDataW_Dispose(pdf);
            CkHttpResponseW_Dispose(upload);
            CkJsonObjectW_Dispose(media);
            CkJsonObjectW_Dispose(body);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            return;
        }

    }

    //  HTTP acceptance and the recipient result are separate checks.
    if ((parsed != TRUE) || (CkJsonObjectW_JsonTypeOf(reply,L"messages[0].accepted") != 5)) {
        wprintf(L"Missing recipient result. Check the message report.\n");
        CkHttpW_Dispose(http);
        CkBinDataW_Dispose(pdf);
        CkHttpResponseW_Dispose(upload);
        CkJsonObjectW_Dispose(media);
        CkJsonObjectW_Dispose(body);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    if (CkJsonObjectW_BoolOf(reply,L"messages[0].accepted") != TRUE) {
        wprintf(L"Message rejected: %s  %s\n",CkJsonObjectW_stringOf(reply,L"messages[0].error.code"),CkJsonObjectW_stringOf(reply,L"messages[0].error.description"));
        CkHttpW_Dispose(http);
        CkBinDataW_Dispose(pdf);
        CkHttpResponseW_Dispose(upload);
        CkJsonObjectW_Dispose(media);
        CkJsonObjectW_Dispose(body);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    if (CkJsonObjectW_JsonTypeOf(reply,L"messages[0].apiMessageId") != 1) {
        wprintf(L"Accepted without a message ID. Check the message report.\n");
        CkHttpW_Dispose(http);
        CkBinDataW_Dispose(pdf);
        CkHttpResponseW_Dispose(upload);
        CkJsonObjectW_Dispose(media);
        CkJsonObjectW_Dispose(body);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    wprintf(L"Accepted. Message ID: %s\n",CkJsonObjectW_stringOf(reply,L"messages[0].apiMessageId"));


    CkHttpW_Dispose(http);
    CkBinDataW_Dispose(pdf);
    CkHttpResponseW_Dispose(upload);
    CkJsonObjectW_Dispose(media);
    CkJsonObjectW_Dispose(body);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);

    }