Skip to main content
Link your WhatsApp once, then choose which WhatsApp groups and direct chats to bring into a project. Messages you send from OnSite in a linked chat are delivered to WhatsApp. Replies sent on WhatsApp show up in OnSite. Linking, adding and moving WhatsApp chats are done in the phone app. On a computer, you can read and send messages in WhatsApp chats once your WhatsApp is linked.
1

Enter your WhatsApp number

Go to Settings > WhatsApp and tap Link WhatsApp. Enter the number you use on WhatsApp and tap Get pairing code.
2

Copy the pairing code

OnSite shows an 8-character code. Tap Copy code before it expires. If it runs out, tap Get a new code.
3

Tap the WhatsApp notification

No notification? In WhatsApp, go to Settings > Linked devices > Link a device > Link with phone number instead.
4

Confirm it's you

WhatsApp lists OnSite as “Chrome (Linux)”. That’s OnSite, so tap Confirm.
5

Enter the code

Paste the code. OnSite connects in a few seconds.
Keep WhatsApp on your phone to stay connected.
Can’t connect? Log out the old link first. In WhatsApp, go to Settings > Linked devices, tap the old OnSite link (usually listed as “Other device”) and tap Log out. Then link again.

Add WhatsApp chats to a project

1

Open the WhatsApp list

In the project, tap +, then Add a WhatsApp chat. If your WhatsApp isn’t linked yet, OnSite walks you through linking first.
2

Pick your chats

Under Your WhatsApp chats, tick the groups and direct chats to bring in. The list shows chats that were active in the last 30 days.
3

Add them

Tap the button at the bottom, for example Add 2 chats to Site A. Your chats appear in the project’s chat list.
If a chat includes people who are on OnSite but aren’t in the project, OnSite offers to add them. Tap Add and import. If you can’t add people to the project, OnSite asks you to get a project or organisation admin to add them first.

What history comes in

  • Each chat brings in up to its latest 100 messages from the last 30 days.
  • Photos from that history show as Photo sent on WhatsApp. Other files and voice notes show as a short label. Open WhatsApp to see them.
  • While history is copying, the chat shows “Chat history is still syncing from WhatsApp”.
  • New messages come through as they’re sent.

Make a new WhatsApp group

New groups can only be created in WhatsApp itself.
  1. In the Add a WhatsApp chat list, tap Make a new WhatsApp group, then Open WhatsApp. OnSite copies the project’s name so you can paste it into the group name.
  2. Create the group in WhatsApp.
  3. Come back to OnSite. The new group appears at the top of the list, ready to add.

People who aren’t on OnSite

People who aren’t on OnSite keep using WhatsApp as normal. Their messages appear in OnSite, and the member list marks them Not on Onsite.
  • Members are managed in WhatsApp. To add someone, add them to the group in WhatsApp. They appear in OnSite automatically.
  • Teammates on OnSite who haven’t linked their WhatsApp can read a WhatsApp group in OnSite. To send messages, they must be in the group on WhatsApp and link their own WhatsApp. If a teammate has already brought in a group you’re in, Settings > WhatsApp lists it under Waiting for you on WhatsApp. Link your WhatsApp and you join automatically.
  • Direct chats belong to the person who brought them in. Only they can send messages there. Everyone else sees them as view-only.

Move a chat to another project

Project admins can move a WhatsApp group. You can only move a chat to an open project in the same organisation, and everyone in it who’s on OnSite must already be in that project.
  1. Open the chat’s info and tap Move to another project.
  2. Choose the project, then tap Move.
The live WhatsApp chat moves for everyone. A new chat in the other project receives future messages. The old project keeps a read-only snapshot of earlier messages and media, with a banner that links to the new chat.

Connection status

Settings > WhatsApp shows your status: Connected, Connection degraded, Disconnected or Not linked. WhatsApp chats show a banner when something’s wrong: If a message doesn’t reach WhatsApp, a Not delivered to WhatsApp notice appears in the chat.
  • Leave a chat: on your phone, tap Leave channel in chat info, then Leave in Onsite. On a computer, right-click the chat, choose Exit, then Remove from Onsite. You stay in the WhatsApp group and keep getting its messages in WhatsApp, so the chat may come back. To leave for good, exit the group in WhatsApp.
  • Unlink WhatsApp: go to Settings > WhatsApp, tap Unlink, then Confirm. Your WhatsApp chats stay in OnSite but become read-only until you link again. To have them deleted, email [email protected].

Blue in WhatsApp groups

Blue can answer in WhatsApp groups too. See Blue in WhatsApp groups.