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

# Coexistência WhatsApp

> Conecte o WhatsApp Business pessoal do corretor à Morada e espelhe as conversas dele na plataforma em tempo real.

A **Coexistência WhatsApp** conecta o WhatsApp Business pessoal/corporativo do corretor à plataforma Morada. As conversas que ele faz continuam acontecendo no aparelho dele e ao mesmo tempo aparecem na plataforma, em tempo real.

## O que é?

Funcionalidade que pareia o número WhatsApp Business do corretor à Morada via processo de espelhamento. A partir do pareamento, toda conversa que o corretor mantém pelo número pareado fica também disponível na plataforma — sem alterar a experiência do cliente final.

## Como funciona

<Steps>
  <Step title="Pareamento do WhatsApp Business do corretor">
    O número WhatsApp Business pessoal do corretor é conectado à Morada via processo de pareamento autorizado.
  </Step>

  <Step title="Espelhamento em tempo real">
    A partir do pareamento, as conversas do corretor passam a aparecer também na plataforma, em tempo real.
  </Step>

  <Step title="Conversa segue no aparelho do corretor">
    Do lado do cliente final, nada muda — a conversa continua no WhatsApp do corretor, com o mesmo número e perfil.
  </Step>
</Steps>

## Envio de mensagem ativa pelo número pareado

Além de espelhar as conversas, o número pareado também pode disparar **mensagens ativas** (templates aprovados pela Meta) direto do Talk — o envio sai do próprio WhatsApp Business do corretor, não de um número genérico da operação.

<Warning>
  Cada número pareado precisa do seu **próprio template aprovado pela Meta**. Não é possível reaproveitar templates criados para outros números — a aprovação da Meta vincula o template ao número que o emitiu.
</Warning>

* Crie e submeta um template específico para o número pareado
* Após aprovação da Meta, o template fica disponível para envio pelo Talk
* O envio aparece tanto no WhatsApp do corretor quanto na conversa dentro do Talk

## Especificações técnicas

| Item                         | Valor atual           |
| ---------------------------- | --------------------- |
| Números por conta WABA       | 20                    |
| Latência do espelhamento     | Tempo real (segundos) |
| Tipos de conversa suportados | Texto e áudio         |

## Quando ativar

* Incorporadora com rede de corretores externos ou parceiros (house, terceiros).
* Operação que precisa de visibilidade central das conversas que acontecem em múltiplos números.
* Time descentralizado em que cada corretor opera o próprio WhatsApp Business.

## Como ativar

<Info>
  **Pré-requisitos:** acesso à Business Manager (BM) da Meta + dispositivo do número a ser conectado em mãos durante todo o processo.
</Info>

