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

Delphi ActiveX
var
http: TChilkatHttp;
recipient: WideString;
pdf: TChilkatBinData;
loaded: Integer;
upload: TChilkatHttpResponse;
uploaded: Integer;
media: TChilkatJsonObject;
decoded: Integer;
fileId: WideString;
body: TChilkatJsonObject;
resp: TChilkatHttpResponse;
sent: Integer;
reply: TChilkatJsonObject;
parsed: Integer;

begin
//  Assumes Chilkat is unlocked. See Global Unlock Sample.
http := TChilkatHttp.Create(Self);
http.RequireSslCertVerify := 1;
//  Load the key for this One API integration from your application configuration.
http.SetRequestHeader('Authorization','ONE_API_KEY');
http.SetRequestHeader('Accept','application/json');

recipient := 'PHONE_NUMBER';
pdf := TChilkatBinData.Create(Self);
loaded := pdf.LoadFile('invoice.pdf');
if (loaded <> 1) then
  begin
    Memo1.Lines.Add('Could not read invoice.pdf.');
    Exit;
  end;
//  Restrict this customer's invoice to that customer's number.
http.SetUrlVar('recipient',recipient);
upload := TChilkatHttpResponse.Create(Self);
uploaded := http.HttpBd('POST','https://platform.clickatell.com/v1/media?fileName=invoice.pdf&to={$recipient}',pdf.ControlInterface,'application/pdf',upload.ControlInterface);
if ((uploaded <> 1) or (upload.StatusCode <> 201)) then
  begin
    Memo1.Lines.Add('PDF upload failed. HTTP status ' + IntToStr(upload.StatusCode));
    Exit;
  end;
media := TChilkatJsonObject.Create(Self);
decoded := media.Load(upload.BodyStr);
if ((decoded <> 1) or (media.BoolOf('accepted') <> 1)) then
  begin
    Memo1.Lines.Add('Upload was not accepted: ' + media.StringOf('error.description'));
    Exit;
  end;
fileId := media.StringOf('fileId');
if ((media.JsonTypeOf('fileId') <> 1) or (fileId = '')) then
  begin
    Memo1.Lines.Add('Upload returned no file ID.');
    Exit;
  end;
body := TChilkatJsonObject.Create(Self);
body.UpdateString('messages[0].channel','whatsapp');
body.UpdateString('messages[0].to',recipient);
body.UpdateString('messages[0].media.fileId',fileId);
body.UpdateString('messages[0].media.contentType','application/pdf');
body.UpdateString('messages[0].media.fileName','invoice.pdf');

resp := TChilkatHttpResponse.Create(Self);
sent := http.HttpJson('POST','https://platform.clickatell.com/v1/message',body.ControlInterface,'application/json',resp.ControlInterface);
if (resp.StatusCode = 0) then
  begin
    Memo1.Lines.Add('No HTTP response. Check the message report before resending.');
    Exit;
  end;
reply := TChilkatJsonObject.Create(Self);
parsed := reply.Load(resp.BodyStr);
if ((sent <> 1) or (resp.StatusCode <> 202)) then
  begin
    Memo1.Lines.Add('Send returned HTTP ' + IntToStr(resp.StatusCode));
    if (reply.HasMember('error.description') = 1) then
      begin
        Memo1.Lines.Add(reply.StringOf('error.description'));
      end;
    Exit;
  end;
if (reply.HasMember('error.code') = 1) then
  begin
    if (reply.IsNullOf('error.code') <> 1) then
      begin
        Memo1.Lines.Add('Submission error ' + reply.StringOf('error.code') + '  ' + reply.StringOf('error.description'));
        Exit;
      end;
  end;
//  HTTP acceptance and the recipient result are separate checks.
if ((parsed <> 1) or (reply.JsonTypeOf('messages[0].accepted') <> 5)) then
  begin
    Memo1.Lines.Add('Missing recipient result. Check the message report.');
    Exit;
  end;
if (reply.BoolOf('messages[0].accepted') <> 1) then
  begin
    Memo1.Lines.Add('Message rejected: ' + reply.StringOf('messages[0].error.code') + '  ' + reply.StringOf('messages[0].error.description'));
    Exit;
  end;
if (reply.JsonTypeOf('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: ' + reply.StringOf('messages[0].apiMessageId'));