ربط رقم واتساب متجركConnect your WhatsApp number

Get these ready:

• A number that isn't on any WhatsApp. Meta refuses to register a number that works in WhatsApp. If your number is on ordinary WhatsApp or the Business app, delete its account in the app: Settings → Account → Delete my account. That erases its chats, so copy what you need first.
• The number must be able to get a verification code by text or call, and if it sits behind a phone menu, a real person has to pass the code on.
• The Facebook account that runs your shop's page, to create the developer account with.
• Your shop's real name as it shows on your website. Meta reviews the display name and compares it with your website.
• A payment card to add in WhatsApp Manager, because nothing sends without one.

This guide explains the first way.

1. Create a developer account. Open developers.facebook.com with the Facebook account that runs your shop, and turn on two-step sign-in.
2. Create an app. Create app → choose "Connect with customers through WhatsApp" → pick your business or make one.
3. Add your number. WhatsApp → API Setup → Add phone number. Type your shop's real name as the display name. You get a code by text or call, so enter it.
4. Make an access token that never expires. The token on the API Setup page dies in hours: it looks right today and stops working tomorrow. Open Business Settings → Users → System users → Add, name it Mudheef with the Admin role. Add assets: your app (Manage app) and your WhatsApp account (Manage WhatsApp Business accounts), with full control. Then Generate token, choose your app, tick whatsapp_business_messaging and whatsapp_business_management, and choose "Never" for expiry. Copy the token at once: it is shown only once.
5. Gather the other values as the table below shows.
6. Paste them into Mudheef. Dashboard → Integrations → WhatsApp → "Advanced: use your own Meta app". The "Make one for me" button makes the verify token for you. Then press "Connect with your own app", and Mudheef checks the token and the number straight away.
7. Connect the webhook. In your app: WhatsApp → Configuration → Edit. Paste the callback URL Mudheef shows and the same verify token you typed in Mudheef, then Verify and save. Under Webhook fields, subscribe to messages. Do this after you've connected in Mudheef, because Meta tests the address right away.
8. Switch your app to Live. At the top of your App Dashboard, turn App mode from Development to Live. Meta asks first for a privacy policy link under App settings → Basic: use your shop's. An app in development mode only receives messages from people who have a role on it, not from your shoppers.
9. Add your card, then check. In WhatsApp Manager → Overview → payment method. Then press "Check everything" in Mudheef: it names what is wrong in plain words.
10. Submit the templates. For messages more than 24 hours after the shopper's last message, WhatsApp only delivers templates Meta has approved. Submit the templates Mudheef shows in "Cart recovery" and wait for approval (usually minutes to a day).
11. Try it. Send a message from your own phone to your shop's number with the store in test mode, then switch it on for shoppers.

The five values Mudheef asks for:

You pay Meta directly with your card in WhatsApp Manager, and Mudheef takes nothing from that bill. Meta gives each number about 1,000 free service replies a month, and after that each reply is charged. Cart reminders count as marketing messages, which cost more. Prices differ by country and change, so check Meta's rate card for your country before you turn the reminders on.

• A new number starts out able to message 250 different people a day outside the 24-hour window. Replies to a shopper who wrote to you less than 24 hours ago don't count toward this limit.
• The limit rises when you verify your business with Meta, or when you message many people who welcome your messages, and then it rises step by step as long as quality stays high.
• The number's quality matters: if shoppers block or report your messages, growth stops and the limit can be cut. Message only people who agreed, and respect the word STOP.
• The limit belongs to your Meta business account and is shared by all its numbers.

If your store sells things like this, we recommend using the WhatsApp number for support only: order status, delivery and help, and not taking an order or a payment for these products inside WhatsApp. The chat on your website is the better place to sell. And keep your store's Meta business account separate from any other account you don't want affected.

No, not this way. With your own Meta app the number leaves the WhatsApp apps. Keeping the WhatsApp Business app on the phone while connected to Mudheef (called coexistence) needs one-click "Connect with Meta", which is coming soon. When it is available, these limits apply:

• App version 2.24.17 or newer.
• The number sends up to 20 messages a second.
• No groups, and no voice or video calls, and broadcast lists become read-only.
• Linked devices are unlinked and must be linked again.
• You have 24 hours after connecting to sync contacts and chats, once.

• The display name was rejected. Usually because it's a person's name, another business's name, or doesn't match your shop's name on your website. Use the shop's own name exactly as your website shows it, with no symbols and no word like "official", and resubmit in WhatsApp Manager.
• The number is in use. Delete its account in the WhatsApp or WhatsApp Business app, then add it again. A banned number needs an appeal with Meta first.
• The test passed yesterday and fails today. You probably used the temporary access token. Make the system-user token that never expires, as in step 4.
• Messages don't reach Mudheef. Check the webhook: the callback URL and verify token match, and you subscribed to messages.
• Nothing sends. Usually no card was added in WhatsApp Manager, or the templates aren't approved yet.

Write to us from the support page, and never send us the access token or the app secret in a message. You can also read the WhatsApp Business messaging policy to see what is allowed.