Conectar linha WhatsApp

Este guia é para usuários de negócios. Você não precisa de um número novo — conecte a linha WhatsApp Business que já usa com clientes.

Por onde começar Painel → Conectar linha WhatsApp (página de conexão). A mesma tela aparece no onboarding.

Três opções de conexão

A página tem três abas; a maioria das empresas precisa apenas da primeira.

Tenho um número existente (recomendado)

Sua linha do app WhatsApp Business é vinculada à Cloud API pela janela oficial da Meta. Não adicione um número novo.

Clique em Conectar meu número WhatsApp existente (ou o botão azul da Meta no onboarding) e entre com Facebook.
Selecione da lista o número comercial que você já usa.
Confirme; o Convord salva o token e o Phone Number ID. Verifique com Testar conexão.

Se o botão azul estiver ausente, use a aba Configuramos para você ou contate o suporte Convord.

Configuramos para você (concierge)

Deixe seu telefone e horário preferido. O Convord orienta você na Meta; você só aprova na interface da Meta.

Avançado / manual

Cole IDs da Meta Developers ou da sua agência. Para equipe técnica ou usuários experientes.

Preencha Phone Number ID e Access token.
Opcionalmente, WABA ID pode ajudar a completar a conexão. IDs da Meta são exibidos no formulário.

Após conectar

Você deve ver Sua linha está conectada no painel.
Use Testar conexão para confirmar que a Meta retorna seu número.
Envie uma mensagem de teste no WhatsApp; deve aparecer em Mensagens e no fluxo de pedidos.

Renovação de token

Access tokens da Meta podem expirar. Se vir Token expirado:

Reconecte via Tenho um número existente (escolha o mesmo número), ou
Cole um novo access token na aba manual. Prefira token de System User (longa duração) quando possível.

Meta Business Portfolio

Sua linha WhatsApp deve estar no seu Meta Business Portfolio. Nem todo funcionário precisa ser adicionado.

Usuários do painel Convord e clientes que enviam WhatsApp não precisam de acesso ao portfolio.
Uma ou poucas pessoas que gerenciam WABA e números na Meta são suficientes.

Avisos de segurança da Meta

business.facebook.com → Central de segurança pode mostrar sugestões de passkey ou e-mail corporativo. Não bloqueiam a conexão WhatsApp por si só.

Passkey

accountscenter.facebook.com → Senha e segurança → Adicionar passkey.
Cada usuário do portfolio listado no relatório de segurança deve adicionar passkey na própria conta.
O aviso pode levar 24–72 horas para desaparecer.

Aviso de e-mail Gmail / iCloud

A Meta recomenda e-mail corporativo para admins do portfolio. Não é obrigatório; funcionários com Gmail não disparam isso se não estiverem no portfolio.

Erro «Já está no Business Portfolio»

Ao aceitar um link de convite:

Entre com a conta Facebook correta em uma janela privada.
Se já for membro, o convite é desnecessário — verifique a lista de usuários.
Empresas clientes devem usar seu próprio portfolio; entrar no portfolio Convord não é necessário.

Se realmente precisar de um número novo

A maioria das configurações não precisa. Apenas ao abrir uma linha totalmente nova:

business.facebook.com → WhatsApp Manager → nova conta WhatsApp Business.
Números de telefone → adicionar e verificar por SMS/ligação.
Depois conecte pelo Convord via Tenho um número existente.

Problemas comuns

Sintoma	O que fazer
Sem botão azul «conectar meu número»	Use a aba Configuramos para você ou cole token manual; contate suporte Convord se necessário.
Conectado mas sem mensagens	Teste a conexão; renove o token; confirme que mensagens vão ao número certo.
Token expirado	Use Renovar token → reconecte via Meta.
Aviso passkey / Gmail	Veja seção de segurança acima; não impede o trabalho diário.
Não é possível aceitar convite	Conta FB errada, janela privada ou já membro.