Criar um token de acesso de usuário do sistema para WhatsApp

Use uma credencial de usuário do sistema para a conexão contínua do WhatsApp. O token da tela de teste da Meta é temporário e não deve ser confundido com a credencial operacional. Um token configurado sem expiração programada, quando a Meta oferece essa opção, ainda pode ser revogado ou perder acesso aos ativos.

As capturas mostram a interface em inglês. As instruções usam os rótulos publicados do REDA Connect em português; os nomes das telas da Meta são mantidos para identificá-las nas imagens.

1. Prepare o aplicativo e a conta do WhatsApp

Conclua a criação do aplicativo e a configuração do caso de uso do WhatsApp. Confirme que aplicativo e WABA pertencem ao portfólio pretendido ou estão acessíveis por ele. Peça ao administrador do portfólio para realizar as etapas de usuário do sistema.

2. Crie ou selecione a identidade de integração

1. Abra Meta Business Suite → Settings → Users → System users.
2. Selecione uma identidade adequada existente ou clique em Add.
3. Para uma identidade nova, use um nome descritivo como “Integração de mensagens de clientes”, selecione a função adequada e conclua a criação.
4. Atribua o aplicativo e a conta do WhatsApp Business pelos controles de atribuição. Confira os dois em Assigned assets.

Confira as atribuições do aplicativo e da conta. O menu pode variar; as permissões do token não concedem acesso a uma conta não atribuída.

Se um ativo não aparecer, verifique Accounts → Apps ou Accounts → WhatsApp accounts nas configurações empresariais e conceda o acesso necessário. Não selecione outra WABA apenas porque o nome é parecido.

3. Gere o token para o aplicativo correto

1. Clique em Generate token no usuário do sistema.
2. Select app: escolha o aplicativo do WhatsApp e avance com Next.
3. Set expiry: escolha uma duração oferecida pela Meta. A tela atual mostra 60 days (recommended) e Never. Siga a política de rotação da empresa e registre a data de substituição quando aplicável.
4. Assign permissions: confirme whatsapp_business_messaging e whatsapp_business_management. O caso de uso pode agrupar ou pré-selecionar permissões adicionais. Resolva as permissões obrigatórias ausentes nas configurações do caso de uso antes de continuar.
5. Gere o token e copie-o para o armazenamento de credenciais aprovado. Não dependa de conseguir exibi-lo novamente após fechar o diálogo.

Escolha a expiração de forma deliberada. Um token sem expiração programada ainda pode ser revogado ou perder acesso aos ativos.

Revise as permissões do WhatsApp antes de gerar o token. A tela pode pré-selecionar o conjunto do caso de uso.

Resultado esperado: uma credencial para este aplicativo e sua conta WhatsApp atribuída. Um token gerado para outro aplicativo não é corrigido copiando outro App ID para o Salesforce.

4. Salve pela ação de configuração do Salesforce

1. Crie e salve a conta Connect com os identificadores do número e da conta. Deixe o canal desmarcado até a configuração estar pronta.
2. Clique em Configurar WhatsApp.
3. Cole a credencial em Token de autenticação do WhatsApp e clique em Salvar token.
4. Leia o resultado e use Verificar novamente. Continue com a conexão do webhook e o teste real de conversa.

Salvar token armazena a credencial pela ação de configuração. O endereço de exemplo não corresponde a uma implantação real.

Não cole o token real diretamente em Token do WhatsApp no registro. A ação cuida do armazenamento criptografado. Não é necessário um token provisório para salvar uma conta nova sem canais selecionados.

5. Mantenha a credencial

Registre o responsável pelo aplicativo e ativos e as informações de rotação, sem colocar o segredo em uma descrição. Se a Meta rejeitar um token antes funcional, verifique expiração, revogação e acesso antes de substituí-lo. Use a mesma ação Configurar WhatsApp → Salvar token e repita os testes de entrada e resposta.

Antes de revogar tokens de um usuário do sistema, confira quais outras integrações usam a identidade; o controle pode afetar mais de uma conta. O guia geral de tokens explica usuário, usuário do sistema e página nos três canais Meta.

Se não conseguir concluir o processo

• Não há menu System users: confirme o portfólio e o acesso de administrador.
• O aplicativo não aparece no seletor: confirme a propriedade ou o acesso do portfólio e a atribuição ao usuário do sistema.
• Não aparecem permissões de WhatsApp: configure o caso de uso do WhatsApp nesse mesmo aplicativo.
• Salva corretamente, mas uma verificação posterior falha: leia o resultado específico, confira WABA, número e acesso do token e use o guia de solução de problemas.