We are sunsetting On-Premises API. Refer to our On-Premises API Sunset document for details, and to learn how to migrate to our next-generation Cloud API.

Advanced Setup

After getting your WhatsApp Business API client up and running, there are more advanced steps and settings to get the most out of your experience.

Webhooks

Webhooks handle incoming messages from people who respond to you on WhatsApp including text, location, and media such as pictures and documents as well as the status of the messages you've sent. We've prepared a test app so that you can try this out with only a couple of clicks.

Callbacks are an important channel for delivering both timely notifications as well as out-of-band errors, and it is thus highly recommended you set the webhooks parameter in the Application Settings with a callback URL.

Webhooks used with the WhatsApp Business API require HTTPS. You can use your own Certification Authority certificates to prevent SSL errors when sending callbacks to the configured Webhook. See the Webhooks CA Certificates documentation for more information.

See the Webhooks documentation for more information.

Backup and Restore

Once you have a working WhatsApp Business API client and have all the settings in place, you can create a backup to make it easier to restore to a known working state, if necessary, or to move to different environments/servers. This allows you to restore everything you have just done on another machine without having to go through registration again. Make sure to keep your password in a secure place.

See the Backup and Restore documentation for more information.

Two-Step Verification

Use two-step verification to add an extra layer of security to the WhatsApp Business API client. When you have two-step verification enabled, any attempt to register your phone number on WhatsApp must be accompanied by the six-digit PIN that you create using this feature.

See the Two-Step Verification documention for more information.

Monitoring

You can set up dashboards to monitor the WhatsApp Business API client and send notifications for changes in monitoring using Prometheus and Grafana.

See the Monitoring and Alerting documentation for more information.

Availability and Scaling

The base version of the WhatsApp Business API runs on a single Docker container. High Availability and Multiconnect work together to give you more options. For more information on setting up and running these solutions, see the High Availability and Multiconnect documentation.