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.
Check what a number says about itself
Section titled “Check what a number says about itself”To look at one:
- Open
Inbox, thenConversations. - Open the business picker at the top of the page.
- Press
Checkon 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.
Scan the code to link the phone again
Section titled “Scan the code to link the phone again”A number that reads logged out opens straight onto a QR code. Whoever holds that
phone does this:
- Open WhatsApp on that phone.
- Go to Settings, then Linked devices.
- 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.
Point a number back at this app
Section titled “Point a number back at this app”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.
Add a number to the district
Section titled “Add a number to the district”Only a district admin sees this. The number is connected through Meta, and the phone needs the WhatsApp Business app.
To add one:
- Open the business picker and press
Add a number. - Press
Connect with Meta. - 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.
Add a Green API instance instead
Section titled “Add a Green API instance instead”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.
- Fill in
What to call it,Instance id,Its numberandAPI token. - Answer
Whose phone is this?. - 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.