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

# Conectar WhatsApp

> Conecte seu WhatsApp à LiveClin pelo plano Escalar: leia o QR Code, personalize as mensagens e reduza o risco de bloqueio do seu número.

<iframe className="w-full rounded-xl" style={{ aspectRatio: "16 / 9" }} src="https://www.youtube.com/embed/gSst_453dCg" title="Tutorial: conectar seu WhatsApp à LiveClin pelo plano Escalar" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

No plano Escalar você conecta o seu WhatsApp à LiveClin lendo um QR Code. A partir daí, o envio dos questionários, o lembrete de resposta e o lembrete de vencimento de plano saem do seu próprio número, e não do número do sistema.

## Pré-requisitos

Antes de começar, você precisa de:

* Uma assinatura do **plano Escalar**.
* O celular com o WhatsApp que você quer conectar, em mãos.

## O que muda ao usar o seu número

**Mais adesão.** O paciente vê que a mensagem veio de você, e não de um número de terceiro. Isso tende a aumentar a taxa de resposta aos questionários.

**Sem confirmação de número.** No plano Pro, o paciente precisa mandar uma mensagem para o assistente confirmando que o número é dele. Como aqui a mensagem parte do seu próprio número, essa etapa deixa de existir — um passo a menos de atrito entre o paciente e o questionário.

**Mensagens personalizadas.** O número compartilhado da LiveClin usa textos padronizados, iguais para todos os profissionais. Com o seu número conectado, você escreve as suas próprias mensagens.

## Como a LiveClin envia pelo seu número

Existem duas formas de enviar mensagens a partir de um número próprio, e elas têm trocas diferentes.

|                          | API oficial (Meta)                                 | API não oficial                                        |
| ------------------------ | -------------------------------------------------- | ------------------------------------------------------ |
| Custo                    | Variável, cobrado por mensagem enviada             | Fixo, independe do volume                              |
| Risco de bloqueio        | Menor, é um serviço verificado pelo Meta           | Maior, o número pode ser derrubado se houver denúncias |
| Configuração             | Complexa, exige conhecimento de fluxo de automação | Ler um QR Code na tela                                 |
| Onde aparece na LiveClin | Plano Pro, por sua conta, via webhooks             | Plano Escalar, já configurado                          |

O plano Escalar usa a **API não oficial**, através da Z-API, um serviço brasileiro que faz a conexão com o WhatsApp pelo QR Code. Ela custa cerca de R\$ 100, e esse valor já está embutido na mensalidade do plano — é parte do motivo de o Escalar ser mais caro que o Pro.

<Note>
  A escolha pela API não oficial é pelo custo fixo. Na API oficial, o Meta classifica cada mensagem e cobra de acordo. Numa simulação com 25 pacientes recebendo questionário todos os dias, a conta fica em torno de R\$ 26 enquanto o Meta tratar o envio como mensagem de **utilidade**. Se ele reclassificar o mesmo envio como **marketing**, o custo pula para R\$ 243.
</Note>

Essa reclassificação acontece sem aviso e exige revisão constante. A LiveClin usa a API oficial no número compartilhado e revisa os modelos toda semana justamente para que isso não aconteça. Se você quiser usar a API oficial por conta própria, ela está disponível no plano Pro através de webhooks, mas só vale a pena se a segurança extra for prioridade e você tiver conforto técnico com automações.

## Como conectar o seu número

<Steps>
  <Step title="Abra as integrações">
    Na barra lateral, vá em **Configurações → Integrações** e localize o campo do WhatsApp.
  </Step>

  <Step title="Gere o QR Code">
    Clique para exibir o QR Code. Ele aparece na tela quando ainda não há nenhum número conectado.
  </Step>

  <Step title="Leia com o celular">
    Aponte a câmera do celular para a tela e conclua a conexão pelo WhatsApp, como você faria no WhatsApp Web.
  </Step>
</Steps>

Feita a conexão, todos os envios passam a sair do seu número.

## Como personalizar as mensagens

Vá em **Lembretes** e escolha o tipo de mensagem que quer editar. Clique no balão ao lado do tipo para criar os modelos que serão enviados aos seus pacientes.

Dentro do modelo você insere variáveis que a LiveClin substitui na hora do envio:

* **Primeiro nome do paciente**, que aparece como `[Client First Name]` no editor.
* **Título do questionário**.
* **Data de vencimento do questionário**.

Um modelo fica assim:

> Olá, `[Client First Name]`! Seu questionário está pronto para ser respondido.

Abaixo da mensagem, o paciente recebe o botão para responder o questionário.

Você personaliza os três tipos de mensagem de forma independente: **novo questionário**, **serviço finalizado** e **lembrete de resposta**.

## Como reduzir o risco de bloqueio

Como a API não oficial não é um serviço verificado pelo Meta, existe risco de o número ser bloqueado se o envio parecer automação em massa. Duas práticas reduzem bastante esse risco.

### Cadastre pelo menos dez modelos por tipo de mensagem

A LiveClin sorteia um modelo diferente para cada paciente no momento do envio. Com dez modelos cadastrados, cinquenta pacientes recebem textos variados em vez da mesma mensagem repetida, e fica mais difícil o Meta identificar um padrão de automação.

<Tip>
  O botão **GPT** abre um agente que gera modelos prontos. Ele pergunta se você é homem ou mulher para ajustar a escrita, e devolve dez mensagens por rodada. Basta copiar e colar na LiveClin.
</Tip>

### Espalhe os horários de envio

Ao vincular o questionário a um paciente, mude o horário em alguns minutos em relação aos demais. Se você costuma enviar às 07h00, use 07h05 para um paciente, 07h08 para outro, 07h12 para o seguinte.

Não é preciso reorganizar toda a base de uma vez. Vá ajustando conforme cadastra pacientes novos. O efeito é que os questionários deixam de sair todos no mesmo minuto, o que também afasta a leitura de spam.

<Warning>
  O risco de bloqueio é reduzido por essas práticas, mas não é zero. Evite disparar questionários para quem não é seu paciente: denúncias são o caminho mais rápido para o número ser derrubado.
</Warning>

## Resultado esperado

Seu WhatsApp conectado à LiveClin, com os questionários e lembretes saindo do seu próprio número, mensagens escritas por você e um conjunto de modelos variados que mantém a saúde da sua linha.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Agendar envios" icon="calendar-clock" href="/pt-BR/tutoriais/questionarios/agendar-envios">
    Programe a frequência e o horário de envio de cada paciente.
  </Card>

  <Card title="Configurar envios" icon="send" href="/pt-BR/boas-praticas/configurar-envios">
    Que dia enviar, prazo de resposta e o contrato de uso com o paciente.
  </Card>
</CardGroup>
