LinkZap

Conectar números

.md

API oficial com o seu app da Meta

Enquanto a conexão pela janela da Meta não está aberta para todos, você pode ligar um número oficial do WhatsApp usando um app que é SEU na Meta. Leva uns 20 minutos, uma vez só. Você gera as chaves, cola no LinkZap e nós conferimos e ligamos o resto.

Antes de começar

  • Um portfólio empresarial na Meta (o antigo Gerenciador de Negócios), em business.facebook.com, com você como administrador.
  • Um número que não esteja em uso no app do WhatsApp (nem no WhatsApp Business do celular). Ao entrar na API oficial, ele deixa de funcionar no aplicativo.
  • Um cartão para a Meta cobrar as conversas. A conta de mensagens é sua, cobrada pela Meta; o LinkZap cobra só a assinatura.

O número sai do celular

Um número registrado na API oficial não abre mais no app do WhatsApp. Se o número que você quer usar está hoje no celular, use um chip novo ou fale com o suporte antes.

Passo a passo

  1. 1

    Crie o app

    Em developers.facebook.com/apps, clique em Criar app. Escolha o caso de uso do WhatsApp (ou Outro → Empresa e, depois, adicione o produto WhatsApp) e ligue o app ao seu portfólio empresarial.

  2. 2

    Adicione o número

    No app, abra WhatsApp → Configuração da API e clique em Adicionar número de telefone. Preencha o nome de exibição e a categoria do negócio e confirme o código por SMS ou ligação.

    Na mesma tela ficam os dois números que o LinkZap pede: o ID do número de telefone e o ID da conta do WhatsApp Business. Anote os dois. Eles são sequências de dígitos, não o telefone em si.

  3. 3

    Cadastre a forma de pagamento

    No WhatsApp Manager, em Configurações da conta → Forma de pagamento, cadastre o cartão. Sem ele a Meta não deixa iniciar conversas.

  4. 4

    Publique o app e copie as chaves dele

    Em Configurações do app → Básico, preencha a URL da Política de Privacidade (pode ser a da sua empresa, ou https://linkzap.orion.moe/privacy) e salve. Depois, no topo do painel, mude o app para Ao vivo (publicado).

    Na mesma tela, copie o ID do app e a Chave secreta do app (clique em Mostrar). A chave tem 32 letras e números.

  5. 5

    Crie o usuário do sistema e gere o token

    Em business.facebook.com/settings, abra Usuários → Usuários do sistema → Adicionar. Dê um nome (por exemplo, LinkZap) e a função Administrador.

    Com o usuário selecionado, clique em Atribuir ativos e dê controle total a dois ativos: o app que você criou e a conta do WhatsApp.

    Clique em Gerar novo token, escolha o app, marque a validade Nunca e as permissões whatsapp_business_management e whatsapp_business_messaging. Copie o token: ele aparece uma vez só.

    Não use o token da tela “Configuração da API”

    Aquele token é temporário e vence em 24 horas. O LinkZap recusa token com prazo, para o seu número não parar de falar amanhã.
  6. 6

    Cole no LinkZap

    Em Canais → Adicionar canal → WhatsApp Business Oficial com o seu app, cole os cinco dados: ID do app, chave secreta, token, ID da conta e ID do número.

    O LinkZap confere cada um e diz exatamente qual passo refazer se algo não bater. Você não precisa configurar webhook: nós gravamos o endereço no seu app. Se o número ainda não estiver registrado na API oficial, a tela pede a sua confirmação antes de registrar.

Depois de conectado

  • O número atende pela caixa como qualquer outro, com templates, janela de 24 horas e a Aura.
  • Não redefina a chave secreta do app nem apague o usuário do sistema. Se fizer isso, as mensagens param de chegar; na tela do canal, use Atualizar credenciais com os dados novos.
  • Quando a conexão pela janela da Meta abrir para todos, avisaremos. O número pode continuar como está.