- Página inicial
- /
- Artigo
Obrigado pelos seus comentários.
Neste artigo
Comentários?Crie e autentique um ativo digital de e-mail no Control Hub e, em seguida, atribua-o a um serviço Webex, como Webex Connect ou Webex Contact Center.
Visão geral
Use ativos digitais no Control Hub para configurar a caixa de correio e a autenticação OAuth 2.0 que os serviços Webex usam para interações por e-mail. Você gerencia o ativo no Control Hub e as cargas de trabalho Webex aprovadas o acessam por meio do serviço de ativos digitais compartilhados.
Ao criar o ativo, atribua-o ao serviço Webex que o usará. Depois que a autenticação for bem-sucedida, o Control Hub gera um endereço de encaminhamento para e-mails recebidos. Para o Webex Contact Center, você pode então associar o ativo a um ponto de entrada de e-mail. Para outra carga de trabalho Webex, continue a configuração nessa carga de trabalho depois de criar o ativo.
Antes de começar
- Entre no Control Hub como administrador completo, administrador de clientes ou administrador de parceiros que pode gerenciar ativos digitais para sua organização.
- Use um provedor de e-mail compatível. Para a integração do Webex Contact Center comWebex Connect, o Gmail e o Microsoft 365 são os fornecedores suportados. Para obter detalhes específicos do provedor, consulte Email - WXCC.
- Prepare a caixa de correio que você deseja configurar. Se você usa uma conta de serviço, certifique-se de que ela possa enviar e-mails e acessar essa caixa de correio.
- Trabalhe com o administrador do provedor de identidade para registrar um aplicativo OAuth, conceder consentimento e ativar as configurações do provedor, como SMTP AUTH ou encaminhamento externo.
- Esteja pronto para copiar o URL de retorno de chamada do Control Hub para o URL de redirecionamento do aplicativo OAuth e configurar o encaminhamento automático para o endereço gerado pelo ativo de e-mail.
Prepare o Gmail para o OAuth 2.0
Para preparar uma conta do Gmail para o ativo de e-mail:
| 1 |
Faça login no console do Google Cloud e crie um projeto ou selecione um projeto existente. |
| 2 |
Acesse APIs e serviços > tela de consentimento do OAuth, selecione Externo e insira o nome do aplicativo, o e-mail de suporte ao usuário e as informações de contato do desenvolvedor. |
| 3 |
Se o aplicativo permanecer em Teste, adicione a caixa de correio ou a identidade de geração de token como usuário de teste. Um projeto pode ter até 100 usuários de teste. |
| 4 |
Acesse APIs e serviços > Credenciais, crie um ID de cliente OAuth para um aplicativo Web e copie o ID do cliente e o segredo do cliente. |
| 5 |
Quando o Control Hub mostrar o URL de retorno de chamada, retorne ao cliente OAuth e adicione esse valor como um URI de redirecionamento autorizado. |
| 6 |
Para uso em produção, publique o aplicativo OAuth e conclua todas as verificações do Google necessárias para o escopo solicitado. |
| 7 |
Registre os seguintes valores do provedor para a configuração do Control Hub:
Para um aplicativo externo do Google OAuth em teste, as autorizações do usuário de teste e os tokens de atualização expiram sete dias após o consentimento. Publique o aplicativo para uso em produção. Se o Google não retornar um token de atualização, execute o fluxo de consentimento novamente e selecione Eu gostaria de revisar explicitamente antes de fornecer consentimento para autenticação quando essa opção estiver disponível. A documentação SMTP OAuth do Google explica o escopo do SMTP OAuth do Gmail. A orientação de público do OAuth do Google explica o comportamento do público interno e externo e do status de publicação. |
Prepare o Microsoft 365 para o OAuth 2.0
Para preparar uma caixa de correio do Microsoft 365 para o ativo de e-mail:
| 1 |
No centro de administração do Microsoft Entra, acesse Registros de aplicativos, selecione Novo registro e registre o aplicativo para os tipos de conta que sua organização permite. |
| 2 |
Registre o ID do aplicativo (cliente) e o ID do diretório (locatário). |
| 3 |
Em Autenticação, adicione uma plataforma Web. Quando o Control Hub mostrar o URL de retorno de chamada, adicione esse valor como o URI de redirecionamento. |
| 4 |
Em Certificados e segredos, crie um segredo do cliente e copie seu valor antes de sair da página. |
| 5 |
Para o fluxo de código de autorização interativo usado quando você seleciona Gerar tokens, adicione a permissão delegada SMTP.send do Office 365 Exchange Online (https://outlook.office.com/SMTP.Send) e solicite o escopo offline_access. Conceda o consentimento do administrador se a política de consentimento da sua organização exigir isso. |
| 6 |
No centro de administração do Microsoft 365, acesse Usuários > Usuários ativos, selecione o usuário da caixa de correio, selecione Correio > Gerenciar aplicativos de e-mail, ative o SMTP autenticado para essa caixa de correio e salve suas alterações. |
| 7 |
Registre os seguintes valores do provedor. Substitua {tenant-id} pelo ID do diretório (inquilino) do registro do aplicativo:
Use o escopo delegado https://outlook.office.com/SMTP.Send com offline_access para esse fluxo de token interativo. Ative o SMTP AUTH somente para a caixa de correio que precisa dele. Se sua organização alterou recentemente as configurações de consentimento do Microsoft Entra, aguarde até que as alterações entrem em vigor antes de gerar os tokens. As diretrizes de SMTP OAuth da Microsoft abrangem SMTP.send e offline_access delegados. A configuração SMTP AUTH da Microsoft explica como habilitar o SMTP AUTH para uma caixa de correio específica. |
Configurar o ativo de e-mail no Control Hub
Para configurar um ativo de e-mail:
| 1 |
Faça login no Control Hub. |
| 2 |
Acesse Serviços > Ativos digitais. |
| 3 |
Selecione Criar ativo. |
| 4 |
Na seção Configurar detalhes do ativo, insira valores nos seguintes campos:
|
| 5 |
Em Provedor de e-mail > Caixa de correio, insira o endereço de e-mail da caixa de correio que o ativo usa. |
| 6 |
Na seção Autenticação do OAuth 2.0, insira valores nos seguintes campos:
|
| 7 |
No seu provedor de identidade, adicione o URL de retorno de chamada do Control Hub ao aplicativo OAuth, salve a configuração do provedor e confirme se o URI de redirecionamento corresponde exatamente. |
| 8 |
Se a pessoa que concede o consentimento usar um endereço de e-mail diferente da caixa de correio, selecione Gerar tokens usando um endereço de e-mail diferente do endereço da caixa postal e insira essa identidade. Caixa de correio compartilhada: uma caixa de correio compartilhada não tem suas próprias credenciais de login . Gere tokens com um usuário que possa acessar a caixa de correio compartilhada e tenha a permissão Enviar como; o usuário não precisa de acesso de administrador. Selecione Gerar tokens usando um endereço de e-mail diferente do endereço da caixa de correio quando o endereço desse usuário for diferente da caixa de correio. |
| 9 |
Selecione Gerar tokens, conclua o fluxo de login e consentimento do provedor de identidade e retorne ao Control Hub. Depois que a geração do token for bem-sucedida, os campos Token de acesso, Token de atualização e Validade serão preenchidos automaticamente. Restrição de consentimento: se seu provedor bloquear o consentimento do usuário, desmarque que gostaria de revisar explicitamente antes de fornecer o consentimento para autenticação. A opção pode fazer com que a autenticação falhe porque o usuário não pode conceder o consentimento solicitado. Em vez disso, peça ao administrador do provedor que conceda o consentimento necessário. Se a geração de tokens não funcionar: no Gmail, verifique se o usuário pode autorizar o aplicativo e se o aplicativo tem o status de publicação correto. Para o Microsoft 365, verifique o escopo offline_access, a política de consentimento, o URI de redirecionamento e a configuração SMTP AUTH. Corrija a configuração do provedor e gere os tokens novamente. Renovação de token: o serviço atualiza os tokens antes que eles expirem. Se o proprietário de um inquilino receber um e-mail automático solicitando a regeneração do token, abra o ativo e selecione Gerar tokens novamente. |
| 10 |
Depois que a geração do token for bem-sucedida, selecione Criar. Se o ativo estiver atribuído ao Webex Contact Center, selecione Ir para pontos de entrada e continue a configuração do Contact Center. Para outra carga de trabalho Webex, feche a página de confirmação e continue a configuração nessa carga de trabalho. |
Configurar o encaminhamento de e-mails recebidos
Primeiro, copie o endereço de encaminhamento gerado para o ativo:
| 1 |
Em Ativos digitais, abra o ativo de e-mail e selecione Configurações. |
| 2 |
Em Provedor de e-mail > Caixa de correio, copie o endereço de encaminhamento associado ao endereço de e-mail da caixa de correio. |
Configurar o encaminhamento no Gmail
Para encaminhar mensagens recebidas do Gmail para o ativo de e-mail:
| 1 |
Se você usa o Google Workspace, verifique se o administrador permite o encaminhamento automático para a unidade organizacional da caixa de correio em Aplicativos > Google Workspace > Gmail > Acesso do usuário final. |
| 2 |
Faça login na caixa de correio de suporte no Gmail e acesse Configurações > Ver todas as configurações > Encaminhamento e POP/IMAP. |
| 3 |
Selecione Adicionar um endereço de encaminhamento, cole o endereço de encaminhamento do Control Hub e preencha as solicitações de confirmação. O Gmail envia um link ou código de verificação para o endereço gerado. |
| 4 |
Recupere o link ou código de verificação da carga útil do Webhook de saída para e-mails de entrada dentro Webex Connect ou de todo o corpo do e-mail nos registros de depuração descriptografados do ativo de e-mail. Em seguida, conclua a verificação do Gmail. |
| 5 |
Retorne às configurações de encaminhamento do Gmail, atualize a página, selecione Encaminhar uma cópia do e-mail recebido para, escolha o que o Gmail deve fazer com a cópia e selecione Salvar alterações. |
Configurar o encaminhamento no Microsoft 365
Para encaminhar mensagens recebidas do Microsoft 365 para o ativo de e-mail:
| 1 |
Configure o encaminhamento de caixa de correio ou uma regra de caixa de entrada para a caixa de correio de suporte para que novas mensagens sejam enviadas para o endereço de encaminhamento a partir do Control Hub. |
| 2 |
No portal do Microsoft Defender, revise a política de spam de saída que se aplica à caixa de correio. Defina as regras de encaminhamento automático como Ativado - O encaminhamento está ativado em uma política de escopo restrito que seu administrador de segurança aprovou. |
| 3 |
No Exchange Online, verifique se a configuração de domínio remoto aplicável permite o encaminhamento automático para o domínio do endereço de encaminhamento. |
| 4 |
Revise as regras de fluxo de mensagens do Exchange e certifique-se de que nenhuma regra bloqueie as mensagens encaminhadas automaticamente. Se você precisar de uma exceção, limite-a à caixa de correio de suporte e ao destino aprovado. |
| 5 |
Salve a configuração de encaminhamento e dê tempo para que as alterações na política do Microsoft 365 entrem em vigor. Obrigatório: o e-mail de entrada não alcançará a carga de trabalho do Webex atribuída até que o encaminhamento seja ativado. No Microsoft 365, uma política de bloqueio de spam de saída, uma configuração de domínio remoto ou uma regra de fluxo de email tem precedência sobre uma configuração que permite o encaminhamento. Limite de anexos: os anexos de e-mail recebidos são limitados a 25 MB. Se uma mensagem falhar porque seus anexos são muito grandes, o remetente recebe uma mensagem de falha na entrega e deve reenviá-la com anexos menores. Imagens embutidas: as imagens embutidas chegam como anexos na área de trabalho do agente. Se a digitalização PCI estiver ativada, essas imagens serão bloqueadas. Microsoft Outlookanexos: um e-mail de entrada com um anexo.msg pode chegar sem os arquivos incorporados nesse .msg devido a uma limitação. Microsoft Outlook |
Teste o ativo de e-mail
Para verificar o caminho completo do e-mail:
| 1 |
De uma conta de e-mail externa, envie uma mensagem para a caixa de correio de suporte configurada e certifique-se de que a mensagem alcance a carga de trabalho atribuída ao Webex. |
| 2 |
A partir da carga de trabalho Webex atribuída, envie uma nova mensagem ou responda à mensagem de entrada e certifique-se de que o destinatário externo a receba. Status da entrega: o e-mail enviado pelo canal SMTP não inclui rastreamento de entrega e o serviço não recebe notificações de falha na entrega . Confirme a entrega da caixa de correio do destinatário durante o teste. |
| 3 |
Se a entrega de entrada não funcionar, verifique a confirmação do endereço de encaminhamento, a regra de encaminhamento e as políticas de encaminhamento da organização do provedor. |
| 4 |
Se o envio externo não funcionar, verifique o servidor e a porta SMTP, as permissões do provedor, as credenciais do cliente, o consentimento, a configuração SMTP AUTH do Microsoft 365 e o status do token. Corrija o problema e gere tokens novamente, se necessário. |
