> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tartini.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Fix connection issues

> Common symptoms when connecting WhatsApp by QR Code or WABA, with the likely cause and how to fix it.

export const Artigo = ({titulo, href, children}) => <a className="lista-artigos-item" href={href}>
    <span className="lista-artigos-texto">
      <span className="lista-artigos-nome">{titulo}</span>
      {children ? <span className="lista-artigos-desc">{children}</span> : null}
    </span>
    <svg className="lista-artigos-seta" viewBox="0 0 24 24" width="18" height="18" aria-hidden="true">
      <path d="M9 6l6 6-6 6" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
    </svg>
  </a>;

export const Lista = ({titulo, children}) => <div className="lista-artigos">
    {titulo ? <p className="lista-artigos-titulo">{titulo}</p> : null}
    <div className="lista-artigos-itens">{children}</div>
  </div>;

This page gathers the most common problems when connecting or keeping a WhatsApp channel active in Tartini.

<Note>
  Who fixes it: Administrator, Company Manager, Area Manager, and Unit Manager.

  The Tartini interface is in Portuguese. Screen and button names appear here exactly as on screen, with the translation in parentheses.
</Note>

***

## WhatsApp Business (QR Code) disconnected on its own

**Cause:** the WhatsApp session on the phone ended.

**Fix:**

<Steps>
  <Step title="Open the number list">Go to **Configurações > Canais > WhatsApp Business** (Settings > Channels > WhatsApp Business).</Step>
  <Step title="Sync again">Click the ⋮ next to the channel and choose **Sincronizar** (Sync).</Step>
  <Step title="Scan the QR Code">Open WhatsApp on your phone and scan the new code.</Step>
</Steps>

***

## The QR Code or pairing code no longer works

**Likely cause:** the code wasn't scanned in time.&#x20;

**Fix:** click **Gerar novo QR Code** (Generate new QR Code) or **Gerar novo código** (Generate new code), inside the same modal, and try again.

***

## You see "Já existe um canal para esta entidade"

**Cause:** the Unit you chose already has a channel of that type connected.

**Fix:** use the channel that already exists on that Unit, or connect the number on a different Unit.

***

## The connection drops on its own, or I'm worried the number will get banned

**Cause:** WhatsApp Business by QR Code uses an unofficial connection. Meta can ban numbers connected this way, and WhatsApp updates can drop the session.

**Fix:** migrate to [WABA](/en/canais/whatsapp-business-api), Meta's official connection.

***

## No number shows up for me to select (WABA)

**Cause:** the WABA doesn't have any number provisioned yet. That's what the screen itself points to: "Certifique-se de que você tem números registrados na sua WhatsApp Business Account" (Make sure you have numbers registered in your WhatsApp Business Account).

**Fix:** check under **Meta Business > WhatsApp Manager > Números** (Meta Business > WhatsApp Manager > Numbers) whether the number is provisioned in the WhatsApp Business Account you authorized.

***

## The Meta window doesn't open, or authorization fails

**Cause:** the browser blocked the pop-up. The screen shows the warning "Popup bloqueado pelo navegador. Por favor, permita popups para este site" (Pop-up blocked by the browser. Please allow pop-ups for this site).

**Fix:** allow pop-ups for Tartini in your browser and click **Conectar com Meta** (Connect with Meta) again.

***

## The number shows up in the selection, but saving fails

**Cause:** the screen shows the generic warning "Erro ao configurar número. Tente novamente" (Error configuring number. Try again).&#x20;

**Fix:** try selecting the number again. If the error continues, redo the connection from the start.

***

## The two-step verification PIN isn't accepted

**Cause:** the PIN you typed doesn't match the PIN already registered for that number on Meta, or it has fewer than 6 digits.

**Fix:** use exactly the PIN registered previously for that number. If this is the first time, any 6-digit PIN works, but write it down and keep it safe: it can't be recovered later.

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I use the same number on personal WhatsApp and Tartini at the same time?">
    No. A number can only be active in one place at a time: personal WhatsApp, WhatsApp Business on a phone, or WABA.
  </Accordion>

  <Accordion title="Can I port my current number to WABA?">
    Yes. First unlink the number from regular WhatsApp Business, then register it on WABA through Meta or through an authorized partner.
  </Accordion>

  <Accordion title="Still not fixed?">
    Contact Tartini support and provide the Unit name, the exact error message, and which step the problem happened on.
  </Accordion>
</AccordionGroup>

***

## Related articles

<Lista>
  <Artigo titulo="Connect WhatsApp by QR Code" href="/en/canais/whatsapp-qr-code">Step-by-step connection by camera or code.</Artigo>
  <Artigo titulo="Connect WhatsApp Business API (WABA)" href="/en/canais/whatsapp-business-api">Prerequisites and connection for the official channel.</Artigo>
</Lista>


## Related topics

- [Getting Started with Tartini](/en/primeiros-passos/guias/comecando-com-o-tartini.md)
- [Frequently Asked Questions for Beginners](/en/primeiros-passos/perguntas-frequentes/iniciantes.md)
- [Channels explained](/en/canais/canais-explicados.md)