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:
-
Preparar a conta e o número.
-
Criar um aplicativo na Meta.
-
Cadastrar e verificar o número.
-
Gerar um token permanente.
-
Conectar o canal e configurar o recebimento das mensagens.
PASSO A PASSO GUIADO
Etapa 1: Prepare o número de telefone
-
Escolha o número que será utilizado no WhatsApp Oficial.
-
Confirme que você consegue receber ligações ou mensagens SMS nesse número.
-
Verifique se o número já está sendo utilizado no aplicativo WhatsApp ou WhatsApp Business.
-
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.
-
Caso seja necessário remover a conta existente, abra o WhatsApp no celular.
-
Acesse Configurações.
-
Entre em Conta.
-
Selecione Apagar minha conta.
-
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.
- Aguarde alguns minutos antes de iniciar o cadastro do número na Meta.
Etapa 2: Crie um aplicativo na Meta
-
Abra o navegador no computador.
-
Acesse o portal Meta for Developers:
https://developers.facebook.com/
-
Clique em Entrar.
-
Faça login utilizando a conta do Facebook que possui acesso à empresa.
-
Na parte superior da tela, clique em Meus aplicativos.
-
Clique em Criar aplicativo.
-
Quando o sistema perguntar o que você deseja fazer, selecione Outros.
-
Clique em Avançar.
-
Escolha o tipo de aplicativo Business.
-
Clique em Avançar.
-
No campo de nome, digite um nome para identificar a integração.
Exemplo:
WhatsApp Oficial - Nome da Empresa
-
Confirme o e-mail de contato.
-
Selecione a conta empresarial ou o portfólio empresarial da sua empresa.
-
Clique em Criar aplicativo.
-
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
-
No painel do aplicativo criado, localize a seção Adicionar produtos ao seu aplicativo.
-
Procure pelo produto WhatsApp.
-
Clique em Configurar.
-
Aguarde a abertura da página de configuração da API.
-
No menu lateral, acesse:
Configurações do app > Básico
-
Localize o campo URL da Política de Privacidade.
-
Informe o endereço público da Política de Privacidade da sua empresa.
-
Localize o campo URL dos Termos de Serviço.
-
Informe o endereço público dos Termos de Serviço da sua empresa.
-
Preencha os demais campos obrigatórios apresentados pela Meta.
-
Clique em Salvar alterações.
-
Na parte superior da tela, localize o status do aplicativo.
-
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
-
No menu lateral do aplicativo, clique em WhatsApp.
-
Clique em Configuração da API.
-
Localize a seção de números de telefone.
-
Clique em Adicionar número de telefone.
-
Informe o nome da empresa.
-
Informe o nome que será exibido no WhatsApp.
-
Selecione a categoria que melhor representa a atividade da empresa.
-
Preencha os demais dados solicitados.
-
Informe o número de telefone com o código do país e o código de área.
Exemplo:
55 + DDD + número
- Escolha como deseja receber o código de confirmação:
-
Mensagem SMS.
-
Ligação telefônica.
-
Clique para enviar o código.
-
Digite o código recebido.
-
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
-
Acesse o Gerenciador de Negócios da Meta.
-
Entre nas configurações da conta do WhatsApp.
-
Localize a opção de Cobrança, Pagamentos ou Forma de pagamento.
-
Clique em Adicionar forma de pagamento.
-
Preencha os dados solicitados.
-
Revise as informações.
-
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.
-
Escolha um PIN de seis números.
-
Guarde o PIN em local seguro.
-
Utilize o token temporário fornecido na página de configuração da API.
-
Faça o registro do número por meio da API oficial da Meta.
-
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.
-
Abra o Gerenciador de Negócios da Meta.
-
Acesse Configurações do negócio.
-
No menu lateral, clique em Usuários.
-
Clique em Usuários do sistema.
-
Clique em Adicionar.
-
Digite um nome para o usuário.
Exemplo:
Integração Chat Pró Oratrix
-
Escolha a função Administrador.
-
Confirme a criação.
-
Selecione o usuário do sistema criado.
-
Clique em Atribuir ativos.
-
Selecione Aplicativos.
-
Escolha o aplicativo criado anteriormente.
-
Ative a permissão Gerenciar aplicativo.
-
Salve a configuração.
-
Com o usuário ainda selecionado, clique em Gerar novo token.
-
Escolha o aplicativo correto.
-
Quando estiver disponível, selecione a opção de expiração Nunca.
-
Marque, no mínimo, as permissões:
whatsapp_business_management
whatsapp_business_messaging
-
Clique em Gerar token.
-
Copie o token exibido.
-
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
-
Volte ao painel do aplicativo na Meta.
-
Acesse:
WhatsApp > Configuração da API
-
Localize o ID do número de telefone.
-
Copie esse código e guarde-o.
-
Localize o ID da conta do WhatsApp Business.
-
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
-
Acesse o Chat Pró Oratrix pelo endereço fornecido pela Oratrix.
-
Faça login com um usuário administrador.
-
Abra o Painel Admin.
-
No menu lateral, clique em Administração.
-
Acesse Canais de comunicação ou Canais.
-
Clique em Adicionar canal.
-
Na lista de canais disponíveis, escolha WABA.
-
No campo correspondente, informe o ID do número de telefone.
-
Informe o ID da conta do WhatsApp Business.
-
Informe o token permanente.
-
Digite um nome para identificar o canal.
Exemplo:
WhatsApp Oficial - Atendimento
-
Selecione o departamento ou fila responsável pelos atendimentos, quando essa opção estiver disponível.
-
Revise todas as informações.
-
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.
-
No Painel Admin do Chat Pró Oratrix, abra Configurações.
-
Clique em Integração Meta ou Integrações Meta.
-
Localize a URL do Webhook.
-
Clique para copiar a URL.
-
Localize o Token de Verificação.
-
Copie o token de verificação.
-
Volte ao painel do aplicativo na Meta.
-
Acesse:
WhatsApp > Configuração da API
-
Localize a seção Webhooks.
-
Clique em Editar.
-
No campo de URL, cole a URL do Webhook copiada do Chat Pró Oratrix.
-
No campo de token, cole o Token de Verificação.
-
Clique em Verificar e salvar.
-
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
-
Ainda na configuração de Webhooks da Meta, clique em Gerenciar.
-
Localize o evento:
messages
-
Clique em Assinar ou Subscribe.
-
Assine também os demais eventos necessários para sua operação, quando orientado pela Oratrix.
-
Salve as alterações.
A assinatura do evento
messagespermite que o Chat Pró Oratrix receba mensagens, atualizações de entrega e respostas dos clientes.
Etapa 12: Faça um teste completo
-
Utilize outro telefone para enviar uma mensagem ao número conectado.
-
Aguarde alguns segundos.
-
Abra o painel de atendimento do Chat Pró Oratrix.
-
Confirme se um novo atendimento foi criado.
-
Abra a conversa.
-
Envie uma resposta pelo painel.
-
Confirme se a resposta chegou ao telefone utilizado no teste.
-
Envie outra mensagem do telefone para o Chat Pró Oratrix.
-
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
messagesprecisa 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:
-
Se a URL do Webhook foi validada.
-
Se o evento
messagesestá assinado. -
Se o aplicativo está no modo Ao vivo.
-
Se o canal correto foi salvo no Chat Pró Oratrix.
-
Se o número utilizado no teste é diferente do número conectado.
O canal recebe, mas não envia mensagens
Verifique:
-
Se o token permanente foi copiado por completo.
-
Se o token possui as permissões necessárias.
-
Se o ID do número de telefone está correto.
-
Se o número foi registrado com o PIN.
-
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.