Skip to content
Illustration: a small shop front with a phone number plate beside its door, where a blank name sign slides into its frame on the roof while a review lamp blinks amber and then turns lime.

How to set up the WhatsApp Business API without a developer

Set up the WhatsApp Business API without a developer: three routes compared, the steps that need code, what to prepare, display name rules and common errors.

You can set up the WhatsApp Business API without a developer, as long as someone else handles the technical part. Sign up through a provider’s Embedded Signup, or use an inbox tool built on the WhatsApp Business Platform, and your share comes down to four things: a Meta business portfolio, a phone number that can receive a code, a display name and a payment method.

Going straight to Meta’s WhatsApp Cloud API cuts out the provider. The price is code, in three places: registering the number, a permanent access token and a webhook server. If nobody on your team writes code, our advice is simple. Go through a provider.

For life after setup (the 24-hour window, templates, pricing, messaging limits and opt-in), read WhatsApp Business API, explained for small teams.

Three ways to get the WhatsApp Business API

1. Meta’s Cloud API, directly. You create an app in Meta’s App Dashboard and send a first message from a test number Meta provides (get-started guide). Up to that point it’s all clicks. Going live is different: you need a permanent token and your own webhook server.

2. A provider’s Embedded Signup. Meta’s partners run its signup flow on their own site. You log in with Facebook, pick or create a business portfolio, add and verify a number, and enter a display name. The provider’s app gets access, while you keep ownership and full access in WhatsApp Manager (Embedded Signup overview). Who pays Meta depends on the kind of partner. Solution Partners can extend their credit line to you. With a Tech Provider, you add your own payment method and Meta bills you (partner overview).

3. An inbox tool that connects for you. Some tools sit on a provider’s connection, since Meta lets Tech Providers offer the full service by partnering with a Solution Partner (partner overview). You supply the Meta pieces the tool asks for, then answer customers in its inbox.

Route Who does the technical steps What you need Typical time
Cloud API, direct You or a developer Developer account, portfolio, number, display name, payment method, an HTTPS server No set time; going live waits on the webhook server
Embedded Signup The provider Facebook login, portfolio, number, display name, payment method unless the partner gives credit One signup flow; Meta publishes no duration
Inbox tool The tool and its provider The same Meta pieces Set by the tool’s checklist

Whichever route you take, business verification (if you do it) can take up to 14 working days (Meta). Meta keeps a list of partners on its Find a partner page.

What you need before you start

  1. A Meta business portfolio. The platform requires one. Create it at business.facebook.com under your public business name, without special characters (Meta’s help page).
  2. A phone number that can get a code. It must be yours, have a country and area code, and receive voice calls or SMS. Meta recommends mobile numbers. For landlines, VoIP and toll-free numbers it advises against SMS codes, so choose the call and allow international calls. A number behind a phone menu works only if the call reaches a person (Meta’s number rules). Need a US number? See how to get a US phone number from India.
  3. A display name that follows Meta’s rules, entered when you add the number. More on those below.
  4. A payment method. Meta takes Visa or Mastercard. American Express and PayPal won’t work (Meta). In India you can prepay by UPI in Meta’s Billing Hub instead. Choose with care, because the first choice sticks: UPI puts the account on prepaid billing, a saved card puts it on invoiced billing, and you can’t switch later (prepaid billing).

WhatsApp Cloud API setup, step by step

This is the direct route, as Meta’s get-started guide lays it out. Steps marked Developer need code or a server.

  1. Register as a Meta developer with your Facebook account.
  2. Create an app in the App Dashboard with the “Connect with customers through WhatsApp” use case, and select or create your business portfolio.
  3. Connect a Messaging account on the API Setup page, or create one.
  4. Send a test message from Meta’s test number to your phone, using the temporary token the page generates.
  5. Add your real number under WhatsApp > API Setup, with its display name, and verify it by code (Meta).
  6. Developer: register the number. Verifying a number doesn’t register it. Registration is an API call with a 6-digit PIN, and there’s no way to do it in the dashboard (registration docs).
  7. Developer: create a permanent token. In Business Settings, add a system user, assign it your app and WhatsApp account, and generate a token with the business_management, whatsapp_business_management and whatsapp_business_messaging permissions (access tokens). Generating it takes clicks. Storing and using it takes code.
  8. Developer: set up webhooks. Incoming messages arrive as webhooks, so you need a public server with a valid TLS certificate that answers Meta’s verification request (webhook endpoint). Then you subscribe to fields under WhatsApp > Configuration (webhooks overview).
  9. Add a payment method in Meta Business Suite under Settings > Billing and payments (Meta).
  10. Developer: send and reply. Each message is an API call. Without software on top, there’s no inbox for replies.

