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

:parrot: SERVIÇO

Serviço: Chat Pró Oratrix

:hammer_and_wrench: 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.

:warning: 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.

:receipt: 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.

:compass: 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.

:warning: 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.

:warning: 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.

:white_check_mark: 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.

:white_check_mark: 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.

:white_check_mark: 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.

:warning: 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.

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

:white_check_mark: 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.

:warning: 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.

:warning: 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.

:white_check_mark: 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.

:white_check_mark: 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.

:white_check_mark: 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.

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

:warning: 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.

:gear: 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.

:bar_chart: 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.

:receipt: 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.

:label: KEYWORDS

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

:robot: 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.