Connect WhatsApp with your own Meta developer app
This guide is for people who already have their own Meta developer app and want to connect WhatsApp with an access token and IDs instead of the Connect with Meta button. It is more technical, so use it only if you are comfortable with Meta for Developers.
When to use this option#
Most customers should use Connect your WhatsApp number with Meta, which needs no developer account. Use your own developer app if you already run a Meta app, or if you want control over the app, token and webhook yourself.
You need:
- A Meta developer app with the WhatsApp product added.
- A permanent access token. Meta explains how to create one with a system user.
- Your Phone number ID, WhatsApp Business Account ID and App ID, all shown in the WhatsApp section of your Meta app.
This option is called WhatsApp Developer App Connect. It is a service that your plan and account must have switched on. If you do not see the menu item, check Setting > Services.
Open the developer app screen#
- Open the screenGo to Setting > WhatsApp developer app. You can also open Setting > Connected accounts and press the link "Connect with your developer app". The page title is WhatsApp Settings.
- Read the statusA green message says you are connected to the WhatsApp Cloud API. A red message says not connected, and asks you to complete all the steps. A second red message appears if the webhook is not connected, because real-time updates will not work until it is.
Set up the webhook in Meta#
A webhook is how Meta sends you incoming messages and delivery updates. On the left of the page, the Webhook config box gives you values to copy. Click the copy icon next to each one.
- Copy the Callback URLIt is unique to your account.
- Copy the Verify tokenThis is the secret word Meta checks. Keep it private.
- Paste both in your Meta appIn your app, open WhatsApp configuration, add the webhook with this Callback URL and Verify token, and verify it. Subscribe to the messages field.
- Add the policy links if Meta asksThe same box shows our Privacy policy and Terms and conditions links that you can copy.
Save your token and IDs#
- Fill the formIn the Whatsapp Access Token box, fill four required fields: Access token, Phone number ID, Business account ID and App ID. Take them from your Meta app.
- Press SaveIf a value is missing or wrong the field shows an error under it. When it works, the page shows the Business account details: name, ID, phone number, verified name, quality rating, message limit and number status.
- Sync if neededPress Sync to pull the latest details from Meta.
Webhook Config
WhatsApp Access Token
- Webhook Config: copy the Callback URL and Verify token into your Meta app
- Four required fields from your Meta app
- Save, then Sync to pull details from Meta
Your access token is like a password. Do not share it or send it in chats. To disconnect, press Remove and confirm. Removing the token cannot be undone, so you will need to enter the token again.
Common problems#
Not connected, or the webhook is not connected
Check that you saved all four fields and that the Callback URL and Verify token in Meta match this page exactly. Until the webhook works you will not get incoming messages in real time.
WhatsApp Developer App Connect is not on for your account
This service is off for you. Switch it on under Setting > Services if your plan includes it, or ask support.
Phone number ID or business account ID is rejected
The form checks these values for your account. Copy them again from your Meta app and make sure you did not add spaces.
The token no longer works
Tokens made in the Meta dashboard can be temporary. Create a permanent token with a system user and save it again.
Related guides#
Need help?#
Contact support on WhatsApp +91 99159 60958 or email info@whatsappmarketingagency.com, or use the contact page.