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

CkPhp
<?php

include("chilkat.php");

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
$http = new CkHttp();
$http->put_RequireSslCertVerify(true);
//  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 = new CkJsonObject();
$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 = new CkHttpResponse();
$sent = $http->HttpJson('POST','https://platform.clickatell.com/v1/message',$body,'application/json',$resp);
if ($resp->get_StatusCode() == 0) {
    print 'No HTTP response. Check the message report before resending.' . "\n";
    exit;
}

$reply = new CkJsonObject();
$parsed = $reply->Load($resp->bodyStr());
if (($sent != true) or ($resp->get_StatusCode() != 202)) {
    print 'Send returned HTTP ' . $resp->get_StatusCode() . "\n";
    if ($reply->HasMember('error.description') == true) {
        print $reply->stringOf('error.description') . "\n";
    }

    exit;
}

if ($reply->HasMember('error.code') == true) {
    if ($reply->IsNullOf('error.code') != true) {
        print 'Submission error ' . $reply->stringOf('error.code') . '  ' . $reply->stringOf('error.description') . "\n";
        exit;
    }

}

//  HTTP acceptance and the recipient result are separate checks.
if (($parsed != true) or ($reply->JsonTypeOf('messages[0].accepted') != 5)) {
    print 'Missing recipient result. Check the message report.' . "\n";
    exit;
}

if ($reply->BoolOf('messages[0].accepted') != true) {
    print 'Message rejected: ' . $reply->stringOf('messages[0].error.code') . '  ' . $reply->stringOf('messages[0].error.description') . "\n";
    exit;
}

if ($reply->JsonTypeOf('messages[0].apiMessageId') != 1) {
    print 'Accepted without a message ID. Check the message report.' . "\n";
    exit;
}

print 'Accepted. Message ID: ' . $reply->stringOf('messages[0].apiMessageId') . "\n";

?>