# Chat Pró Oratrix: Como conectar o WhatsApp Oficial pela API Cloud WABA

**URL:** https://ajuda.oratrixtelecom.com.br/t/chat-pro-oratrix-como-conectar-o-whatsapp-oficial-pela-api-cloud-waba/253
**Category:** Chatbot Pró da Oratrix
**Created:** [Julho 14, 2026, 6:08pm UTC](https://ajuda.oratrixtelecom.com.br/t/chat-pro-oratrix-como-conectar-o-whatsapp-oficial-pela-api-cloud-waba/253 "2026-07-14T18:08:53Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![Oratrix.Tecnologias](https://ajuda.oratrixtelecom.com.br/user_avatar/ajuda.oratrixtelecom.com.br/oratrix.tecnologias/32/346_2.png) [@Oratrix.Tecnologias](https://ajuda.oratrixtelecom.com.br/u/Oratrix.Tecnologias)
#### Post date: [Julho 14, 2026, 6:08pm UTC](https://ajuda.oratrixtelecom.com.br/t/chat-pro-oratrix-como-conectar-o-whatsapp-oficial-pela-api-cloud-waba/253/1 "2026-07-14T18:08:53Z")

</div>

# 🦜 SERVIÇO

**Serviço:** Chat Pró Oratrix

# 🛠 VOCÊ VAI PRECISAR

Antes de iniciar, tenha em mãos:

- Acesso de administrador ao **Chat Pró Oratrix**.
- Uma conta pessoal no Facebook com acesso ao ambiente empresarial da Meta.
- Acesso ao **Gerenciador de Negócios da Meta**.
- Um número de telefone que será utilizado no WhatsApp Oficial.
- Acesso ao número para receber um código por SMS ou ligação.
- Uma forma de pagamento cadastrada na Meta.
- Um computador com acesso à internet.
- Uma página pública com a Política de Privacidade da sua empresa.
- Uma página pública com os Termos de Serviço da sua empresa.
- Apoio de uma pessoa com conhecimento técnico para registrar o número pela API, caso necessário.

> ⚠ **Atenção:** este procedimento envolve configurações avançadas no ambiente da Meta. Faça cada etapa com cuidado e não compartilhe tokens, senhas ou códigos de segurança.

# 🧾 VISÃO GERAL

Neste tutorial, você aprenderá a criar uma integração com a **API Oficial do WhatsApp** , também conhecida como **Cloud API** ou **WABA** , e conectá-la ao Chat Pró Oratrix.

A API Oficial permite que sua empresa envie e receba mensagens pelo WhatsApp dentro do painel de atendimento, com maior estabilidade e seguindo as regras oficiais da Meta.

O procedimento é dividido em cinco partes:

1. Preparar a conta e o número.

2. Criar um aplicativo na Meta.

3. Cadastrar e verificar o número.

4. Gerar um token permanente.

5. Conectar o canal e configurar o recebimento das mensagens.

# 🧭 PASSO A PASSO GUIADO

## Etapa 1: Prepare o número de telefone

1. Escolha o número que será utilizado no WhatsApp Oficial.

2. Confirme que você consegue receber ligações ou mensagens SMS nesse número.

3. Verifique se o número já está sendo utilizado no aplicativo WhatsApp ou WhatsApp Business.

4. Caso o número esteja em uso no aplicativo, interrompa o procedimento e confirme com o suporte da Oratrix qual modalidade de conexão será utilizada.

> ⚠ Na configuração tradicional da API Cloud WABA, o mesmo número não pode continuar conectado normalmente ao aplicativo do WhatsApp.

1. Caso seja necessário remover a conta existente, abra o WhatsApp no celular.

2. Acesse **Configurações**.

3. Entre em **Conta**.

4. Selecione **Apagar minha conta**.

5. Leia os avisos apresentados e confirme somente quando tiver certeza de que o número será migrado para a API Oficial.

> ⚠ Apenas desinstalar o aplicativo não exclui a conta vinculada ao número.

1. Aguarde alguns minutos antes de iniciar o cadastro do número na Meta.

## Etapa 2: Crie um aplicativo na Meta

1. Abra o navegador no computador.

2. Acesse o portal **Meta for Developers** :

`https://developers.facebook.com/`

1. Clique em **Entrar**.

2. Faça login utilizando a conta do Facebook que possui acesso à empresa.

3. Na parte superior da tela, clique em **Meus aplicativos**.

4. Clique em **Criar aplicativo**.

5. Quando o sistema perguntar o que você deseja fazer, selecione **Outros**.

6. Clique em **Avançar**.

7. Escolha o tipo de aplicativo **Business**.

8. Clique em **Avançar**.

9. No campo de nome, digite um nome para identificar a integração.

Exemplo:

`WhatsApp Oficial - Nome da Empresa`

1. Confirme o e-mail de contato.

2. Selecione a conta empresarial ou o portfólio empresarial da sua empresa.

3. Clique em **Criar aplicativo**.

4. Digite novamente sua senha do Facebook, caso seja solicitado.

> ✅ O aplicativo foi criado quando o painel principal da Meta aparecer na tela.

## Etapa 3: Adicione o produto WhatsApp

1. No painel do aplicativo criado, localize a seção **Adicionar produtos ao seu aplicativo**.

2. Procure pelo produto **WhatsApp**.

3. Clique em **Configurar**.

4. Aguarde a abertura da página de configuração da API.

5. No menu lateral, acesse:

**Configurações do app \> Básico**

1. Localize o campo **URL da Política de Privacidade**.

2. Informe o endereço público da Política de Privacidade da sua empresa.

3. Localize o campo **URL dos Termos de Serviço**.

4. Informe o endereço público dos Termos de Serviço da sua empresa.

5. Preencha os demais campos obrigatórios apresentados pela Meta.

6. Clique em **Salvar alterações**.

7. Na parte superior da tela, localize o status do aplicativo.

8. Altere o aplicativo de **Em desenvolvimento** para **Ao vivo** , quando todos os requisitos estiverem preenchidos.

> ✅ O aplicativo estará disponível para uso quando o status aparecer como **Ao vivo**.

## Etapa 4: Cadastre o número do WhatsApp

1. No menu lateral do aplicativo, clique em **WhatsApp**.

2. Clique em **Configuração da API**.

3. Localize a seção de números de telefone.

4. Clique em **Adicionar número de telefone**.

5. Informe o nome da empresa.

6. Informe o nome que será exibido no WhatsApp.

7. Selecione a categoria que melhor representa a atividade da empresa.

8. Preencha os demais dados solicitados.

9. Informe o número de telefone com o código do país e o código de área.

Exemplo:

`55 + DDD + número`

1. Escolha como deseja receber o código de confirmação:

- Mensagem SMS.

- Ligação telefônica.

1. Clique para enviar o código.

2. Digite o código recebido.

3. Confirme a verificação.

> ✅ O número estará verificado quando aparecer na lista de telefones da conta do WhatsApp Business.

## Etapa 5: Cadastre uma forma de pagamento

1. Acesse o **Gerenciador de Negócios da Meta**.

2. Entre nas configurações da conta do WhatsApp.

3. Localize a opção de **Cobrança** , **Pagamentos** ou **Forma de pagamento**.

4. Clique em **Adicionar forma de pagamento**.

5. Preencha os dados solicitados.

6. Revise as informações.

7. Confirme o cadastro.

> ⚠ Os valores relacionados às conversas, templates ou mensagens são definidos e cobrados diretamente pela Meta, conforme as regras vigentes.

## Etapa 6: Registre o número e crie o PIN

Após a confirmação do telefone, a Meta pode exigir o registro do número pela API utilizando um PIN de seis dígitos.

Esta etapa é técnica e não deve ser realizada sem orientação quando o cliente não possui experiência com APIs.

1. Escolha um PIN de seis números.

2. Guarde o PIN em local seguro.

3. Utilize o token temporário fornecido na página de configuração da API.

4. Faça o registro do número por meio da API oficial da Meta.

5. Confirme que a solicitação retornou uma resposta de sucesso.

> ⚠ Nunca envie o token, o PIN ou dados da conta empresarial em grupos, mensagens públicas ou e-mails não protegidos.

> ✅ O registro foi concluído quando a Meta informar que o número foi registrado com sucesso.

## Etapa 7: Gere um token permanente

O token apresentado inicialmente pela Meta é temporário e pode expirar. Para manter o canal funcionando, será necessário gerar um token permanente.

1. Abra o **Gerenciador de Negócios da Meta**.

2. Acesse **Configurações do negócio**.

3. No menu lateral, clique em **Usuários**.

4. Clique em **Usuários do sistema**.

5. Clique em **Adicionar**.

6. Digite um nome para o usuário.

Exemplo:

`Integração Chat Pró Oratrix`

1. Escolha a função **Administrador**.

2. Confirme a criação.

3. Selecione o usuário do sistema criado.

4. Clique em **Atribuir ativos**.

5. Selecione **Aplicativos**.

6. Escolha o aplicativo criado anteriormente.

7. Ative a permissão **Gerenciar aplicativo**.

8. Salve a configuração.

9. Com o usuário ainda selecionado, clique em **Gerar novo token**.

10. Escolha o aplicativo correto.

11. Quando estiver disponível, selecione a opção de expiração **Nunca**.

12. Marque, no mínimo, as permissões:

`whatsapp_business_management`

`whatsapp_business_messaging`

1. Clique em **Gerar token**.

2. Copie o token exibido.

3. Armazene o token em um gerenciador de senhas ou local protegido.

> ⚠ O token pode ser exibido somente uma vez. Não feche a tela antes de copiá-lo e armazená-lo corretamente.

## Etapa 8: Localize os dados da conta do WhatsApp

1. Volte ao painel do aplicativo na Meta.

2. Acesse:

**WhatsApp \> Configuração da API**

1. Localize o **ID do número de telefone**.

2. Copie esse código e guarde-o.

3. Localize o **ID da conta do WhatsApp Business**.

4. Copie esse código e guarde-o.

Você deverá ter três informações:

- ID do número de telefone.

- ID da conta do WhatsApp Business.

- Token permanente.

> ⚠ Não confunda o número do telefone com o ID do número. O ID é um código numérico exibido pela Meta.

## Etapa 9: Crie o canal no Chat Pró Oratrix

1. Acesse o Chat Pró Oratrix pelo endereço fornecido pela Oratrix.

2. Faça login com um usuário administrador.

3. Abra o **Painel Admin**.

4. No menu lateral, clique em **Administração**.

5. Acesse **Canais de comunicação** ou **Canais**.

6. Clique em **Adicionar canal**.

7. Na lista de canais disponíveis, escolha **WABA**.

8. No campo correspondente, informe o **ID do número de telefone**.

9. Informe o **ID da conta do WhatsApp Business**.

10. Informe o **token permanente**.

11. Digite um nome para identificar o canal.

Exemplo:

`WhatsApp Oficial - Atendimento`

1. Selecione o departamento ou fila responsável pelos atendimentos, quando essa opção estiver disponível.

2. Revise todas as informações.

3. Clique em **Salvar**.

> ✅ Após salvar corretamente, o canal estará preparado para enviar mensagens.

## Etapa 10: Configure o webhook para receber mensagens

O webhook é o endereço utilizado pela Meta para entregar ao Chat Pró Oratrix as mensagens recebidas no WhatsApp.

Sem essa etapa, o sistema pode conseguir enviar mensagens, mas não receber as respostas dos clientes.

1. No Painel Admin do Chat Pró Oratrix, abra **Configurações**.

2. Clique em **Integração Meta** ou **Integrações Meta**.

3. Localize a **URL do Webhook**.

4. Clique para copiar a URL.

5. Localize o **Token de Verificação**.

6. Copie o token de verificação.

7. Volte ao painel do aplicativo na Meta.

8. Acesse:

**WhatsApp \> Configuração da API**

1. Localize a seção **Webhooks**.

2. Clique em **Editar**.

3. No campo de URL, cole a **URL do Webhook** copiada do Chat Pró Oratrix.

4. No campo de token, cole o **Token de Verificação**.

5. Clique em **Verificar e salvar**.

6. Aguarde a confirmação da Meta.

> ✅ A validação foi concluída quando a Meta aceitar a URL e não apresentar mensagem de erro.

## Etapa 11: Assine os eventos de mensagens

1. Ainda na configuração de Webhooks da Meta, clique em **Gerenciar**.

2. Localize o evento:

`messages`

1. Clique em **Assinar** ou **Subscribe**.

2. Assine também os demais eventos necessários para sua operação, quando orientado pela Oratrix.

3. Salve as alterações.

> ✅ A assinatura do evento `messages` permite que o Chat Pró Oratrix receba mensagens, atualizações de entrega e respostas dos clientes.

## Etapa 12: Faça um teste completo

1. Utilize outro telefone para enviar uma mensagem ao número conectado.

2. Aguarde alguns segundos.

3. Abra o painel de atendimento do Chat Pró Oratrix.

4. Confirme se um novo atendimento foi criado.

5. Abra a conversa.

6. Envie uma resposta pelo painel.

7. Confirme se a resposta chegou ao telefone utilizado no teste.

8. Envie outra mensagem do telefone para o Chat Pró Oratrix.

9. Confirme se a conversa foi atualizada.

> ✅ A integração está funcionando quando o Chat Pró Oratrix recebe e envia mensagens pelo número oficial.

# ⚠ OBSERVAÇÕES IMPORTANTES

- O número precisa estar corretamente verificado na Meta.

- O token utilizado no Chat Pró Oratrix deve ser permanente.

- O evento `messages` precisa estar assinado no Webhook.

- Não compartilhe tokens, senhas, PINs ou códigos de autenticação.

- A Meta pode solicitar verificações adicionais da empresa.

- O nome de exibição do WhatsApp pode passar por análise.

- A aprovação de templates depende da Meta.

- Mensagens iniciadas pela empresa fora da janela de atendimento podem exigir templates previamente aprovados.

- As cobranças da API Oficial são realizadas conforme as regras da Meta.

- Alterações feitas pela Meta podem modificar nomes de menus ou campos.

- Não exclua o aplicativo, o usuário do sistema ou o token após concluir a integração.

- Caso o token seja revogado, o canal poderá parar de enviar mensagens.

- Caso o Webhook seja removido, as mensagens recebidas poderão não aparecer no Chat Pró Oratrix.

## O canal envia, mas não recebe mensagens

Verifique:

1. Se a URL do Webhook foi validada.

2. Se o evento `messages` está assinado.

3. Se o aplicativo está no modo **Ao vivo**.

4. Se o canal correto foi salvo no Chat Pró Oratrix.

5. Se o número utilizado no teste é diferente do número conectado.

## O canal recebe, mas não envia mensagens

Verifique:

1. Se o token permanente foi copiado por completo.

2. Se o token possui as permissões necessárias.

3. Se o ID do número de telefone está correto.

4. Se o número foi registrado com o PIN.

5. Se existe uma forma de pagamento válida na Meta.

## O token parou de funcionar

Uma possível causa é o token ter sido gerado com expiração ou ter sido revogado.

Gere um novo token com as permissões necessárias, atualize o canal no Chat Pró Oratrix e faça um novo teste.

## A Meta não aceita o número

Verifique se:

- O número consegue receber SMS ou ligação.

- O código do país e o DDD foram informados corretamente.

- O número não está vinculado a outra conta da API Oficial.

- A conta antiga do WhatsApp foi removida, quando aplicável.

- O número não possui restrições na Meta.

# ⚙ DICAS E BOAS PRÁTICAS

- Utilize um nome claro para o aplicativo e para o canal.

- Guarde os IDs e tokens em um gerenciador de senhas.

- Crie um usuário do sistema exclusivo para a integração.

- Não utilize contas pessoais de funcionários como único acesso administrativo.

- Mantenha pelo menos dois administradores autorizados no ambiente empresarial.

- Revise regularmente as permissões da conta.

- Teste o envio e o recebimento após qualquer alteração.

- Mantenha a Política de Privacidade e os Termos de Serviço disponíveis publicamente.

- Crie templates apenas com textos claros e compatíveis com as regras da Meta.

- Oriente os atendentes sobre a janela de atendimento da API Oficial.

- Não faça disparos sem autorização dos destinatários.

- Mantenha os dados dos clientes protegidos e utilize as informações apenas para finalidades autorizadas.

# 📊 RESULTADO ESPERADO

Ao concluir o procedimento:

- O número aparecerá como canal ativo no Chat Pró Oratrix.

- As mensagens enviadas ao número chegarão ao painel de atendimento.

- Os atendentes poderão responder pelo Chat Pró Oratrix.

- O cliente receberá as mensagens no WhatsApp.

- As atualizações de envio, entrega e leitura poderão ser exibidas no atendimento.

- O número utilizará a infraestrutura oficial da Meta.

# 🧾 RESUMO FINAL

Com este procedimento, o WhatsApp Oficial será conectado ao Chat Pró Oratrix por meio da API Cloud WABA.

Para a integração funcionar completamente, é necessário cadastrar o número na Meta, gerar um token permanente, criar o canal no Chat Pró Oratrix, validar o Webhook e assinar o evento de mensagens.

# 🏷 KEYWORDS

WhatsApp Oficial, WABA, Cloud API, Chat Pró Oratrix, Integração Meta

### 🤖 **Peça ajuda ao ChatGPT da Oratrix**

A I.A. da Oratrix no ChatGPT poderá tirar dúvidas e te guiar passo a passo no suporte.

> **[ChatGPT - I.A. Assistente da Oratrix](https://chatgpt.com/g/g-68790cabbfa48191a8de20c4ffed7b92-i-a-assistente-da-oratrix)**
>
> IA para tirar dúvidas sobre os serviços da Oratrix: PABX Virtual, Chip 4G/5G, Chatbot, Telefonia Fixa, Portabilidade, Afiliados e mais. ⚠️ As respostas servem apenas como consulta e não garantem preços, prazos ou condições comerciais, pois esta IA...
