Conectar o WhatsApp da sua empresa (Meta) à plataforma

• Acesse developers.facebook.com e faça login com a conta Meta (Facebook) do responsável técnico.
• Clique em "Começar" (Get Started) e conclua o registro como desenvolvedor, aceitando os termos da plataforma.
• Use, de preferência, uma conta vinculada ao Gerenciador de Negócios da sua empresa.

• No painel de desenvolvedor, acesse "Meus aplicativos" e clique em "Criar aplicativo".
• Quando for solicitado o caso de uso, selecione "Conectar-se a clientes pelo WhatsApp" (Connect with customers through WhatsApp). Em fluxos antigos, a opção equivalente é criar um aplicativo do tipo "Empresa" (Business) e adicionar o produto WhatsApp em seguida.
• Informe o nome do aplicativo (sugestão: o nome da sua empresa seguido de "RH WhatsApp"), o e-mail de contato e vincule o aplicativo ao portfólio empresarial (Business Manager) da sua empresa.
• Conclua a criação. Você será direcionado ao painel do aplicativo (App Dashboard).

• No painel do aplicativo, confirme que o produto WhatsApp está habilitado. Se você criou o aplicativo pelo caso de uso da etapa anterior, ele já estará presente.
• Acesse o menu WhatsApp, opção "API Setup" (Configuração da API). Nesse painel a Meta disponibiliza um número de teste temporário, o identificador da conta do WhatsApp Business (WABA ID), o identificador do número (Phone Number ID) e um token de acesso temporário.
• Anote o WABA ID: ele será compartilhado com o WallJobs ao final.

• Ainda em WhatsApp, API Setup, clique em "Adicionar número de telefone" (Add phone number).
• Preencha o nome de exibição (display name) que aparecerá para os candidatos. Ele deve guardar relação clara com a sua marca e está sujeito à aprovação da Meta.
• Informe a categoria do negócio, a descrição e o número de telefone dedicado ao canal.
• Escolha o método de validação (SMS ou ligação), receba o código e informe-o no painel para concluir a verificação.

• Ao selecionar o número recém-validado, o painel pede o cadastro do PIN de confirmação em duas etapas (two-step verification), um código de 6 dígitos definido pela sua empresa.
• Guarde esse PIN em local seguro: ele é exigido em qualquer migração ou novo registro do número.
• Com o PIN cadastrado, o número fica autenticado e ativo na Cloud API.

Se o registro for feito por via programática, a operação corresponde à chamada POST /{phone-number-id}/register da Graph API. A equipe do WallJobs pode acompanhar esse ponto, se necessário.

O webhook é o mecanismo pelo qual a Meta entrega ao WallJobs as mensagens recebidas.

• No painel do aplicativo, acesse WhatsApp, opção "Configuration" (Configuração).
• Na seção Webhook, clique em "Editar" e preencha os campos abaixo.

URL de callback

https://api-hr.walljobs.ai/api/webhooks/meta/whatsapp

Token de verificação (verify token)

Fornecido pela equipe do WallJobs, por canal seguro, antes desta etapa.

Clique em "Verificar e salvar". Nesse momento a Meta faz uma chamada de verificação (handshake) ao servidor do WallJobs. Se o token de verificação estiver correto, a configuração é aceita na hora.

Esta etapa precisa ser agendada junto com o WallJobs: o ambiente do nosso lado precisa estar configurado com o token de verificação e com a chave secreta do aplicativo da sua empresa (App Secret), usada na validação criptográfica de cada requisição.

• Ainda em WhatsApp, Configuration, na seção "Webhook fields" (Campos do webhook), clique em "Gerenciar" (Manage).
• Localize o campo messages e clique em "Assinar" (Subscribe). Ele contempla tanto as mensagens recebidas dos candidatos quanto as atualizações de status das mensagens enviadas (entregue, lida, falha).
• Confirme que a assinatura ficou ativa para a conta do WhatsApp Business (objeto "WhatsApp Business Account") vinculada ao aplicativo.

As permissões de negócio associadas ao envio e à gestão do canal, whatsapp_business_messaging e whatsapp_business_management, são tratadas na etapa seguinte, na geração do token.

O token exibido no painel "API Setup" é temporário, expira em poucas horas e não deve ser usado em produção. Para o envio de mensagens pela plataforma é necessário um token permanente, gerado por um usuário do sistema.

• Acesse o Gerenciador de Negócios (business.facebook.com) e vá em Configurações do negócio, seção Usuários, opção "Usuários do sistema" (System users).
• Clique em "Adicionar" e crie um usuário do sistema com função Administrador (sugestão de nome: walljobs-integracao).
• Com o usuário criado, clique em "Adicionar ativos" (Add assets) e atribua a ele o aplicativo criado na Etapa 2 e a conta do WhatsApp (WABA), ambos com permissão de gerenciamento.
• Clique em "Gerar novo token" (Generate new token), selecione o aplicativo e defina a expiração como "Nunca" (Never expire).
• Marque as permissões whatsapp_business_messaging (envio e recebimento), whatsapp_business_management (gestão da conta e dos modelos de mensagem) e business_management (recomendada, para gestão dos ativos do negócio).
• Gere o token e copie-o imediatamente: por segurança, a Meta não o exibe de novo.