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

# Conectar um número de API

> Guia passo a passo para vincular seu número de telefone à WhatsApp Business Platform usando o fluxo de conexão integrado.

## Antes de começar

Certifique-se de ter o seguinte em mãos:

* **Uma conta do Facebook** (pessoal ou empresarial) — você vai precisar dela para se autenticar.
* **O número de telefone** que deseja usar no WhatsApp Business. Pode ser um número existente ou um novo. Se já estiver usando na app do WhatsApp ou WhatsApp Business, o fluxo pedirá confirmação para migrá-lo.
* **Acesso ao número** para receber um código de verificação por SMS ou ligação.
* **O nome do seu negócio** como você quer que apareça no WhatsApp ao enviar mensagens para seus clientes.

## Passo a passo

<Steps>
  <Step title="Iniciar o processo">
    No MINDO, vá em **Configurações** → **Canais** e clique em **+ Conectar WhatsApp Business API**.

    <Frame caption="Seção de Canais nas configurações do MINDO">
      <img src="https://mintcdn.com/mindo/DthqHmuwOaheoaqM/images/conexion-whatsapp-canales.png?fit=max&auto=format&n=DthqHmuwOaheoaqM&q=85&s=9fa22dd14739ec4ae6c71da2fc3f7bdc" alt="Seção de canais no MINDO" width="2910" height="1564" data-path="images/conexion-whatsapp-canales.png" />
    </Frame>
  </Step>

  <Step title="Fazer login com o Facebook">
    Uma nova janela do Meta/Facebook será aberta.

    * Se você já estiver logado, clique em **"Continuar como \[seu nome]"**.
    * Caso contrário, insira seu e-mail e senha do Facebook.

    <Frame caption="Janela de login do Facebook">
      <img src="https://mintcdn.com/mindo/DthqHmuwOaheoaqM/images/conexion-whatsapp-facebook-login.png?fit=max&auto=format&n=DthqHmuwOaheoaqM&q=85&s=c6b189656417f8496d8f902d1b29708a" alt="Login do Facebook" width="1028" height="1354" data-path="images/conexion-whatsapp-facebook-login.png" />
    </Frame>

    <Note>
      Use a conta do Facebook vinculada ao seu negócio. Se não tiver uma, pode usar sua conta pessoal — depois você poderá criar um novo portfólio de negócios.
    </Note>
  </Step>

  <Step title="Aceitar permissões">
    Você verá uma tela mostrando as permissões que a plataforma receberá. Geralmente incluem:

    * Gerenciar sua conta do WhatsApp Business.
    * Enviar e receber mensagens em seu nome.

    Clique em **"Começar"** ou **"Get Started"** para continuar.
  </Step>

  <Step title="Selecionar ou criar seu Portfólio de Negócios">
    Você tem duas opções:

    * **Selecionar um existente:** Se você já tem um portfólio de negócios no Meta (por exemplo, porque gerencia anúncios no Facebook/Instagram), selecione-o na lista.
    * **Criar um novo:** Se é a primeira vez, preencha os dados do seu negócio: nome da empresa, endereço, site, etc.

    <Frame caption="Seleção do Business Portfolio e conta do WhatsApp Business">
      <img src="https://mintcdn.com/mindo/DthqHmuwOaheoaqM/images/conexion-whatsapp-business-portfolio.png?fit=max&auto=format&n=DthqHmuwOaheoaqM&q=85&s=492cf50143cf8bed5af5167c5480624c" alt="Seleção do Business Portfolio" width="1014" height="1344" data-path="images/conexion-whatsapp-business-portfolio.png" />
    </Frame>

    Clique em **"Continuar"**.
  </Step>

  <Step title="Selecionar ou criar sua Conta do WhatsApp Business">
    * **Selecionar uma existente:** Se você já tem uma conta do WhatsApp Business vinculada ao seu portfólio, escolha-a.
    * **Criar uma nova:** Insira o nome que identificará esta conta (geralmente o nome da sua empresa).

    Clique em **"Continuar"**.
  </Step>

  <Step title="Adicionar seu número de telefone">
    1. Selecione o **código do país** (ex: +55 para Brasil).
    2. Insira seu **número de telefone** completo.
    3. Insira o **nome visível (Display Name)** — é o nome que seus clientes verão quando você enviar mensagens. Por exemplo: "Zizou Mates", "Blanco Store", etc.

    <Warning>
      **Sobre o Display Name:** A Meta analisa se o nome está de acordo com suas políticas. Use o nome real do seu negócio, sem caracteres especiais desnecessários, sem tudo em maiúsculas e sem palavras genéricas como "Marketing" ou "Vendas" sozinhas.
    </Warning>

    <Warning>
      **Se seu número já está no WhatsApp ou WhatsApp Business App:** O fluxo avisará e pedirá confirmação para migrar o número para a API. Ao confirmar, esse número deixará de funcionar no app do WhatsApp no celular e passará a operar exclusivamente pela plataforma.
    </Warning>
  </Step>

  <Step title="Verificar seu número">
    A Meta enviará um **código de verificação de 6 dígitos** para confirmar que você é o dono do número.

    Você pode escolher recebê-lo por:

    * **SMS** (mensagem de texto)
    * **Ligação de voz**

    Insira o código recebido e clique em **"Verificar"**.

    <Note>
      Se escolher SMS e não chegar em 1-2 minutos, tente a opção de ligação de voz.
    </Note>
  </Step>

  <Step title="Confirmação">
    Se tudo correu bem, você verá uma tela de sucesso. A janela fecha automaticamente e você retorna ao MINDO.

    Seu número já está conectado. A partir daí, a plataforma cuida do restante da configuração técnica.
  </Step>
