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

# Conectar WhatsApp

> Guia passo a passo para conectar seu número do WhatsApp Business ao Tipefy usando a API Oficial da Meta, incluindo migração de número e verificação do canal.

O Tipefy utiliza a API Oficial do WhatsApp Business, operada pela infraestrutura de Business Solution Provider (BSP) da Meta. Isso significa que o seu número se conecta diretamente pela Meta, oferecendo mensagens estáveis, conformes e multi-atendente, sem risco de bloqueios ou desconexões.

<Note>
  Você pode usar seu número de telefone atual. O WhatsApp suporta coexistência, então é possível migrar um número que está no aplicativo WhatsApp Business para a API sem perdê-lo.
</Note>

## Antes de começar

<CardGroup cols={2}>
  <Card title="Conta ativa no Tipefy" icon="user-check">
    Crie uma conta ou faça login em [app.tipefy.com](https://app.tipefy.com).
  </Card>

  <Card title="Conta no Meta Business" icon="building">
    Você precisa de uma conta verificada no Meta Business Manager para concluir a conexão.
  </Card>

  <Card title="Número de telefone" icon="phone">
    Um número de sua propriedade (móvel ou fixo) que ainda não esteja registrado na API do WhatsApp Business.
  </Card>

  <Card title="Verificação de plano" icon="layers">
    Os planos Starter e Basic incluem 1 canal do WhatsApp. O Pro inclui até 2. Canais adicionais podem ser solicitados via suporte.
  </Card>
</CardGroup>

## Conectar seu número

<Steps>
  <Step title="Abrir as configurações de canais">
    Em [app.tipefy.com](https://app.tipefy.com), acesse **Canais** no menu lateral esquerdo.
  </Step>

  <Step title="Adicionar um novo canal">
    Clique em **+** e selecione **Conectar WhatsApp**.

    <Frame>
      <img src="https://mintcdn.com/orbe-4cb8e231/YzAuN1Z4srcMVlfL/images/image.png?fit=max&auto=format&n=YzAuN1Z4srcMVlfL&q=85&s=455016c16b95afc7f08a6b181b3ac8e4" alt="Image" width="3402" height="1734" data-path="images/image.png" />
    </Frame>
  </Step>

  <Step title="Iniciar o fluxo de conexão com a Meta">
    A Tipefy apresenta duas formas de conexão. Escolha a que melhor se encaixa no seu perfil:

    <Frame>
      <img src="https://mintcdn.com/orbe-4cb8e231/YzAuN1Z4srcMVlfL/images/image-1.png?fit=max&auto=format&n=YzAuN1Z4srcMVlfL&q=85&s=662dae7de2a72d456fa7f8313ad42b74" alt="Image" width="3390" height="1640" data-path="images/image-1.png" />
    </Frame>

    * **Conectar um novo canal de forma manual**\
      Indicada para quem já possui um **WhatsApp Business API** configurado e tem em mãos as credenciais técnicas (Token de acesso, Phone Number ID e WhatsApp Business Account ID). Neste fluxo, você insere os dados manualmente, sem depender do login pelo Facebook.
          <Note>
            Use esta opção se você é um usuário técnico ou já passou pelo processo de criação do app no Meta Business Manager.
          </Note>
    * **Conectar um novo canal através do cadastro incorporado no Facebook**\
      **A forma mais simples e recomendada para a maioria dos usuários**. Ao selecionar esta opção, a Tipefy abre o **fluxo oficial do Facebook** (Embedded Signup), onde você:
      1. Faz login na sua conta do Facebook/Meta
      2. Associa ou cria uma conta do WhatsApp Business
      3. Autoriza a Tipefy a gerenciar o número Ao selecionar a opção será apresentado a seguinte tela:
          <Frame>
            <img src="https://mintcdn.com/orbe-4cb8e231/YzAuN1Z4srcMVlfL/images/image-4.png?fit=max&auto=format&n=YzAuN1Z4srcMVlfL&q=85&s=11e1c4acc1970ada73deff3193eb53e0" alt="Image" width="2531" height="1136" data-path="images/image-4.png" />
          </Frame>
      \
      Preencha a opção **Tenho acesso total ao Meta Business Manager da minha empresa**, será habilitado o botão **Continuar com o Facebook.**  Ao selecionar a opção de **Continuar com o Facebook**, uma janela do Facebook será aberta apresentando a tela de autorização da integração com a Tipefy.
          <Frame>
            <img src="https://mintcdn.com/orbe-4cb8e231/YzAuN1Z4srcMVlfL/images/image-7.png?fit=max&auto=format&n=YzAuN1Z4srcMVlfL&q=85&s=b5c6a4b5b06f6145969e30819a9945d7" alt="Image" width="556" height="700" data-path="images/image-7.png" />
          </Frame>

    Nesta tela, a Meta informa o que será possível fazer após a conexão:

    * Enviar e receber mensagens em grande escala via API de Nuvem (Cloud API)
    * Gerenciar conversas de forma automatizada
    * Lidar com grandes volumes de mensagens com facilidade
    * Reduzir custos com SMS e ligações de voz

    Clique em **Continuar** para seguir com o fluxo do cadastro incorporado.
  </Step>

  <Step title="Selecionar os ativos de negócios">
    O próximo passo se trata de selecionar os ativos de negócios. Nesta etapa, você vincula a Tipefy à sua estrutura de negócios na Meta. Dois campos precisam ser preenchidos:

    * **Portfólio empresarial:** Selecione o portfólio (conta empresarial) do Meta Business Manager ao qual o número será associado. Se você possui apenas um, ele já aparecerá selecionado automaticamente.
    * **Conta do WhatsApp Business** Neste campo você tem duas opções:
      * **Criar uma conta do WhatsApp Business**: cria uma nova WABA do zero e associa o número diretamente à Tipefy. Recomendado para quem ainda não possui uma conta configurada.
      * **Conectar um app do WhatsApp Business:** também chamado de **Coexistência**. Esta opção é indicada para quem já utiliza o **WhatsApp Business App** (o aplicativo comum do celular) e quer continuar usando o app normalmente, ao mesmo tempo em que aproveita os recursos da Tipefy via API.

    <Note>
      **O que é Coexistência?** É um modo oficial da Meta que permite que um mesmo número opere simultaneamente no WhatsApp Business App e na API de Nuvem. Assim, você não precisa abandonar o uso do aplicativo para começar a usar a Tipefy.
    </Note>

    <Warning>
      **Atenção:** ao optar pela Coexistência, o fluxo de configuração seguinte será diferente. Você precisará escanear um **QR Code** pelo próprio WhatsApp Business App para confirmar o vínculo entre o número e a Tipefy. Certifique-se de ter o aplicativo em mãos antes de prosseguir.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/orbe-4cb8e231/YzAuN1Z4srcMVlfL/images/image-8.png?fit=max&auto=format&n=YzAuN1Z4srcMVlfL&q=85&s=b8e8f5398010539382410c6fdcfcefb5" alt="Image" width="556" height="733" data-path="images/image-8.png" />
    </Frame>
  </Step>

  <Step title="Adicionar o número de telefone">
    Caso tenha optado por criar uma nova conta do WhatsApp Business (sem Coexistência), esta tela será exibida para cadastrar o número que será utilizado na Tipefy.

    <Frame>
      <img src="https://mintcdn.com/orbe-4cb8e231/YzAuN1Z4srcMVlfL/images/image-10.png?fit=max&auto=format&n=YzAuN1Z4srcMVlfL&q=85&s=6ccf000c1a207693f8bf4a6b219bf98c" alt="Image" width="555" height="734" data-path="images/image-10.png" />
    </Frame>

    **Escolha o tipo de identificação:**

    * **Usar somente um nome de exibição**, o número não é exibido nas conversas, apenas o nome comercial cadastrado. Menos comum, indicado para casos específicos.
    * **Adicionar um novo número** *(recomendado)* — cadastra um número de telefone real que será verificado pela Meta.

    **Telefone** Selecione o código do país (BR +55) e insira o número que deseja conectar. Este número receberá um código de verificação.

    <Warning>
      **Importante:** o número informado não pode estar em uso ativo no WhatsApp comum ou no WhatsApp Business App. Caso esteja, utilize a opção de Coexistência descrita no passo anterior.
    </Warning>

    **Verificação do número** Escolha como deseja receber o código de verificação:

    * **SMS** — um código será enviado por mensagem de texto
    * **Ligação telefônica** — um código será lido por voz (recomendado para números fixos)

    Após preencher todos os campos, clique em **Avançar** para receber o código e concluir a verificação.
  </Step>

  <Step title="Inserir o código de verificação">
    Digite o código de 6 dígitos recebido. Após a confirmação, seu número estará registrado na API do WhatsApp Business.
  </Step>

  <Step title="Revisar e confirmar as permissões">
    Antes de concluir, a Meta exibe um resumo de tudo que será compartilhado com a Tipefy. Nesta tela você verá:

    <Frame>
      <img src="https://mintcdn.com/orbe-4cb8e231/YzAuN1Z4srcMVlfL/images/image-11.png?fit=max&auto=format&n=YzAuN1Z4srcMVlfL&q=85&s=911b275de887b03fb120d903d1cca831" alt="Image" width="561" height="743" data-path="images/image-11.png" />
    </Frame>

    <Note>
      Estas permissões são necessárias para que a Tipefy possa enviar e receber mensagens, gerenciar campanhas e automatizar atendimentos em seu nome.
    </Note>

    Clique em **Confirmar** para autorizar o acesso e finalizar a integração.
  </Step>

  <Step title="Conexão concluída">
    Após confirmar as permissões, a tela de conclusão será exibida com a mensagem **"Sua conta está conectada a Tipefy"**.

    <Frame>
      <img src="https://mintcdn.com/orbe-4cb8e231/YzAuN1Z4srcMVlfL/images/image-12.png?fit=max&auto=format&n=YzAuN1Z4srcMVlfL&q=85&s=b1bc1a7346de32b707f1255d8eb2f75f" alt="Image" width="557" height="742" data-path="images/image-12.png" />
    </Frame>

    A Meta informará que sua empresa será analisada para garantir conformidade com a Política Comercial do WhatsApp. Caso haja alguma pendência, você será notificado em até 24 horas.

    Nesta tela você terá duas opções:

    * **Adicionar forma de pagamento** — redireciona para o Meta Business Manager para cadastrar um método de pagamento na sua WABA. Isso é necessário para que o envio de mensagens funcione corretamente após o período gratuito da Meta.
    * **Concluir** — fecha o fluxo e retorna à Tipefy com o canal já conectado.

    <Note>
      **Recomendamos** clicar em **Adicionar forma de pagamento** antes de concluir para evitar interrupções no envio de mensagens. Porém, caso opte por não cadastrar no momento é possível usar o link **Configurações de Pagamento do WA** presente na edição do canal, ele direcionará para as configurações de pagamentos dentro de seu Meta Business Manager.
    </Note>
  </Step>

  <Step title="Retornar ao Tipefy">
    Após concluir o fluxo da Meta, você será redirecionado de volta ao Tipefy. Seu novo canal aparecerá na lista de **Canais** com o status **Conectado através do FACEBOOK**.

    <Frame>
      <img src="https://mintcdn.com/orbe-4cb8e231/ORp-WrOKxqXw9_iu/images/image-13.png?fit=max&auto=format&n=ORp-WrOKxqXw9_iu&q=85&s=703bc48e1a9a12ede782ff16086320fc" alt="Image" width="2479" height="739" data-path="images/image-13.png" />
    </Frame>
  </Step>

  <Step title="Confirmar conexões">
    Edite o canal criado, e confirme que o status da meta esteja com status **Conectado**.

    <Frame>
      <img src="https://mintcdn.com/orbe-4cb8e231/ORp-WrOKxqXw9_iu/images/image-16.png?fit=max&auto=format&n=ORp-WrOKxqXw9_iu&q=85&s=a5efceb1321b59b763a0ec8d4a248411" alt="Image" width="2540" height="986" data-path="images/image-16.png" />
    </Frame>

    Certifique que todas as pendências em Qualidade do Canal estejam concluídas como **Sem problemas**, caso houver alguma pendência será informado o motivo em Descrição e a ação recomendada.

    <Frame>
      <img src="https://mintcdn.com/orbe-4cb8e231/ORp-WrOKxqXw9_iu/images/image-15.png?fit=max&auto=format&n=ORp-WrOKxqXw9_iu&q=85&s=b69165b330fafb079e90294364e58257" alt="Image" width="2522" height="1045" data-path="images/image-15.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Todo o processo de configuração costuma levar menos de 10 minutos quando a conta no Meta Business já está pronta.
</Tip>

## O que acontece após a conexão

Com o canal ativo, você poderá:

* Receber e responder mensagens recebidas pela caixa de entrada compartilhada em Conversas
* Configurar fluxos de automação para responder mensagens automaticamente
* Enviar campanhas em massa usando modelos de mensagem aprovados pela Meta

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Posso usar um número que já está no aplicativo WhatsApp Business?">
    Sim. A Meta suporta o modo de **Coexistência**, que permite usar o mesmo número simultaneamente no aplicativo WhatsApp Business e na API. Durante o fluxo de registro, basta selecionar a opção **"Conectar um app do WhatsApp Business"** no Passo 2 e seguir as instruções na tela, que incluem a leitura de um QR Code pelo próprio aplicativo para confirmar o vínculo. Ao contrário de uma migração tradicional, o número **não é desvinculado do app**, você continua usando os dois em paralelo.
  </Accordion>

  <Accordion title="Vários atendentes podem usar o mesmo número?">
    Sim. Essa é uma das principais vantagens da API do WhatsApp Business. Vários atendentes podem gerenciar conversas no mesmo número ao mesmo tempo, sem risco de bloqueio ou desconexão.
  </Accordion>

  <Accordion title="Como adicionar um segundo canal do WhatsApp?">
    Usuários do plano Pro podem conectar até 2 canais diretamente em Canais. Se precisar de mais canais além do limite do seu plano, entre em contato com o suporte do Tipefy pela plataforma.
  </Accordion>

  <Accordion title="O que fazer se meu número não passar na verificação?">
    Verifique se o número não está registrado ativamente na API do WhatsApp Business por outro provedor. Caso esteja, é necessário liberá-lo do provedor anterior antes de conectá-lo ao Tipefy.
  </Accordion>
</AccordionGroup>