Delphi DLL Requires Chilkat v11.0.0+
Delphi DLL
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.
Chilkat Delphi DLL Downloads
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);