</Steps>

## O que acontece depois?

* **A Meta analisa seu negócio** para confirmar que está em conformidade com as políticas do WhatsApp. Se houver algum problema, entrarão em contato nas próximas 24 horas.
* **Seu número fica ativo** e pronto para enviar e receber mensagens pela plataforma.
* **Você pode acessar o WhatsApp Manager** em [business.facebook.com](https://business.facebook.com) para ver sua conta, configurar seu perfil comercial (logo, descrição, horários, etc.) e gerenciar templates de mensagens.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Posso usar um número que já tem WhatsApp pessoal?">
    Sim, mas ao conectá-lo à plataforma, esse número deixa de funcionar no app do WhatsApp no celular. Todos os chats são gerenciados pela plataforma.
  </Accordion>

  <Accordion title="Posso usar um número fixo?">
    Sim. Na etapa de verificação, escolha a opção de "ligação de voz" para receber o código.
  </Accordion>

  <Accordion title="E se eu errar o nome visível?">
    É possível alterá-lo depois pelo WhatsApp Manager, mas cada alteração requer uma nova aprovação da Meta, então é melhor escolher bem desde o início.
  </Accordion>

  <Accordion title="Preciso de uma conta do Facebook para isso?">
    Sim. É um requisito da Meta para autenticar sua identidade e vincular os ativos do WhatsApp a um portfólio de negócios.
  </Accordion>

  <Accordion title="Posso conectar mais de um número?">
    Sim, você pode ter múltiplos números dentro da mesma conta do WhatsApp Business. Cada número é conectado individualmente repetindo este mesmo processo.
  </Accordion>

  <Accordion title="Quanto tempo leva o processo?">
    Geralmente entre 3 e 5 minutos se você tiver tudo pronto.
  </Accordion>

  <Accordion title="Há algum custo para conectar o número?">
    Conectar o número é gratuito. Os custos são gerados depois pelas conversas (mensagens enviadas/recebidas), de acordo com o modelo de preços por conversa da Meta.
  </Accordion>
</AccordionGroup>