Count the Developer tags: four of the ten steps. That’s why we’d point most small teams to Embedded Signup or an inbox tool.

Number questions

Can I use a number that’s already on WhatsApp?

Not as it is. A number in use with WhatsApp can’t be registered until its account is deleted (Meta). In the app, that’s Settings > Account > Delete my account, and the number can take up to 3 minutes to free up. A WhatsApp Business app number has a gentler way out: onboard through a partner that supports Business app numbers, and keep the app (Meta’s migration guide).

Coexistence: the Business app and the API on one number

Coexistence connects your existing Business app account and number to the Cloud API. You keep chatting one-to-one in the app while a provider’s tool sends through the API, and the history stays in sync. Meta’s coexistence page sets out the terms.

Only Solution Partners and Tech Providers offer it, through Embedded Signup, and you need Business app version 2.24.17 or later. Your contacts carry over, and so do the last 6 months of chats if you agree. Group chats don’t sync.

A few things change. Disappearing messages, view once and live location are turned off in one-to-one chats, broadcast lists become read-only, and linked devices are unlinked until you relink them. Throughput is fixed at 20 messages per second. App messages stay free; API messages are charged at Cloud API rates. And keep the phone with the app in use, because the link can drop if it’s inactive for about 14 days.

The page lists no excluded countries. Even so, Meta’s signup errors include one for regions where the feature is unavailable, and one asking for more Business app activity first. Ask your provider before you count on it.

An example. Say you run a saree shop in Jaipur, and customers already message you on the WhatsApp Business app. You’d like your staff to answer them from a shared inbox. Deleting the app account would lose that chat history unless you back it up, so coexistence is the first thing to ask a provider about. If it’s available, you keep the app, your contacts come across, and so do the last 6 months of chats if you agree. Then the display name: “Sarees” or “Jaipur” on its own would be rejected, while your shop’s name with the city added is fine.

Moving a number to another provider

Under Meta’s new account model, numbers can’t be migrated between Solution Partners. You share your WhatsApp account with the new partner instead. The number stays put, conversations carry on, and you remove the old partner when you choose. A number also can’t move to another business portfolio (account model update).

Some Embedded Signup flows also offer eligible businesses up to two US numbers with a 555 area code. These need an approved display name before sending, and they can’t be used outside the platform (Embedded Signup overview).

Display name and business verification

You don’t need display name review or business verification to start sending (Meta).

Your display name gets reviewed once you become eligible for a higher messaging limit (Meta). If it’s rejected, edit it or appeal through Meta’s developer support. You can change it 10 times in 30 days. After an approved change, the number must be re-registered within 14 days, which is a job for your provider or developer (display names).

What gets a display name rejected

Meta checks that the name follows WhatsApp’s policies, describes the business accurately, and clearly relates to your legal name and branding (guidelines). A name fails if it:

  • is a generic word or a place alone, such as “Sarees” or “Jaipur”;
  • includes “Official” or “Verified”, or mentions Meta, WhatsApp or Facebook;
  • adds promotion, such as a discount;
  • looks like a web or email address;
  • uses a brand or personal name with no visible link to the business. For a brand you own, write “Brand by Company” and show the link on your website.

Adding a city, a department or an abbreviation to the business name is fine.

Business verification

You verify in Security Centre in Meta Business Suite, and you need full control of the portfolio. Enter your legal name, address, phone number and website exactly as your legal entity has them, and make sure the site loads over HTTPS. Without a matching record, you may need documents such as a business licence. A decision can take up to 14 working days (Meta).

