Cannot link WhatsApp: frequent issues and solutions

If you cannot link WhatsApp, first check that you are using the correct number, have permissions on the account, and that there is no active connection with another provider. It can also fail due to an expired QR code, browser permissions, or Meta restrictions. This guide brings together safe checks before disconnecting or deleting anything.

Before touching anything: do not delete the WhatsApp account or disconnect the current provider “just to test”. Identify if the number is new, is in WhatsApp Business App, or is already connected to another platform.

Quick checks

  • Confirm the country code and that it is the correct number.
  • Keep the WhatsApp Business application and the phone with internet updated.
  • If the flow uses Meta, log in with an administrator account for the correct business.
  • Allow browser pop-ups during setup.
  • If you use QR, verify that it has not expired before scanning it.

Frequent issues and solutions

Issue What to do
The QR expired Generate a new one from the inbox and scan it with the correct phone.
The number is already linked Check if it is connected to another platform or session before disconnecting it.
There are not enough permissions Ask an administrator to complete the process or grant you access.
Linking finished but the inbox does not appear Return to Viadesk, complete the wizard, and reload Settings → Inboxes. Avoid creating duplicates.
The session disconnects Generate a new QR and repeat the linking from the existing inbox.

If you use QR linking

  1. Open the WhatsApp inbox in Viadesk.
  2. Generate a new QR code.
  3. On the phone, go to WhatsApp → Linked devices.
  4. Scan the code and wait for synchronization to finish.

To see the complete procedure, consult how to link WhatsApp to a multi-agent inbox.

To request support: send the full error message, a screenshot, the number with country code, the time of the attempt, and whether the number is new or was already connected. Never share tokens, PINs, or passwords.

Want to understand linking before configuring it?

Consult how multi-agent WhatsApp works or check out the Viadesk demo and plans.

If you still cannot link the number, open a ticket from the client portal or inquire via the online chat on the site.

  • whatsapp multiagente
  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

ViaDesk - Channels and Inboxes

This article explains how to create a website chat inbox in ViaDesk: configuring the widget,...

ViaDesk - Website Live Chat Settings

This article explains the advanced settings of a website live chat inbox in ViaDesk, once the...

ViaDesk - Install site chat with Google Tag Manager

This article explains how to install the ViaDesk live chat widget on your website using Google...

ViaDesk - Dark mode in the site chat widget

This article explains how to configure the dark mode of the ViaDesk live chat widget so that it...

ViaDesk - Contact Identity and Identity Validation

This article explains how ViaDesk identifies a customer in conversations and the difference...