---
title: "API oficial com o seu app"
slug: whatsapp-own-app
group: "Conectar números"
source: https://linkzap.orion.moe/developers/whatsapp-own-app
openapi: https://linkzap.orion.moe/openapi.json
---

# 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](https://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.

> [!WARNING]
> **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. Crie o app

Em [developers.facebook.com/apps](https://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. 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. Cadastre a forma de pagamento

No [WhatsApp Manager](https://business.facebook.com/wa/manage/home), em **Configurações da conta → Forma de pagamento**, cadastre o cartão. Sem ele a Meta não deixa iniciar conversas.

### 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. Crie o usuário do sistema e gere o token

Em [business.facebook.com/settings](https://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ó.

> [!WARNING]
> **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. 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á.