ActivityTracker

CRM and pipeline

WhatsApp Business API setup: the steps, and what to decide before you start

Setting up the WhatsApp Business API isn't hard, but it's full of choices that are hard to undo: which number, direct or through a vendor, and what name your customers will see. Here are Meta's own steps in plain words, the decisions to make first, and how to tell if your team needs the API at all.

By the ActivityTracker team, updated

Do you need the API?

Check this before you open a single Meta screen. The WhatsApp Business API, which Meta calls the WhatsApp Business Platform or Cloud API, is for businesses that send messages through software: order updates, reminders and offers to thousands of people, or many agents on one number with automation on top.

Plenty of small teams don't need it. If most of your WhatsApp is customers writing to you and you replying, the free WhatsApp Business app covers it, and a team can share one number through linked devices. WhatsApp Business multiple users covers how, and what is WhatsApp Business? puts the app and the Platform side by side.

You probably do need it if:

  • You send the same update to hundreds of people a week, triggered by your own systems.
  • More than about ten people need to answer one number.
  • You want a chatbot, click-to-WhatsApp ads or payments running through WhatsApp's business service.

It costs money too. Meta charges per message, and vendors add their fee; WhatsApp Business API pricing explains how the bill is built.

If what your team needs is several people answering chats, ActivityTracker's WhatsApp team inbox shows every number you use in one place, with who's waiting, assignment and private notes.

See the WhatsApp inbox

Decide these three things first

Direct, or through a vendor

You can build on Meta's Cloud API yourself, which means a developer, a server to receive messages and your own inbox. Or you use a vendor, which Meta calls a Solution Partner, who gives you a signup flow and a ready-made inbox, which is the route most small businesses take. You pay their fee on top of Meta's charges, and in return nobody on your team has to write code.

Which number

Meta's page on business phone numbers says an eligible number must be owned by you, have a country and area code, and be able to receive voice calls or SMS. It also says a registered number "cannot be used with WhatsApp Messenger", and that a number already in use on WhatsApp can't be registered until that account is deleted.

That last point catches people out. If you move your current number, its app chats don't come with it. Meta does let vendors connect an existing WhatsApp Business app number and keep the app working. Its developer page on this says the business can keep sending one-to-one messages from the app, with history kept in sync between the two. Ask your vendor whether they offer it.

The name customers see

Every number needs a display name. Meta's display name page says it appears in your WhatsApp profile, and that it's verified against Meta's naming guidelines once you reach a higher messaging limit. Use your real business name, the one on your website and signage.

The setup steps

These follow Meta's Cloud API get-started guide. A vendor runs most of them for you through their signup flow, but the order is the same.

  1. Set up a business portfolio in Meta Business Suite, if you don't have one. It's the account that owns your WhatsApp assets.
  2. Create a Meta app, choose "Connect with customers through WhatsApp" when it asks what the app is for, and pick your business portfolio. With a vendor you skip this step: you sign up through their link.
  3. Connect a WhatsApp Business account to the app. Meta's guide says you can pick an existing one or create one, and that one may have been created for you with the portfolio.
  4. Send a test. Meta gives you a test number and a temporary access token, so you can message your own phone before anything is live.
  5. Set up webhooks, the address where WhatsApp sends incoming messages and delivery updates. A vendor does this for you.
  6. Create a permanent access token through a system user. Meta's guide says the temporary one "expires quickly".
  7. Add and register your real business number, with its display name.
  8. Write your first templates and submit them for review. You'll need them to message anyone who hasn't written to you in the last 24 hours.

Then verify your business in Meta Business Suite if you haven't. Meta's template guidelines say an unverified portfolio is capped at 250 templates per account, and a verified one with an approved display name gets up to 6,000.

Templates, the step that takes longest

Setup can be done in an afternoon. Getting templates approved is where the days go. Meta reviews every template, and a decision can take up to 24 hours. Rejections usually come from badly written variables, an offer inside a utility message, or asking for card or ID numbers. WhatsApp template rejected has each reason and its fix.

Write the three or four templates you'll send most, submit them together, and plan your launch for after they're approved.

Made-up example: a physiotherapy clinic with six staff sends about 400 appointment reminders a month and answers questions on one number.

Week 1, Monday: they pick a vendor with a signup flow and a shared inbox. They choose to keep their current number and the Business app, through the vendor's option for existing app numbers.

Week 1, Tuesday: the owner runs the signup, connects the number and enters the clinic's name as it appears on the door, while the vendor sets up the webhooks behind it.

Week 1, Wednesday: they submit three templates, a reminder the day before, a "we've moved your slot" message and a post-visit check-in. The check-in comes back as marketing. It mentioned a discount on the next session, so they cut that line and resubmit.

Week 2, Monday: all three are approved. Reminders start going out automatically from the booking system, and the front desk answers replies from the shared inbox.

Week 4: no-shows are down because people reply to move their slot the day before. The bill is Meta's per-message charges plus the vendor's monthly fee, which the owner checks against the no-shows saved.

Mistakes that are hard to undo

  • Moving your main number without checking what happens to its chats and its app.
  • Registering a number you don't own, like a staff member's personal mobile.
  • A display name that doesn't match your business, which can fail verification later.
  • Launching before templates are approved, then having nothing to send.
  • Messaging people who never agreed to hear from you, who then block or report you.

What to do first

  1. Count last month's WhatsApp messages: how many you sent first, and how many were replies.
  2. Go through the list above and decide whether you need the API at all.
  3. If you do, choose direct or a vendor, and which number, before you sign up for anything.
  4. Draft your three most-used templates and check them against Meta's rejection reasons.
  5. Verify your business in Meta Business Suite while you wait.

Keep reading

Questions people ask

Sources

Answer every chat, whoever's free.

The customer shouldn't have to wait for one phone.

Book a walkthrough See pricing