Como conectar seu número de WhatsApp via API Oficial (Cloud API)?

Para conectar seu número de WhatsApp usando a API Oficial (Cloud API), você deve primeiro iniciar o processo na plataforma Papo (https://papo.global/) criando uma nova caixa de entrada do tipo "WhatsApp – API Cloud (Meta)". Em seguida, é necessário configurar um aplicativo e um número de telefone no Gerenciador de Negócios da Meta para obter as credenciais (ID do número, ID da conta de negócios e Token de Acesso), que serão inseridas na Papo para finalizar a conexão.

A integração via API Oficial do WhatsApp, também conhecida como Cloud API, é a solução mais robusta e escalável para empresas que desejam profissionalizar o atendimento no canal. Diferente do aplicativo WhatsApp Business, a API permite que múltiplos atendentes usem o mesmo número, além de possibilitar automações avançadas com IA e integrações com outros sistemas, como CRMs e ERPs.

A Papo Global facilita essa conexão, guiando você pelo processo e unificando o WhatsApp com seus outros canais de comunicação em uma única caixa de entrada.

Pré-requisitos para a Conexão

Antes de começar, certifique-se de que você possui:

1. Uma conta na Papo Global: Você precisa ter acesso ao painel da Papo para iniciar a configuração.
2. Uma conta no Gerenciador de Negócios da Meta (Facebook Business Manager): Sua empresa deve estar configurada e, idealmente, verificada na plataforma da Meta.
3. Um número de telefone exclusivo: O número que você vai conectar não pode estar ativo em uma conta do aplicativo WhatsApp ou WhatsApp Business. Se estiver, você precisará primeiro apagar a conta do WhatsApp associada a esse número antes de iniciar o processo de migração para a API.

Passo a Passo para Conectar a API do WhatsApp

O processo é dividido em etapas que acontecem tanto na plataforma Papo quanto no ambiente da Meta.

Etapa 1: Iniciar a Configuração na Papo Global

O primeiro passo é sinalizar na Papo que você deseja adicionar um novo canal de WhatsApp via API Oficial.

1. Acesse o painel da Papo e vá para Configurações → Caixas de Entrada.
2. Clique no botão “Adicionar nova Caixa de Entrada”.
3. Na lista de canais, escolha a opção “WhatsApp – API Cloud (Meta)”.
4. Você será direcionado para uma tela de configuração. Mantenha essa aba aberta, pois você precisará dela após configurar tudo na Meta.

Etapa 2: Criar e Configurar um Aplicativo na Meta

Agora, vamos para o ambiente de desenvolvedores da Meta para criar a estrutura necessária.

1. Acesse o portal Meta for Developers.
2. Clique em “Criar aplicativo”.
3. Selecione o tipo de aplicativo “Empresa” e clique em "Avançar".
4. Dê um nome para o seu aplicativo (ex: Atendimento Papo [Nome da Empresa]) e vincule-o à sua conta do Gerenciador de Negócios da Meta.
5. Após criar o app, no painel principal, role para baixo e encontre o produto “WhatsApp”. Clique em “Configurar”.

Etapa 3: Adicionar e Verificar o Número de Telefone

Dentro da configuração do produto WhatsApp no seu aplicativo, você precisará vincular e verificar o número de telefone que será usado.

1. Siga as instruções para conectar sua conta da Meta.
2. Na seção de configuração da API, haverá um passo para adicionar um número de telefone.
3. Insira o número de telefone que você deseja usar (lembre-se: ele não pode estar ativo em outro app do WhatsApp).
4. Escolha um método de verificação (SMS ou chamada de voz) e insira o código recebido para confirmar a posse do número.

Etapa 4: Obter as Credenciais da API

Com o aplicativo criado e o número verificado, você já tem acesso às credenciais necessárias para a integração. Elas ficam localizadas no painel de configuração do WhatsApp dentro do seu aplicativo na Meta.

As três informações essenciais são:

• ID do número de telefone: O identificador único do seu número na plataforma da Meta.
• ID da conta do WhatsApp Business (WABA ID): O identificador da sua conta de negócios do WhatsApp.
• Token de acesso: Uma chave que autoriza a Papo a se comunicar com a API em nome da sua empresa.

Etapa 5: Finalizar a Conexão na Papo Global

Volte para a aba da Papo que você deixou aberta na Etapa 1.

1. Preencha os campos do formulário com as informações que você obteve da Meta:
   • Nome da Caixa de Entrada: Um nome interno para você identificar o canal (ex: "WhatsApp Oficial").
   • ID do número de telefone.
   • ID da conta do WhatsApp Business (WABA ID).
   • Token de acesso.
2. Clique em “Salvar” ou “Criar Caixa de Entrada”.

Pronto! Após salvar, a Papo irá estabelecer a conexão. Em poucos instantes, seu número de WhatsApp Oficial estará conectado e pronto para receber e enviar mensagens diretamente pela sua caixa de entrada unificada.

Etapa 6: Criar Modelos de Mensagem (Templates)

Para iniciar conversas com seus clientes ou enviar notificações após 24 horas da última interação deles, o WhatsApp exige o uso de Modelos de Mensagem (também conhecidos como HSM).

1. No seu Gerenciador de Negócios da Meta, acesse o Gerenciador do WhatsApp.
2. Vá para a seção de Modelos de mensagem.
3. Clique em “Criar modelo” e siga as instruções para definir a categoria, o nome, o idioma e o conteúdo da sua mensagem.
4. Envie o modelo para aprovação. Geralmente, a aprovação leva de alguns minutos a algumas horas.

Perguntas Frequentes (FAQ)

### Posso usar meu número atual do WhatsApp Business?

Não simultaneamente. Para usar um número na API Oficial, você precisa primeiro apagar a conta do WhatsApp Business ou pessoal associada a ele. Isso libera o número para ser registrado na API. O histórico de conversas do aplicativo não é migrado, então recomendamos fazer um backup antes, caso precise consultar as mensagens antigas.

### O que acontece se eu não usar um modelo de mensagem?

Você só pode enviar mensagens de formato livre (sem modelo) se o cliente tiver iniciado a conversa ou respondido a uma mensagem sua nas últimas 24 horas. Fora dessa "janela de 24 horas", qualquer mensagem iniciada pela empresa deve obrigatoriamente usar um modelo pré-aprovado pela Meta.

### A conexão com a API Oficial tem algum custo?

Sim. A Meta cobra pelo uso da API Oficial com base em um modelo de conversas. As primeiras 1.000 conversas de serviço por mês são geralmente gratuitas. Além disso, há o custo da assinatura da plataforma Papo, que fornece a interface, o CRM, a IA e as automações. Para detalhes sobre os preços da Meta, consulte a documentação oficial deles.

### O que é o WABA ID?

WABA significa "WhatsApp Business Account". O WABA ID é o identificador único da sua conta de negócios do WhatsApp. É através dessa conta que você gerencia seus números de telefone, modelos de mensagem e verifica as métricas de uso.

### Quanto tempo leva para a Meta aprovar meus modelos de mensagem?

O tempo de aprovação pode variar. Muitos modelos, especialmente os transacionais (como confirmação de pedido ou lembrete de agendamento), são aprovados automaticamente em poucos minutos. Modelos promocionais ou com conteúdo mais complexo podem levar algumas horas para uma revisão manual.

### Onde eu gerencio os agentes que terão acesso a essa caixa de entrada?

Após criar a caixa de entrada na Papo, você pode ir na aba "Agentes" dentro das configurações da caixa e adicionar quais membros da sua equipe terão permissão para visualizar e responder às conversas que chegam por aquele número.

Comece a usar gratuitamente →

O primeiro usuário é grátis e inclui acesso à IA, CRM completo e múltiplos canais.