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

# Troubleshooting WABA

> Erros comuns ao conectar o WhatsApp Business API no Talk AI e como resolver.

Esta página reúne os problemas mais frequentes durante a conexão de um canal WABA e como resolvê-los. Se ainda não começou, comece pelo [Onboarding WABA](/canais/waba-onboarding).

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Não aparece nenhum número na seleção">
    Causas mais comuns:

    * A WABA ainda não tem nenhum número provisionado. Confira em **Meta Business → WhatsApp Manager → Números**.
    * O usuário que autenticou não tem permissão de admin sobre a WhatsApp Business Account. Confirme as permissões em **Meta Business → Configurações → Contas → WhatsApp Accounts**.
    * O número está vinculado a outra Business Account. Você só verá os números da Business em que tem acesso.
  </Accordion>

  <Accordion title="Erro ao autorizar com a Meta">
    Geralmente significa que a conta Meta usada no popup OAuth não tem permissão de administrador na Meta Business ou na WhatsApp Business Account. Faça login com uma conta que seja admin ou peça ao admin para conceder as permissões necessárias.
  </Accordion>

  <Accordion title="O número aparece, mas dá erro ao salvar">
    Causas possíveis:

    * O token OAuth expirou durante o processo. Refaça a conexão desde o início.
    * O número foi removido da WABA entre a seleção e o salvamento. Confirme em **WhatsApp Manager** que o número ainda está disponível.
    * O canal já está conectado a outra instância do Talk AI. Desconecte do canal anterior antes de reconectar.
  </Accordion>

  <Accordion title="Posso usar o mesmo número do meu WhatsApp pessoal?">
    Não. Um número só pode estar em **um** dos seguintes ao mesmo tempo: WhatsApp pessoal, WhatsApp Business (app verde) ou WhatsApp Business API (WABA). Para usar no Talk AI, o número precisa estar livre dos dois primeiros.
  </Accordion>

  <Accordion title="Posso portar meu número atual para a WABA?">
    Sim. A portabilidade é feita pelo BSP ou pela Meta diretamente, e exige que você primeiro **desvincule** o número do app atual (pessoal ou Business). Depois da desvinculação, o BSP/Meta registra o número na WABA.

    Atenção: durante a portabilidade, o número fica indisponível por algumas horas. Avise sua equipe.
  </Accordion>

  <Accordion title="Quanto tempo leva o processo completo?">
    Estimativas realistas:

    * **Verificação da empresa pela Meta:** poucas horas a vários dias úteis
    * **Provisionamento de número novo via BSP:** 1 a 5 dias úteis
    * **Portabilidade de número existente:** 3 a 10 dias úteis
    * **Conexão no Talk AI (após número pronto):** poucos minutos

    Planeje com pelo menos duas semanas de margem se precisar portar um número.
  </Accordion>

  <Accordion title="Meu rating de qualidade caiu? O que faço?">
    A Meta atribui um rating de qualidade ao número com base em respostas dos usuários (bloqueios, denúncias). Para recuperar:

    * Reduza o volume temporariamente
    * Revise templates: evite linguagem promocional agressiva
    * Garanta opt-in claro antes de enviar mensagens
    * Responda rapidamente às mensagens recebidas

    O rating se recupera com o tempo se o comportamento melhorar.
  </Accordion>
</AccordionGroup>

## Ainda com problemas?

Se nada acima resolveu, entre em contato com o suporte do Talk AI informando:

* Nome da empresa e e-mail da conta Meta usada
* Mensagem de erro exata (print é o ideal)
* Em qual passo o problema aconteceu