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

PureBasic
IncludeFile "CkHttpResponse.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkJsonObject.pb"

Procedure ChilkatExample()

    ;  Assumes Chilkat is unlocked. See Global Unlock Sample.
    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttp::setCkRequireSslCertVerify(http, 1)
    ;  Load the key for this One API integration from your application configuration.
    CkHttp::ckSetRequestHeader(http,"Authorization","ONE_API_KEY")
    CkHttp::ckSetRequestHeader(http,"Accept","application/json")

    body.i = CkJsonObject::ckCreate()
    If body.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckUpdateString(body,"messages[0].channel","whatsapp")
    CkJsonObject::ckUpdateString(body,"messages[0].to","PHONE_NUMBER")
    CkJsonObject::ckUpdateString(body,"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.
    CkJsonObject::ckUpdateString(body,"messages[0].button.items[0].type","reply")
    CkJsonObject::ckUpdateString(body,"messages[0].button.items[0].title","Confirm")
    CkJsonObject::ckUpdateString(body,"messages[0].button.items[0].postbackData","appt-1042-confirm")
    CkJsonObject::ckUpdateString(body,"messages[0].button.items[1].type","reply")
    CkJsonObject::ckUpdateString(body,"messages[0].button.items[1].title","Reschedule")
    CkJsonObject::ckUpdateString(body,"messages[0].button.items[1].postbackData","appt-1042-reschedule")

    resp.i = CkHttpResponse::ckCreate()
    If resp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    sent.i = CkHttp::ckHttpJson(http,"POST","https://platform.clickatell.com/v1/message",body,"application/json",resp)
    If CkHttpResponse::ckStatusCode(resp) = 0
        Debug "No HTTP response. Check the message report before resending."
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(body)
        CkHttpResponse::ckDispose(resp)
        ProcedureReturn
    EndIf

    reply.i = CkJsonObject::ckCreate()
    If reply.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    parsed.i = CkJsonObject::ckLoad(reply,CkHttpResponse::ckBodyStr(resp))
    If (sent <> 1) OR (CkHttpResponse::ckStatusCode(resp) <> 202)
        Debug "Send returned HTTP " + Str(CkHttpResponse::ckStatusCode(resp))
        If CkJsonObject::ckHasMember(reply,"error.description") = 1
            Debug CkJsonObject::ckStringOf(reply,"error.description")
        EndIf

        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(body)
        CkHttpResponse::ckDispose(resp)
        CkJsonObject::ckDispose(reply)
        ProcedureReturn
    EndIf

    If CkJsonObject::ckHasMember(reply,"error.code") = 1
        If CkJsonObject::ckIsNullOf(reply,"error.code") <> 1
            Debug "Submission error " + CkJsonObject::ckStringOf(reply,"error.code") + "  " + CkJsonObject::ckStringOf(reply,"error.description")
            CkHttp::ckDispose(http)
            CkJsonObject::ckDispose(body)
            CkHttpResponse::ckDispose(resp)
            CkJsonObject::ckDispose(reply)
            ProcedureReturn
        EndIf

    EndIf

    ;  HTTP acceptance and the recipient result are separate checks.
    If (parsed <> 1) OR (CkJsonObject::ckJsonTypeOf(reply,"messages[0].accepted") <> 5)
        Debug "Missing recipient result. Check the message report."
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(body)
        CkHttpResponse::ckDispose(resp)
        CkJsonObject::ckDispose(reply)
        ProcedureReturn
    EndIf

    If CkJsonObject::ckBoolOf(reply,"messages[0].accepted") <> 1
        Debug "Message rejected: " + CkJsonObject::ckStringOf(reply,"messages[0].error.code") + "  " + CkJsonObject::ckStringOf(reply,"messages[0].error.description")
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(body)
        CkHttpResponse::ckDispose(resp)
        CkJsonObject::ckDispose(reply)
        ProcedureReturn
    EndIf

    If CkJsonObject::ckJsonTypeOf(reply,"messages[0].apiMessageId") <> 1
        Debug "Accepted without a message ID. Check the message report."
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(body)
        CkHttpResponse::ckDispose(resp)
        CkJsonObject::ckDispose(reply)
        ProcedureReturn
    EndIf

    Debug "Accepted. Message ID: " + CkJsonObject::ckStringOf(reply,"messages[0].apiMessageId")


    CkHttp::ckDispose(http)
    CkJsonObject::ckDispose(body)
    CkHttpResponse::ckDispose(resp)
    CkJsonObject::ckDispose(reply)


    ProcedureReturn
EndProcedure