Meta’s list of rejection reasons is short: false or misleading details, claiming a business you can’t represent, or a website that fails to load, isn’t HTTPS or links to an error. You may be able to appeal (Meta).

You can leave verification for later, but it matters as you grow. A new portfolio can register two numbers, and verification raises that to 20 (Meta).

Common errors and fixes

What you see Why Fix
Number registered to an existing WhatsApp account It’s still on WhatsApp or the Business app Delete that account and wait up to 3 minutes, or use coexistence (Meta)
Code doesn’t arrive, or too many requests SMS codes are unreliable on landlines and VoIP; requests are limited Choose a voice call, allow international calls, wait and retry (Meta)
Error 133016 10 registration attempts in 72 hours Wait out the 72-hour block (Meta)
Maximum number of phone numbers reached New portfolios can register two Remove a number or verify your business (Meta)
Display name violates guidelines It breaks a rule above Edit it and retry (Meta)
Error 190 The access token expired, often the temporary one Use a system user token (Meta)
Error 131042 A payment method problem, or a prepaid balance too low Fix billing or add UPI funds (Meta, Meta)
Error 131047 Over 24 hours since the customer last wrote Send an approved template (Meta)
No webhooks arrive The endpoint failed Meta’s verification Return the challenge value with status 200 over valid HTTPS (Meta)

How KNOQRA fits

If the four Developer steps put you off, KNOQRA is one way round them. It keeps WhatsApp, SMS and calls in one browser inbox for solo sellers and small teams, and its WhatsApp runs on Meta’s WhatsApp Business Platform through Telnyx, on the Pro and Max plans.

You still bring the Meta pieces from this guide: a Meta business account, a phone number for WhatsApp and a display name Meta approves. After that, pick how much you want to do yourself. The setup page checks each step and tells you what’s missing. Or KNOQRA’s team can switch WhatsApp on for you for a one-time fee, refunded if the application is rejected. There’s no fixed monthly WhatsApp fee. You pay Meta’s per-message fee plus a small KNOQRA fee, listed on the pricing page.

Meta still has the final say on your number, your display name and any business verification. WhatsApp in KNOQRA covers the rest.

Sources

  1. Meta for Developers: Get started with the Cloud API
  2. Meta for Developers: About the WhatsApp Business Platform
  3. Meta for Developers: Updates to WhatsApp Business accounts
  4. Meta for Developers: Embedded Signup overview
  5. Meta for Developers: Partners
  6. WhatsApp Business Platform: Find a partner
  7. Meta Business Help Centre: How to create a business portfolio in Meta Business Suite
  8. Meta for Developers: Business phone numbers
  9. Meta for Developers: Display names
  10. Meta Business Help Centre: How to add a credit card to your messaging account
  11. Meta for Developers: Prepaid billing
  12. Meta for Developers: Register a phone number
  13. Meta for Developers: Access tokens
  14. Meta for Developers: Create a webhook endpoint
  15. Meta for Developers: WhatsApp webhooks
  16. Meta for Developers: Migrate an existing WhatsApp number to a business account
  17. Meta for Developers: Onboard WhatsApp Business app users (coexistence)
  18. Meta for Developers: Embedded Signup errors
  19. Meta Business Help Centre: Create your WhatsApp Business account with WhatsApp solution partners
  20. Meta Business Help Centre: About WhatsApp Business display name
  21. Meta Business Help Centre: Display name guidelines for the WhatsApp Business platform
  22. Meta Business Help Centre: Verifying your business in Meta Business Suite
  23. Meta Business Help Centre: Why was my business verification submission rejected?
  24. Meta for Developers: Error codes

Fees and rules change: check the source before you rely on a number. This post is general information, not legal advice.

Apple, the Apple logo and iPhone are trademarks of Apple Inc., registered in the U.S. and other countries. App Store is a service mark of Apple Inc., registered in the U.S. and other countries. IOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used under license. Android, Google Play and the Google Play logo are trademarks of Google LLC.

Start with one conversation.

Create your account in a minute. Calls and texts on one number, with every conversation in one place.