Sample code for 30+ languages & platforms
Delphi DLL 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 Delphi DLL Downloads

Delphi DLL
var
http: HCkHttp;
recipient: PWideChar;
pdf: HCkBinData;
loaded: Boolean;
upload: HCkHttpResponse;
uploaded: Boolean;
media: HCkJsonObject;
decoded: Boolean;
fileId: PWideChar;
body: HCkJsonObject;
resp: HCkHttpResponse;
sent: Boolean;
reply: HCkJsonObject;
parsed: Boolean;

begin
//  Assumes Chilkat is unlocked. See Global Unlock Sample.
http := CkHttp_Create();
CkHttp_putRequireSslCertVerify(http,True);
//  Load the key for this One API integration from your application configuration.
CkHttp_SetRequestHeader(http,'Authorization','ONE_API_KEY');
CkHttp_SetRequestHeader(http,'Accept','application/json');

recipient := 'PHONE_NUMBER';
pdf := CkBinData_Create();
loaded := CkBinData_LoadFile(pdf,'invoice.pdf');
if (loaded <> True) then
  begin
    Memo1.Lines.Add('Could not read invoice.pdf.');
    Exit;
  end;
//  Restrict this customer's invoice to that customer's number.
CkHttp_SetUrlVar(http,'recipient',recipient);
upload := CkHttpResponse_Create();
uploaded := CkHttp_HttpBd(http,'POST','https://platform.clickatell.com/v1/media?fileName=invoice.pdf&to={$recipient}',pdf,'application/pdf',upload);
if ((uploaded <> True) or (CkHttpResponse_getStatusCode(upload) <> 201)) then
  begin
    Memo1.Lines.Add('PDF upload failed. HTTP status ' + IntToStr(CkHttpResponse_getStatusCode(upload)));
    Exit;
  end;
media := CkJsonObject_Create();
decoded := CkJsonObject_Load(media,CkHttpResponse__bodyStr(upload));
if ((decoded <> True) or (CkJsonObject_BoolOf(media,'accepted') <> True)) then
  begin
    Memo1.Lines.Add('Upload was not accepted: ' + CkJsonObject__stringOf(media,'error.description'));
    Exit;
  end;
fileId := CkJsonObject__stringOf(media,'fileId');
if ((CkJsonObject_JsonTypeOf(media,'fileId') <> 1) or (fileId = '')) then
  begin
    Memo1.Lines.Add('Upload returned no file ID.');
    Exit;
  end;
body := CkJsonObject_Create();
CkJsonObject_UpdateString(body,'messages[0].channel','whatsapp');
CkJsonObject_UpdateString(body,'messages[0].to',recipient);
CkJsonObject_UpdateString(body,'messages[0].media.fileId',fileId);
CkJsonObject_UpdateString(body,'messages[0].media.contentType','application/pdf');
CkJsonObject_UpdateString(body,'messages[0].media.fileName','invoice.pdf');

resp := CkHttpResponse_Create();
sent := CkHttp_HttpJson(http,'POST','https://platform.clickatell.com/v1/message',body,'application/json',resp);
if (CkHttpResponse_getStatusCode(resp) = 0) then
  begin
    Memo1.Lines.Add('No HTTP response. Check the message report before resending.');
    Exit;
  end;
reply := CkJsonObject_Create();
parsed := CkJsonObject_Load(reply,CkHttpResponse__bodyStr(resp));
if ((sent <> True) or (CkHttpResponse_getStatusCode(resp) <> 202)) then
  begin
    Memo1.Lines.Add('Send returned HTTP ' + IntToStr(CkHttpResponse_getStatusCode(resp)));
    if (CkJsonObject_HasMember(reply,'error.description') = True) then
      begin
        Memo1.Lines.Add(CkJsonObject__stringOf(reply,'error.description'));
      end;
    Exit;
  end;
if (CkJsonObject_HasMember(reply,'error.code') = True) then
  begin
    if (CkJsonObject_IsNullOf(reply,'error.code') <> True) then
      begin
        Memo1.Lines.Add('Submission error ' + CkJsonObject__stringOf(reply,'error.code') + '  ' + CkJsonObject__stringOf(reply,'error.description'));
        Exit;
      end;
  end;
//  HTTP acceptance and the recipient result are separate checks.
if ((parsed <> True) or (CkJsonObject_JsonTypeOf(reply,'messages[0].accepted') <> 5)) then
  begin
    Memo1.Lines.Add('Missing recipient result. Check the message report.');
    Exit;
  end;
if (CkJsonObject_BoolOf(reply,'messages[0].accepted') <> True) then
  begin
    Memo1.Lines.Add('Message rejected: ' + CkJsonObject__stringOf(reply,'messages[0].error.code') + '  ' + CkJsonObject__stringOf(reply,'messages[0].error.description'));
    Exit;
  end;
if (CkJsonObject_JsonTypeOf(reply,'messages[0].apiMessageId') <> 1) then
  begin
    Memo1.Lines.Add('Accepted without a message ID. Check the message report.');
    Exit;
  end;
Memo1.Lines.Add('Accepted. Message ID: ' + CkJsonObject__stringOf(reply,'messages[0].apiMessageId'));

CkHttp_Dispose(http);
CkBinData_Dispose(pdf);
CkHttpResponse_Dispose(upload);
CkJsonObject_Dispose(media);
CkJsonObject_Dispose(body);
CkHttpResponse_Dispose(resp);
CkJsonObject_Dispose(reply);