Sample code for 30+ languages & platforms
Delphi DLL Requires Chilkat v11.0.0+

Clickatell One API: Send an approved WhatsApp shipment template

See more Clickatell Examples

Send a business-initiated shipment update, including outside an open customer service window. First approve a template on the WhatsApp integration with two positional body placeholders for the order number and delivery date. Supply its exact name and approved language. The keys 1 and 2 refer to those placeholders in order.

Clickatell API reference

Chilkat Delphi DLL Downloads

Delphi DLL
var
http: HCkHttp;
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');

//  Example approved wording: Order {{1}} is due for delivery on {{2}}.
body := CkJsonObject_Create();
CkJsonObject_UpdateString(body,'messages[0].channel','whatsapp');
CkJsonObject_UpdateString(body,'messages[0].to','PHONE_NUMBER');
CkJsonObject_UpdateString(body,'messages[0].template.templateName','shipment_update');
CkJsonObject_UpdateString(body,'messages[0].template.language','en_US');
CkJsonObject_UpdateString(body,'messages[0].template.body.parameters.1','ORD-1042');
CkJsonObject_UpdateString(body,'messages[0].template.body.parameters.2','March 19');

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);
CkJsonObject_Dispose(body);
CkHttpResponse_Dispose(resp);
CkJsonObject_Dispose(reply);