Criar e enviar solicitações de autenticação em sessões de mensagens
Permita que os representantes de serviço verifiquem a identidade de um cliente durante uma sessão de mensagens do Apple Messages for Business aprimorada. Usando um componente de mensagens de autenticação e uma classe do Apex, solicite que o cliente faça login em um provedor de autenticação como o Google.
Edições obrigatórias
| Exibir edições com suporte. | |
 Este artigo se aplica a:
|
Canais aprimorados do Apple Messages for Business |
 Este artigo não se aplica a:
|
Chat no aplicativo aprimorado, Chat da Web aprimorado v1, Chat da Web aprimorado v2, WhatsApp aprimorado, Facebook Messenger padrão e aprimorado, SMS padrão e aprimorado, LINE aprimorado e Traga seu próprio canal |
| Permissões necessárias ao usuário | |
|---|---|
| Para criar componentes de mensagens: | Personalizar aplicativo E Visualizar configuração OU Administrador de sistemas |
| Para enviar e receber mensagens no Messaging: | Agente do Messaging |
Você pode autenticar usuários com um dos provedores de autenticação padrão do Salesforce, como Google, Salesforce e Facebook. Ou você pode criar um provedor de autenticação personalizado, que envolve algumas etapas adicionais.
Etapa 1: Preparar-se para autenticação
Para começar a adicionar uma opção de autenticação ao seu canal do Apple Messages for Business aprimorado, configure o aplicativo que você usará para autenticação, crie uma classe do Apex, adicione seu provedor de autenticação em Configuração e atualize suas configurações no Apple Business Register.
- Nas configurações do seu provedor de identidade externo, crie um aplicativo de autenticação.
- Nas configurações do aplicativo de autenticação, copie estes valores e salve-os para mais tarde: ID do cliente do aplicativo, Segredo do cliente do aplicativo, URL do OAuth, URL do token.
-
No Salesforce, configure um provedor de autenticação padrão ou personalizado.
Para as etapas, consulte Configurar um provedor de autenticação predefinido ou Criar um provedor de autenticação personalizado. Se você usar um provedor de autenticação personalizado, também deverá criar um tipo de metadado personalizado.
-
Na página Classes do Apex em Configuração, crie uma classe do Apex a ser usada durante a autenticação. A classe deve implementar a interface
RichMessaging.AuthRequestHandler. Para obter mais detalhes e um exemplo, consulte Interface AuthRequestHandler. - Se você estiver usando um provedor de autenticação personalizado e sua classe do Apex fizer qualquer chamada HTTP para buscar informações, adicione cada URL de base HTTP como um site remoto correspondente na página Configurações do site remoto em Configuração.
-
Se ainda não tiver feito isso, adicione e configure seu provedor de autenticação em Configuração.
- Na página Provedores de autenticação em Configuração, clique em Editar ao lado de um provedor de autenticação existente ou clique em Novo para adicionar um.
- Selecione Vincular a componentes de mensagens.
- No campo Manipulador de registro, selecione a classe do Apex que você criou.
- No campo URL do ponto de extremidade do token, adicione o URL do token que você copiou do seu aplicativo de autenticação.
- Preencha os campos restantes e salve suas alterações.
-
Configure seus canais do Apple Messages for Business para permitir a autenticação.
- Acesse register.apple.com e faça login com o ID da Apple do administrador ou contato técnico para a conta do Messages for Business.
- Abra o canal que deseja configurar.
- Na seção Autenticação integrada do Oauth2, clique em Editar.
- Atualize o URL do Oauth, o URL de token e o Identificador de cliente pelo URL de ponto de extremidade de autorização do aplicativo, o URL de ponto de extremidade do token e o Identificador do cliente.
- Salve e envie as atualizações para revisão da Apple. Esse processo pode levar alguns dias.
Etapa 2: criar um componente de mensagens de autenticação
Depois de concluir as etapas de preparação, crie um componente de mensagens de autenticação que os representantes de serviço possam usar para verificar a identidade dos clientes em sessões de mensagens.
- Vá para a página Componentes de mensagens em Configuração.
- Clique em Novo componente.
- Clique em Autenticação e, em seguida, em Avançar.
-
Selecione seu provedor de autenticação, insira um aviso e faça upload de uma imagem que aparecerá com a solicitação de autenticação. Em seguida, clique em Avançar.
- Deixe a versão de texto simples do seu componente como está e clique em Avançar.
-
Adicione um nome e uma descrição para seu componente.
Esses valores não estão visíveis aos clientes, mas os representantes de serviço veem o nome na lista de componentes de mensagens no Console de serviço. Atribua um nome que indique a finalidade do componente para que os representantes de serviço saibam quando usá-lo.
-
Clique em Concluído. O Criador de componentes de mensagens é aberto.
-
Na seção Formatos de componentes, controle a aparência do componente em sessões de mensagens. Clique em Adicionar formato, selecione Autenticação e clique em Concluído.
Nota Cada componente de mensagens está disponível em um ou mais formatos, como Autenticação, e alguns formatos funcionam apenas em determinados canais. Para obter uma lista de formatos compatíveis com cada canal, consulte Tipo e formatos de componente de mensagens. É uma boa ideia adicionar, no mínimo, um formato com suporte para cada canal para o qual o componente será enviado. Se nenhum formato for adicionado, o componente usará o formato de texto padrão. -
Na barra lateral esquerda, clique no tipo de formato de Autenticação para atualizar suas propriedades.
- Deixe como está a seção de Ajuste de autenticação, que mostra o escopo e o segredo do seu provedor de autenticação como valores somente leitura.
- Na seção Ajuste da mensagem, forneça um aviso que solicita ao cliente que insira suas credenciais de login. Os clientes clicam no aviso para visualizar a tela de login. Para usar o aviso inserido quando você criou o componente, selecione Constante e selecione a única constante disponível.
- Na seção Ajuste de confirmação, selecione Literal e insira uma mensagem para ser exibida aos clientes depois que eles inserirem suas credenciais de login.
- Na seção Ajuste da imagem, forneça uma imagem a ser exibida com o componente. Para usar a imagem de que você fez upload quando criou o componente, selecione Constante e selecione a única constante disponível.
- Como opção, na barra lateral esquerda, clique no tipo de formato de Texto para atualizar a versão de texto simples do seu componente.
- Na seção Detalhes do seu componente, localize o campo URL de retorno e copie o URL.
- Clique em Salvar.
-
Seu componente é salvo em um estado de rascunho. Quando estiver pronto para disponibilizá-lo à sua equipe de suporte, clique em Ativar na parte superior da página.
Se você precisar desativar o componente (por exemplo, para ter tempo para reconfigurá-lo), abra-o no Criador de componentes de mensagens e clique em desativar. Quando estiver pronto, ative-o novamente.
-
Adicione dois URLs de redirecionamento para permitir que o provedor de identidade se comunique com o Salesforce.
- Nas configurações do seu provedor de identidade externo, acesse o aplicativo de autenticação que você criou.
- Adicione dois URLs à lista de URLs de redirecionamento: https://auth.businesschat.apple.com e o URL de retorno que você copiou dos detalhes do componente de autenticação.
Etapa 3: enviar uma solicitação de autenticação em uma sessão do Messaging
Você pode enviar componentes de mensagens de autenticação a clientes em canais do Apple Messages for Business aprimorado.
-
Durante uma sessão ativa de mensagens, clique na ação do componente de mensagens na janela de mensagens.
- Como opção, use o filtro na parte superior para mostrar apenas componentes de autenticação.
-
Selecione o componente que deseja compartilhar e clique em Inserir.
Um espaço reservado aparece abaixo do campo de mensagem. Nenhuma visualização do componente está disponível.
- Clique em Enviar.
- O cliente clica no link do componente e insere suas credenciais de login.
- Se as credenciais estiverem corretas, você (o representante de serviço) verá uma mensagem de Autenticação bem-sucedida. Se as credenciais estiverem incorretas, você verá uma mensagem de Autenticação negada. Você pode fornecer a eles uma segunda oportunidade enviando o componente de autenticação novamente.
O representante de serviço vê:
Para visualizar todas as tentativas de autenticação feitas em uma sessão de mensagens, acesse a lista relacionada Resultados da autenticação da sessão de mensagens no registro da sessão de mensagens. Cada registro nesta lista mostra o nível de verificação, o status da solicitação de autenticação (ativa ou expirada) e o horário em que a solicitação expirou ou expirará.
Por padrão, as solicitações de autenticação que usam provedores de autenticação compatíveis com o Salesforce expiram após uma hora, mas você pode alterar esse limite usando o Apex. Os provedores de autenticação externos têm seus próprios limites de expiração.
