scenariobot-guide

03. Connecting a phone

How to get there: Top bar → Phones. This is the screen you land on after signing in.

The phone list

Every number you’ve connected, as a card showing its nickname, number, label, colour and live status.

Status Meaning
Active linked and working
Disconnected the WhatsApp session dropped — nothing will run

Each card has actions for disconnecting and reconnecting. Clicking the card itself opens that phone — see Phone Detail below.

There’s also a Templates tab on this screen → Chapter 08.

Adding a phone

Phones → + Add Phone. A three-step wizard:

Step 1 — Phone details

Nickname, number, a label (Business, Private, Marketing, Support, Sales, General) and a colour. Accept the terms to continue.

The label and colour are only for your own organisation — they don’t change behaviour.

Step 2 — QR scan

Open WhatsApp on the physical handset → Linked devices → scan the code shown on screen.

Keep the handset nearby: the code refreshes on a timer. A pairing code is offered as an alternative if scanning isn’t practical — you type an 8-character code into WhatsApp instead.

Step 3 — Confirm

The phone joins the list and turns active.

Reconnecting

If a phone shows disconnected, use Reconnect on its card. The same wizard opens with the number already filled in, and you rescan.

The session behaves like any WhatsApp Web session: it stays linked until something ends it. See Chapter 15 for what keeps it alive.

What is inside a phone

Clicking a phone card opens Phone Detail, which has three tabs:

Tab Contents Chapter
📞 Calls chat view and call history 12, 11
👥 Contacts contact list and the contact wizard 04
🤖 Scenarios scenario list and the designer 05

The back arrow at the top-left returns to the phone list.


Next: Adding a contact