WhatsApp API – How to use the WhatsApp Chat API

 In Article, CloudRail

WhatsApp is together with Facebook Messenger, WeChat, Line and Telegram one of the biggest messaging services. A programmatic access via a WhatsApp API would be a fundamental requirement to create chatbots, support systems or other services which live on top of the Whatsapp ecosystem. Unfortunately, WhatsApp hasn’t released an official API yet. In this article, we talk about what is actually available, unofficial APIs and alternatives. Moreover, this article will constantly be updated with the latest news around the WhatsApp APIs.

WhatsApp API Logo

How to get access to the WhatsApp API?

The answer is, currently there is no official way to get full programmatic access to the Whatsapp ecosystem. There are some libraries available which use an unofficial API to send and receive messages, but this is only limited to a single number. All those libraries are basically hacks which try to act like a standard WhatsApp client which you see on Android or iOS in combination with WhatsApp Web. This is a cool way to run some tests, but for a real chatbot or a sophisticated support system, especially in an enterprise context, it’s not the right choice. Nevertheless, there is one official offering by WhatsApp: the Click to Chat API.

The Click to Chat API

WhatsApp offers a very simple “Click to Chat” API which is basically only a link containing a target number and a prefilled text. Once a user clicks on this link, the WhatsApp client (Android, iOS, Web, etc) opens with a new message to the prefilled number with the prefilled text. This is a cool way to add a fast contact option for example if you want to sell your car. The link needs to contain the phone number in international format and the URL-encoded text. So if you want to send “I’m interested in your car for sale” to +1(555)1234567 the link must be: https://api.whatsapp.com/send?phone=15551234567&text=I'm%20interested%20in%20your%20car%20for%20sale

Will there be an official WhatsApp API in future

Yes, we think so. Facebook already opened the Messenger platform via an API a while ago and since WhatsApp got acquired by Facebook there is hope. Once there are updates, you will read it here and in case there we see an official WhatsApp API, it will definitely become part of the CloudRail Unified Messaging API.

Edit: Today (Jan 18th 2018), WhatsApp announced theWhatsApp Business App which allows small business to get in touch with their customers. This is not an API, but at least a way to officially communicate as a brand rather than a normal user (phone number). It comes with features like automatic answers if you are not available, quick replies or welcome messages.

WhatsApp API Alternatives

If you want to play around with messaging platforms to build chatbots or other systems, have a look at Facebook Messenger, Telegram, Viber or Line. All of these services offer a full API which is easy to implement with CloudRail. With our Unified Messaging API, you can access all services via a single interface. So e.g. the function to send a message works exactly the same for Facebook Messenger as for Telegram (and hopefully soon WhatsApp). Check out our tutorial how to create a chatbot for Facebook Messenger. Here is a quick code sample how to get started:

Other platforms like Android, iOS or Xamarin can be found here.

We will keep this article updated to cover the current situation regarding the WhatsApp API.

1 Star2 Stars3 Stars4 Stars5 Stars (3 votes, average: 5.00 out of 5)
Recent Posts