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

Clickatell One API: Send WhatsApp reply buttons

See more Clickatell Examples

Send an appointment question with Confirm and Reschedule buttons within 24 hours of the customer’s last WhatsApp message. This standalone example ends when Clickatell returns the send result. The response gives the outbound message ID. A customer’s eventual selection is a separate inbound event.

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

$body = new CkJsonObject();
$body->UpdateString('messages[0].channel','whatsapp');
$body->UpdateString('messages[0].to','PHONE_NUMBER');
$body->UpdateString('messages[0].button.body','Can you attend your appointment tomorrow at 10:00?');
//  The visible titles can be translated. Each button has a distinct application ID.
$body->UpdateString('messages[0].button.items[0].type','reply');
$body->UpdateString('messages[0].button.items[0].title','Confirm');
$body->UpdateString('messages[0].button.items[0].postbackData','appt-1042-confirm');
$body->UpdateString('messages[0].button.items[1].type','reply');
$body->UpdateString('messages[0].button.items[1].title','Reschedule');
$body->UpdateString('messages[0].button.items[1].postbackData','appt-1042-reschedule');

$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";

?>