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

Delphi ActiveX
var
http: TChilkatHttp;
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');

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

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'));