All topics
Get started8Account, team & permissions44Units & fields70Records, views & tasks39WhatsApp & Cortex Chat68Email & social27Lead ads & distribution38Automations52Documents & quotes32Dashboards40Cortex AI18Developers & API12
Help Center·448 guidesAll topicsContact support

Session states: start, stop, restart and log out

Every session has a status that shows whether the number is connected. Four buttons control it: Start, Stop, Restart and Logout. And you get an alert as soon as any number disconnects.

5 min
Before you start · for owners and managers
The Update permission on the channel’s row
  • You need: The Update permission on the channel’s row

The four buttons

Button
What it does
Does it need a new scan?
Start
Starts a stopped session
No, as long as the number is still linked
Stop
Pauses receiving and sending
No
Restart
Stops the session and starts it again. The first fix for any short glitch
No
Logout
Disconnects the number from Corteksa and removes it from the linked devices
Yes, with the same number

Every press is recorded in the session activity log, with your name and the reason: stopped from the CRM, logged out on the device or restarted from the CRM.

The disconnection alert

When a session moves from Working to Stopped, Failed or Scan QR, all of the session’s members get an in-app notification and a phone notification, with the session’s name and a link to the sessions page. A WhatsApp message may also reach the number itself, asking for it to be linked again.

The alert is sent once, only when the session disconnects. A session that flickers between Failed and Starting doesn’t repeat the alert.

Meta channels and TikTok

On the other channels, there’s no server for you to control. Start and Restart set the status back to Working, and Stop and Logout set it to Stopped. If the channel loses its permission at Meta, Failed shows, with a button to link it again.

At a glance

Status
What it means
What to do
Working
The number is connected, receiving and sending
Nothing
Starting
The session is connecting now
Wait a few seconds
Scan QR
The session is waiting for a number to be linked
Scan the code, or use the pairing code
Stopped
You stopped it, or it was stopped
Press Start
Failed
The connection dropped: the phone has no internet, the linked device was removed, or Meta suspended the account
Press Restart, and if it asks for the code, scan it

Logout on WhatsApp Web disconnects the number. When you link it again, you must use the same number, or it’s refused. See One number per session.

If something goes wrong

What you see
Why
What to do
The status is Failed after a restart
The linked device was removed from WhatsApp on the phone.
Press QR Code and scan it with the same number.
The control buttons don’t show
Your Update permission on the channel is Denied.
Ask the owner to change your role.
The session is Working, but messages to new numbers fail
A WhatsApp restriction on starting chats.

A real example

Shield Security Co.
The situation

The maintenance number disconnected at night because the on-call phone’s battery ran out.

What they did
  1. The disconnection notification reached the operations supervisor and the 2 on-call employees.
  2. An employee charged the phone, then the supervisor pressed Restart.
The result

The number was back within minutes, and the activity log showed when it disconnected and when it came back.

A made-up company, to show the idea. The numbers are rounded.

Good to know

Messages sent while the session is disconnected fail, and you resend them from the message itself.
The alert only reaches the session’s members.
Did this guide solve it?
If not, we’ll ask what was missing.
Open in Corteksa
Did this guide solve it?

We read every answer. To get a reply, use Contact support.