Skip to content

Connect or reconnect a WhatsApp number

Every message in the Inbox travels through a WhatsApp number that’s linked to a real phone. WhatsApp drops that link now and then, after a re-install or a session expiring. When it does, first messages queue up and never leave, and a lead writing back never reaches the inbox.

You can check and reconnect the numbers your own businesses use. On a number other people’s sheets use, the red banner shows Your district admin reconnects this one where Reconnect would be. Only a district admin can add a number.

To look at one:

  1. Open Inbox, then Conversations.
  2. Open the business picker at the top of the page.
  3. Press Check on the row for that business.

The dot on each row carries the answer, and a word appears beside it whenever the answer isn’t connected. logged out means the phone is unlinked. not pointed here means the phone is fine and the number is reporting somewhere else, so messages still go out while replies never arrive. not connected covers everything else Green API reports.

If Green API doesn’t answer the check, the row shows what the app last saw for that number. One bad read stays green until a second one confirms it.

The dialog names the number, its Green API instance, and the fix that belongs to the fault it actually has. It never shows the API token.

Check only appears on a business that has a number. The picker isn’t on the Today, Agent inbox, Reports or Appointments tabs.

A number that reads logged out opens straight onto a QR code. Whoever holds that phone does this:

  1. Open WhatsApp on that phone.
  2. Go to Settings, then Linked devices.
  3. Press Link a device, and point it at the code on screen.

The code refreshes itself every few seconds, and any one code lasts about 20 seconds. Stay on the screen until the dialog says the number is connected.

Copy link copies a link for somebody sitting elsewhere. It shows a fresh code for an hour, on any screen except the phone being linked. New code draws another one.

A number that reads not pointed here needs no scan. A district admin presses Point it here in its dialog. Green API restarts the instance, so give it a minute before you judge whether replies are arriving.

That one is admin-only. An advisor sees Your district admin reconnects this one on the red banner instead.

Only a district admin sees this. The number is connected through Meta, and the phone needs the WhatsApp Business app.

To add one:

  1. Open the business picker and press Add a number.
  2. Press Connect with Meta.
  3. Log in with Facebook in the window that opens, and pick the number.

When the window closes, a message names the number that was connected. A number new to WhatsApp also gets a 6-digit two-step PIN: save it before you press I saved it. Meta asks for it if the number is ever registered again, and it isn’t shown twice. A number that keeps the WhatsApp Business app on its phone gets no PIN.

A number already on Green API can move over without losing anything. Its own dialog offers you Switch to Meta, and its sheets, agents and chats stay.

Press Use a Green API instance instead in the same dialog. The instance id and the API token both come from Green API’s own console, on the page for that instance.

  1. Fill in What to call it, Instance id, Its number and API token.
  2. Answer Whose phone is this?.
  3. Press Add it.

The answer to Whose phone is this? decides what the app may read. A business line. is picked for you. It treats every chat on the number as work, so a stranger writing in becomes a lead. Somebody's own phone. reads only the people already in that advisor’s lead sheet, so the rest of the phone stays private.

A business line also offers Give it an inbox of its own., which keeps everyone who writes to that number in one place. Nothing is texted automatically until somebody writes a first message for it. See Write the first message a new lead gets.

The number says it’s connected, so why is nothing arriving?

Read the word beside the dot again. not pointed here is a working phone reporting to somewhere else, and a scan fixes nothing. A district admin presses Point it here instead.

Can I reconnect a colleague’s number?

Only a district admin can, and they can reconnect any number in the district. Your own business’s number is yours to scan. Where it isn’t yours to fix, the Reconnect button is replaced by a line saying who reconnects it.

The QR code won’t load. What now?

Press New code. Green API sometimes has no code ready for a moment, and the dialog says so rather than drawing a dead square.

What can ActivityTracker see once my number is on Meta?

Only one-to-one chats. Groups, past chats and contacts never come over, and on somebody’s own phone only your lead sheet’s chats are saved. See What we can see on a number connected through Meta.

Does adding a number send anything to anybody?

No. A new number is saved and pointed at this app, and nothing goes out from it until a first message or an agent is written for it.