Work with WhatsApp Business Cloud API from your Frappe site. Automate sending and releasing of WhatsApp messages.
bench get-app waba_integration
bench --site <site-name> install-app waba_integrationIf you want to install on Frappe Cloud, presently, you can fork and add it to your private bench.
In order to set up the app, you will need to first setup developer assets and get credentials from the Meta Developer Portal. You can do so by following this guide.
In developer mode, if you want to send a message to a number, you have to explicitly add it (also verified by an OTP) to the recipient's list:
Now, try sending a test message from the developer dashboard by clicking the Send Message button:
If you received the message, you are set!
Step 1:
Step 2:
Step 3:
The callback URL will be:
<your-site-base-url>/api/method/waba_integration.api.webhook.handle
For instance:
https://hussain.frappe.cloud/api/method/waba_integration.api.webhook.handle
You can set the verify token to any random string, but remember it, since we will need it in the next step.
Note: For working with webhooks in the development environment, you will need to use ngrok to proxy the webhooks to your local.
Open WABA Settings form and fill in the credentials you obtained in the last step from the Meta developer console:
The Webhook Verify Token must be same as the verify token you set in the developer console's webhook configuration in the previous step.
The temporary token generated above is only valid for 24 hours and is only suitable for development. In order to generate a permanent token, please refer this guide.
You can use the WABA WhatsApp Message doctype to create and send messages. Whenever you receive a new message, you will find it here.
Use the WABA Webhook Log to see all the webhooks received from WhatsApp Cloud API. You can use this for debugging and also you can write hooks on top of it to build your own integrations.
MIT