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

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.

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

$recipient = 'PHONE_NUMBER';
$pdf = new CkBinData();
$loaded = $pdf->LoadFile('invoice.pdf');
if ($loaded != true) {
    print 'Could not read invoice.pdf.' . "\n";
    exit;
}

//  Restrict this customer's invoice to that customer's number.
$http->SetUrlVar('recipient',$recipient);
$upload = new CkHttpResponse();
$uploaded = $http->HttpBd('POST','https://platform.clickatell.com/v1/media?fileName=invoice.pdf&to={$recipient}',$pdf,'application/pdf',$upload);
if (($uploaded != true) or ($upload->get_StatusCode() != 201)) {
    print 'PDF upload failed. HTTP status ' . $upload->get_StatusCode() . "\n";
    exit;
}

$media = new CkJsonObject();
$decoded = $media->Load($upload->bodyStr());
if (($decoded != true) or ($media->BoolOf('accepted') != true)) {
    print 'Upload was not accepted: ' . $media->stringOf('error.description') . "\n";
    exit;
}

$fileId = $media->stringOf('fileId');
if (($media->JsonTypeOf('fileId') != 1) or ($fileId == '')) {
    print 'Upload returned no file ID.' . "\n";
    exit;
}

$body = new CkJsonObject();
$body->UpdateString('messages[0].channel','whatsapp');
$body->UpdateString('messages[0].to',$recipient);
$body->UpdateString('messages[0].media.fileId',$fileId);
$body->UpdateString('messages[0].media.contentType','application/pdf');
$body->UpdateString('messages[0].media.fileName','invoice.pdf');

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

?>