Loader

Message Status Table

 

Status code

Callbacks; Query Message Response

Description

1

UNKNOWN

Message not found

2

QUEUED

Queued

3

SCHEDULED

Scheduled for later delivery

4

SENT_TO_SUPPLIER

Sent to supplier

5

DEVICE_ACK

Device acknowledged delivery

6

READ

Read receipt

Generic errors (shared by all channels)

20

EXPIRED

Message has expired

21

STOPPED_BY_USER

Message stopped by user

22

STOPPED_BY_ADMIN

Message stopped by admin

23

DELIVERY_FAILURE

Error delivering message

24

EMULATED

Emulated

25

INSUFFICIENT_ACCOUNT_BALANCE

Insufficient account balance

26

VOLUME_LIMIT

Volume limit exceeded

27

VOLUME_LIMIT_DAILY

Daily volume limit exceeded

28

VOLUME_LIMIT_MONTHLY

Monthly volume limit exceeded

29

RECIPIENT_DOES_NOT_EXIST

Recipient does not exist on channel

60

ENCRYPTION_ACCESS_DENIED

Security access denied

61

ENCRYPTION_CONTENT_ERROR

Content decryption failed

Media-related

80

MEDIA_NOT_FOUND

Media not found

81

MEDIA_SIZE_ERROR

Media size error

82

MEDIA_CHECKSUM_FAILURE

Media checksum failure

83

MEDIA_REJECTED_BY_SUPPLIER

Channel supplier rejected media file

84

MEDIA_METADATA_ERROR

Metadata for the media file was not found or does not match the message request

85

MEDIA_ACCESS_ERROR

An access/permissions-related error occurred when handling the media file

SMS-related

100

ROUTING_ERROR

Routing error

WhatsApp-related

130

WHATSAPP_ACCOUNT_PAYMENT_ISSUE

WhatsApp account payment issue

131

WHATSAPP_RE_ENGAGEMENT_REQUIRED

Re-engagement required

132

WHATSAPP_SPAM_RATE_LIMIT_REACHED

Spam rate limit reached

133

WHATSAPP_SERVER_RATE_LIMIT

WhatsApp server rate limit

139

WHATSAPP_EXPERIMENTAL_NUMBER

Non-delivery due to WhatsApp experimental number feature

140

WHATSAPP_TEMPLATE_TEXT_TOO_LONG

Length of the parameters and the template text exceeds the maximum allowed length

141

WHATSAPP_TEMPLATE_FORMAT_MISMATCH

Specified template header format not in the expected format

142

WHATSAPP_TEMPLATE_FORMATTING_POLICY_VIOLATED

Template header parameter formatting not allowed (bold, italic etc).

143

WHATSAPP_TEMPLATE_MEDIA_FORMAT_UNSUPPORTED

Correct media type used in template, but mime type is unsupported.

144

WHATSAPP_PARAMETER_MISSING

Required parameter is missing for this message

145

WHATSAPP_PARAMETER_INVALID

A message parameter contains an invalid value

146

WHATSAPP_PARAMETER_NOT_REQUIRED

A parameter was specified for the message that is not required

147

WHATSAPP_TEMPLATE_INVALID_URL

Invalid hydrated URL received in template message

148

WHATSAPP_TEMPLATE_INVALID_PHONE_NUMBER

Phone number in template message is missing

149

WHATSAPP_TEMPLATE_RECEIVER_NO_BUTTON_SUPPORT

End-user device does not support buttons

 

 

Channels

Find the most up-to-date information about the channels available to communicate with your clients.

SMS

Enable any application, website or system to facilitate local or international one- or two-way SMS communication via an easy one-step integration with our HTTP API.

Documentation
One API

Communicate with your mobile customers via multiple communication channels with a single integration. You can send and receive messages on both WhatsApp and SMS without the overhead of programming individual channels.

Documentation
WhatsApp

As an authorized WhatsApp Business Solution Provider, we assist you in applying for a WhatsApp Business account and number. Integrate with other powerful features available on our platform via our One API.

Documentation

Products

Find the most up-to-date information about the products we offer and how to elevate your engagement with customers.

Chat 2 Pay

Send payment requests to customers via chat for secure, contactless payment experiences.

Documentation
Chat Desk

An easy-to-use web-based application that enables real-time communication with your customers via a single web interface.

Documentation
Chat Flow

A web-based application that allows you to quickly and collaboratively design and deploy conversational experiences across multiple chat applications and connect it to your organization's core functional APIs.

Documentation
Campaign Manager

An online tool that allows you to create a custom SMS campaign within minutes - no coding or developers required.

Documentation

Marketplace

Find the most up-to-date information about Clickatell's Marketplace and how you can utilize it for the distribution and payment acceptance of digital products.

Bank Interfaces API

An explanation of the way Clickatell and banks interact with one another when dealing with purchases. 

Documentation
Transact Result API

Initiates the delivery of the transaction result for a purchase that was made through Clickatell after Clickatell facilitated the dispensing of the product.

Documentation
Reserve and Transact API

Initiates a purchase and fund reservation request to Clickatell.

Documentation
Security Service API

Request authentication tokens to use in all other Clickatell API calls.

Documentation
Transact

A cloud-based platform that allows for the distribution and payment acceptance of multiple digital products.

Documentation
Product Lookup API

Confirm a product's configuration and attributes.

Documentation
In-Flight Transaction Check API

Used prior to a purchase instruction to confirm that no similar transaction is in progress.

Documentation
User Transaction Lookup API

Identify if a new transaction is similar to one of the user's recent transactions so the response details can be used to pre-emptively complete the current transaction details.

Documentation
Customer Account Validation API

Validate a customer's bill payment account number prior to submitting the bill payment purchase request to the vendor.

Documentation
MNO Lookup API

Derive the specific mobile network operator (MNO) for the specified MSISDN.

Documentation
Token Lookup API

Look up tokens/vouchers to present back to the buyer/customer who purchased token-related products via Clickatell's platform.

Documentation
Notifications API

Send notifications to buyer/recipient using different channels.

Documentation
Transaction Lookup API

Used after a purchase to confirm the transaction status.

Documentation
Financial Terms Lookup API

Display the correct fee and settlement amounts as per the contractual agreement for the SKU being purchased.

Documentation
Transact API

Initiates a purchase request to Clickatell.

Documentation

Other Resources

Ask the Community

Visit Stack Overflow to join our community of developers and find the answer you need

Contact Support

Contact our support team and one of our agents will be in touch with you to answer any questions you have