Este manual descreve o processo de integração da API Oficial do WhatsApp (Meta Cloud API) com a ferramenta de gerenciamento de comunicação V-Pro Whats.
O objetivo desta configuração é permitir que empresas gerenciem suas comunicações de WhatsApp Oficial na plataforma V-Pro.
Manual de Configuração: API Oficial do WhatsApp no V-Pro Whats
I. Pré-Requisitos
Para iniciar a configuração da API Oficial do WhatsApp (Meta Cloud API) no V-Pro Whats, é obrigatório:
1. Ter uma conta no V-Pro CRM.
2. Ter uma empresa verificada na plataforma Meta (Facebook Business). Não é possível prosseguir sem a verificação empresarial concluída.
II. Configuração Inicial na Plataforma Meta Developers
A primeira etapa é configurar o aplicativo dentro do ambiente de desenvolvedores da Meta:
1. Acesse o site developers.facebook.com e faça login.
2. Navegue até a seção "Meus Apps" (My Apps).
3. Se ainda não tiver um aplicativo configurado, clique em "Criar aplicativo".
◦ Nome: Insira o nome desejado para o aplicativo (exemplo: "V-Pro Whats").
◦ Caso de Uso: Selecione "Business".
◦ Portfólio Empresarial: Escolha o portfólio da empresa que já foi verificada.
4. Clique em "Criar aplicativo".
5. Após a criação, o sistema direcionará o usuário para a página de gerenciamento do aplicativo. No menu, selecione "WhatsApp" e depois "Configurações de API".
III. Adição e Verificação do Número de Telefone
Nesta etapa, o número de telefone que utilizará a API Oficial deve ser adicionado e verificado:
1. Na página de Configurações de API, ignore o número de teste, pois ele só aceita o template "hello".
2. Clique em "Adicionar telefone".
3. Preencha os dados solicitados, como um nome para o número (exemplo: "Atendimento") e a categoria (exemplo: "Outras").
4. Insira o número de telefone completo.
5. Selecione o método de entrega do código de verificação:
◦ SMS: Para número de celular.
◦ Ligação telefônica: Para número fixo.
6. Insira o código de verificação recebido para completar a adição do número.
IV. Configuração da Caixa de Entrada no V-Pro Whats
Com o número verificado na Meta, inicie a configuração no V-Pro Whats:
1. No V-Pro Whats, acesse Chaves da API Meta, no botão de perfil (canto superior direito).
2. Esta interface solicitará cinco credenciais principais do Meta: ID da conta WhatsApp Business, ID da conta empresarial (ID do Negócio) e o Token de acesso Meta (Chave de API). Preencha os dados solicitados.
4. Clique em Salvar e depois em Buscar Requisição. Se estiver tudo certo ira aparecer a mensagem de retorno no formato JSON.
V. Geração do Token Permanente da API (Meta)
O token de acesso deve ser permanente para evitar a necessidade de trocas constantes:
1. No Meta Business Settings, navegue até "Usuário de Sistema".
2. Crie ou utilize um usuário de sistema existente (com permissão Admin) e certifique-se de que ele tem acesso ao aplicativo WhatsApp que foi criado.
3. Clique em "Gerar token".
4. Defina a expiração do token como "Nunca".
5. Selecione as permissões necessárias. Para esta configuração inicial, apenas as permissões que mencionam "WhatsApp" são requeridas. Permissões adicionais podem ser liberadas para futuras automações.
6. Verifique a conta com o código que será enviado, se solicitado.
7. Copie o token permanente gerado e cole no campo correspondente.
VI. Vinculação Final via Webhooks
Para que as mensagens enviadas para o número oficial cheguem ao V-Pro Whats, é necessário configurar o Webhook:
1. Na mesma janela do V-Pro Whats, é mostrada a URL do Webhook. Copie.
3. Retorne à Meta Developers, na configuração do seu aplicativo WhatsApp.
4. Adicione a URL do Webhook no campo correspondente da Meta.
5. Clique em "Verificar e salvar".
6. Dentro de WhatsApp Business, certifique-se de que a
de mensagens está liberada.
VII. Teste e Funcionamento
Com as configurações concluídas, todas as mensagens enviadas para o número oficial cairão na caixa de entrada do V-Pro Whats.
• Teste: Envie uma mensagem de um telefone externo para o número que foi configurado na API oficial para confirmar que ela aparece no Inbox do V-Pro Whats.
• Respostas:
◦ Se o contato estiver dentro da janela de 24 horas (após a última mensagem do cliente), é possível responder livremente.
◦ Se a janela de 24 horas tiver sido excedida, é obrigatório selecionar um Template do WhatsApp (que deve ter sido configurado previamente no Meta) antes de enviar a mensagem.
A integração da API Oficial do WhatsApp no V-Pro Whats está concluída, permitindo a gestão centralizada da comunicação e a criação de automações.