<Steps>
  <Step title="Acesse Gerenciar → Usuários">
    No menu lateral, vá em **Gerenciar** → **Usuários**.
  </Step>

  <Step title="Abra a aba Usuários externos">
    Na página **Usuários e equipes**, selecione a aba **Usuários externos**.

    <Frame>
      <img src="https://mintcdn.com/moradaai-f7bfc739/JRWzsJdZRQ7PfNtQ/images/talk/coexistencia-usuarios-externos.png?fit=max&auto=format&n=JRWzsJdZRQ7PfNtQ&q=85&s=ce4e71204228a955ec5a78c501603061" alt="Aba Usuários externos com lista de usuários conectados" width="1634" height="989" data-path="images/talk/coexistencia-usuarios-externos.png" />
    </Frame>
  </Step>

  <Step title="Clique em Criar usuário">
    Clique em **+ Criar usuário** no canto superior direito. No modal **Criar usuário · Conectar WhatsApp Business**, informe o **nome** e o **número de telefone** do usuário (corretor) que terá o WhatsApp Business pareado.

    <Frame>
      <img src="https://mintcdn.com/moradaai-f7bfc739/JRWzsJdZRQ7PfNtQ/images/talk/coexistencia-criar-usuario.png?fit=max&auto=format&n=JRWzsJdZRQ7PfNtQ&q=85&s=e321a6ca08f46d25ae3578b83258ff1d" alt="Modal Criar usuário com campos nome e número de telefone" width="1632" height="902" data-path="images/talk/coexistencia-criar-usuario.png" />
    </Frame>
  </Step>

  <Step title="Inicie a conexão pela Meta">
    Clique em **Conectar conta do WhatsApp**. A plataforma abre o fluxo da Meta — selecione o **Portfólio empresarial** e a **Conta do WhatsApp Business** (escolha **Conectar um app do WhatsApp Business** para parear um número existente) e clique em **Avançar**.

    <Frame>
      <img src="https://mintcdn.com/moradaai-f7bfc739/JRWzsJdZRQ7PfNtQ/images/talk/coexistencia-fluxo-meta.png?fit=max&auto=format&n=JRWzsJdZRQ7PfNtQ&q=85&s=36e20202f64a8a5cea56532d35e44a75" alt="Fluxo de conexão da Meta com seleção de Portfólio empresarial e Conta do WhatsApp Business" width="564" height="669" data-path="images/talk/coexistencia-fluxo-meta.png" />
    </Frame>
  </Step>

  <Step title="Escaneie o QR Code no WhatsApp Business">
    A Meta exibe um QR Code. No dispositivo do número a ser conectado, abra o WhatsApp Business (na versão mais recente), procure a mensagem da **Conta empresarial do Facebook oficial** e toque em **Ler QR code** para escanear e concluir o pareamento.

    <Frame>
      <img src="https://mintcdn.com/moradaai-f7bfc739/JRWzsJdZRQ7PfNtQ/images/talk/coexistencia-qr-code.png?fit=max&auto=format&n=JRWzsJdZRQ7PfNtQ&q=85&s=c2de67dfe88edb1992c7a8179a45f888" alt="Tela do QR Code para escanear no WhatsApp Business" width="606" height="714" data-path="images/talk/coexistencia-qr-code.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Mantenha o dispositivo do número a ser conectado em mãos durante todo o processo — o pareamento exige acesso ao WhatsApp Business para escanear o QR Code.
</Tip>

## Como acessar as conversas de Coexistência

Há duas formas de acessar as conversas espelhadas:

* **Pelo menu de ações do usuário externo:** na tela de **Gerenciar → Usuários → Usuários externos**, clique no menu de ações da linha do usuário e selecione **Ver conversas**.
* **Pelo filtro de conversas:** na página de **Conversas**, abra o painel **Filtrar** e selecione o usuário em **Usuários externos** para listar apenas as conversas espelhadas daquele número.

<Frame>
  <img src="https://mintcdn.com/moradaai-f7bfc739/JRWzsJdZRQ7PfNtQ/images/talk/coexistencia-filtro-conversas.png?fit=max&auto=format&n=JRWzsJdZRQ7PfNtQ&q=85&s=43893466a78858d7b756581992502a78" alt="Filtro de Usuários externos na página de Conversas" width="1260" height="1079" data-path="images/talk/coexistencia-filtro-conversas.png" />
</Frame>

***

## FAQ

<AccordionGroup>
  <Accordion title="O cliente final percebe alguma diferença?">
    Não. A conversa continua no WhatsApp do corretor exatamente como antes — sem mudança de número, perfil ou comportamento.
  </Accordion>

  <Accordion title="Funciona com WhatsApp comum, sem Business?">
    Não. É obrigatório o uso de WhatsApp Business — o WhatsApp pessoal padrão não suporta o pareamento.
  </Accordion>

  <Accordion title="Por que o limite é de 20 números por WABA?">
    É uma limitação técnica atual da plataforma WhatsApp Business. Operações maiores podem ser distribuídas em múltiplas contas WABA.
  </Accordion>

  <Accordion title="O pareamento exige autorização do corretor?">
    Sim. A Coexistência só funciona após o corretor autorizar explicitamente o pareamento do número.
  </Accordion>

  <Accordion title="Posso usar os templates da operação no número pareado?">
    Não. Cada número precisa do próprio template aprovado pela Meta. Crie e submeta um template específico para o número pareado — depois de aprovado, ele fica disponível no Talk.
  </Accordion>
</AccordionGroup>