Integração OAuth2 – Citrus.cx https://hml-docs.citrus.cx Base de Conhecimento Mon, 03 Nov 2025 14:00:20 +0000 pt-BR hourly 1 https://wordpress.org/?v=6.9.4 https://hml-docs.citrus.cx/wp-content/uploads/2023/08/cropped-doc-citrus_LOGO-FAVICON-1-32x32.png Integração OAuth2 – Citrus.cx https://hml-docs.citrus.cx 32 32 Tabela de Versionamento https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/tabela-de-versionamento/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/tabela-de-versionamento/#respond Tue, 27 Aug 2024 14:21:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/tabela-de-versionamento/
Versão Última Atualização
2.106.0
27/08/2024

Por esta tabela é possível acompanhar todas as atualizações reportadas em Tutoriais e Manuais.

  • Nas telas de documentações que exibem a informação “Confira a Tabela de Versionamento”, pressione sobre a mensagem para ser encaminhado para esta tela com todas as versões contempladas. A seguir, basta abrir a versão indicada para acompanhar as atualizações correspondentes.
]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/tabela-de-versionamento/feed/ 0 Configuração https://hml-docs.citrus.cx/docs/guias-de-atendimento/canais-de-atendimento-1/e-mail/configurar-canal-e-mail/ https://hml-docs.citrus.cx/docs/guias-de-atendimento/canais-de-atendimento-1/e-mail/configurar-canal-e-mail/#respond Tue, 27 Aug 2024 14:20:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/configurar-canal-e-mail/ Atendimentos > Integração canal de atendimento > Configuração de integração do canal de atendimento > (botão) +Novo). Preencha os seguintes campos obrigatórios: – Nome: Um nome que define a integração do canal de atendimento. – Canal de atendimento: Opção “E-mail”. – Tipo: Opção […]]]>
  1. Acesse a tela Configuração de integração do canal de atendimento (Administração > Atendimentos > Integração canal de atendimento > Configuração de integração do canal de atendimento > (botão) +Novo).


  2. Preencha os seguintes campos obrigatórios:


    - Nome: Um nome que define a integração do canal de atendimento.

    - Canal de atendimento: Opção "E-mail".

    - Tipo: Opção "E-mail".


  3. Clique no botão Salvar e continuar no topo direito da tela.


  4. No bloco Configuração de Email preencha os seguintes campos obrigatórios:


    - Setor: Selecione o Setor responsável por este Canal de atendimento.

    - Nome do remetente: Nome que identifica o remetente do email.

    - Email do remetente: Endereço de email de entrada dos Atendimentos.

    - SMTP: Servidor para envio de mensagens.

    - Porta SMTP: Número da porta terminal de comunicação.

    - IMAP: Servidor para verificação de mensagens.

    - Porta IMAP: Número da porta terminal de comunicação.

    - Usuário: Login de acesso da caixa de email do endereço informado.

    - Senha: Senha de acesso da caixa de email do endereço informado.


  5. Marque as flags abaixo conforme cada recurso:


    - "Habilitar TLS": Se o servidor de email informado utiliza protocolo de segurança.

    - "Habilitado": Para que a plataforma faça a leitura da caixa de email configurada.


    DICA

    A flag "Habilitado" indica que a abertura de Protocolos no Pré-atendimento está habilitada. Se não for marcada, as mensagens de email enviadas pelos clientes com solicitação de atendimento não são registradas pela plataforma.


    - "Habilitar agendamento de campanha de e-mail": O endereço de email configurado é exibido na tela Agendamentos para ser utilizado como remetente de Campanhas do Tipo "Envio de e-mail". - Habilitar agendamento de campanha de e-mail: O endereço de email configurado é exibido na tela Agendamentos para ser utilizado como remetente de Campanhas do Tipo "Envio de e-mail".


  6. Clique no botão Entrar indicado como "Integração OAuth2", para entrar com a conta Microsoft e autorizar protocolos SMTP e IMAP.


    DICA

    * Consulte o Guia do Administrador para E-mail Microsoft Office 365 com autenticação OAuth 2.0 .


  7. Utilize o campo Resposta automática para configurar uma mensagem a ser enviada automaticamente pela plataforma.


  8. Na seção abaixo Testar Envio de Email preencha com o endereço de email e clique no botão Enviar para verificar a integração.


  9. No bloco Não considerar abertura de Pré-atendimento para os seguintes emails, se desejar preencha com o endereço de email e clique no botão (+) para adicionar.


    DICA

    - Este recurso é utilizado para restringir mensagens spam na plataforma.

    - Para incluir mais de um email por vez separe-os com ponto e vírgula (;).


  10. No bloco Configurações de conversão automática de Pré-atendimento para Atendimento, marque a flag "Habilitar conversão automática de emails em atendimento" se desejar que todos os emails recebidos no Pré-atendimento sejam convertidos em Atendimentos pela plataforma.


    * Confira como configurar Conversão Automática no canal de E-mail e Distribuição Automática de Atendimentos.


  11. Clique no botão Salvar no topo direito da tela.



]]> https://hml-docs.citrus.cx/docs/guias-de-atendimento/canais-de-atendimento-1/e-mail/configurar-canal-e-mail/feed/ 0 Configuração https://hml-docs.citrus.cx/docs/guias-de-atendimento/canais-de-atendimento-1/webchat/configurar-canal-webchat/ https://hml-docs.citrus.cx/docs/guias-de-atendimento/canais-de-atendimento-1/webchat/configurar-canal-webchat/#respond Tue, 27 Aug 2024 14:20:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/configurar-canal-webchat/
  1. Acesse a tela Configuração de integração do canal de atendimento (Administração > Atendimentos > Integração canal de atendimento > Configuração de integração do canal de atendimento > (botão) +Novo).


  2. Preencha os seguintes campos obrigatórios:


    - Nome: Um nome que define a integração do canal de atendimento.

    - Canal de atendimento: Opção "Chat".

    - Tipo: Opção "WebChat".


  3. Clique no botão Salvar e continuar no topo direito da tela.


  4. Se desejar, marque as seguintes flags e preencha os campos referentes ao Tipo "WebChat":


    - "Habilitar informar posição fila": A posição na Fila é informada ao cliente junto com a mensagem configurada no campo Mensagem.

    - "Habilitar mensagem de finalização de atendimento": o campo passa a ser de preenchimento obrigatório. Essa mensagem é enviada ao cliente quando o Atendente finaliza o chamado.

    - "Habilitar mensagem padrão ao entrar na fila": o campo Mensagem passa a ser de preenchimento obrigatório. Essa mensagem é enviada para o cliente ao entrar na fila.

    - Mensagem padrão ao aceitar um atendimento: Essa mensagem é enviada ao cliente quando o Atendente aceita o chamado.

    - "Habilitar envio do número do protocolo antes da transferência para o atendimento": Se marcada, o cliente recebe o número do protocolo quando o Atendente aceita o chamado.


  5. Para o Tipo "WebChat" com bot, a flag "Habilitar bot" deve ser marcada e o campo Corpo de conhecimento preenchido pelo time de Implantação ou Suporte da Smartspace by Digivox.


  6. No bloco Configuração de WebChat preencha como desejar as opções abaixo:


    - Avatar do bot: Utilize os botões Selecionar ou Descartar para colocar uma imagem.

    - Nome do bot: Um nome que identifique o bot.

    - Cor primária do chat: Digite o código RGB ou clique no ícone ao lado do campo para usar a paleta de cores.

    - Saudação de boas-vindas: Uma frase de saudação ao cliente.

    - Tempo para início do popup: Tempo de espera em segundos para início de interação da tela WebChat.

    - Habilitar anexo do chat: Se marcada essa flag, é adicionado o ícone de anexo na tela WebChat para o cliente enviar arquivos durante a conversa.

    - Enviar diálogo do chat automaticamente para o cliente ao salvar o atendimento: Se desejar, marque essa flag para a plataforma enviar a conversa quando o atendimento for salvo pelo Atendente.

    - Online: Utilize o botão Selecionar para incluir uma imagem que exiba no Website da empresa o canal quando ativo.

    - Offline: Utilize o botão Selecionar para incluir uma imagem que exiba no Website da empresa o canal quando inativo.


  7. Ainda no bloco Configuração de WebChat preencha no campo obrigatório Url do Chat o nome que define o link de acesso ao canal WebChat da empresa.


    Exemplo: https://citrus.cx/webchat/comercial


  8. Selecione o campo opcional Formulário Web se desejar disponibilizar aos clientes o canal WebChat fora do horário de expediente da empresa.


    * Confira como configurar Formulário Web.


  9. Selecione o campo obrigatório Escolha os dados que serão usados para montar a tela do WebChat com a opção dos campos já configurados para tela inicial do WebChat.


    * Confira como configurar Attached data.


  10. Se desejar, marque a flag "Habilitar exibição de mensagem para confirmação no popup", para configurar uma etapa antes do preenchimento da tela inicial do WebChat pelo cliente.


  11. Se no passo 10 a flag for marcada, é exibida a seção com os seguintes campos obrigatórios:


    - Pergunta de confirmação: Uma pergunta ao cliente para confirmar sua solicitação de atendimento.

     * Exemplo: "Este é um canal exclusivo para atendimento do SAC. Você deseja seguir com esse atendimento?"

    - Texto do botão de confirmação: Texto exibido no botão de seguir a operação.

    - Texto do botão de cancelar a operação: Texto exibido no botão de cancelar a operação.

    - Mensagem: Mensagem que é exibida se o usuário clicar no botão de cancelar a operação.

     * Exemplo: "Para atendimentos em outros setores, ligue para o 0800."

    DICA

    É possível utilizar tags HTML para customizar a Pergunta de confirmação e a Mensagem.

     * Exemplo:

    "Para atendimentos em outras setores, <-a href="http://www.atendimentos.com.br" target="_blank"->Clique aqui<-a>."


  12. A flag "Habilitar chave para fluxo alternativo popup" é opcional, se desejar utilizar o recurso "Fluxo Alternativo do WebChat". Essa flag é exibida na tela somente se o recurso for habilitado nas Configurações Gerais da plataforma.


    * Confira como configurar Fluxo Alternativo do WebChat.


  13. No bloco Configuracão do roteamento clique no botão +Novo Assunto. É aberto na tela o popup para preenchimento dos campos obrigatórios Assunto e Palavra-chave. Digite o mesmo nome nesses campos e clique no botão Salvar para cadastrar o Assunto.


  14. Após o passo 13, selecione nos campos obrigatórios o Assunto e a Fila correspondente para configurar o roteamento e transferência ao Atendente.


  15. Clique no botão Salvar abaixo para adicionar na tabela. Se desejar excluir algum item, clique no ícone da Lixeira ao lado.


  16. Clique no botão Salvar no topo direito da tela.



– Após salvar a Configuração de integração do canal de atendimento do Tipo “WebChat”, a plataforma redireciona o Administrador para tela de listagem. Clique sobre o “Nome” dessa integração, ao acessar a tela role a página até o final, clique no botão Copiar do campo Código do Pop-Up e adicione o script gerado automaticamente pela plataforma na página HTML do Website da empresa.  

– Ao lado do campo Url do Chat, utilize o botão Abrir Chat para verificar a funcionalidade da tela inicial desse Canal de atendimento. 

]]> https://hml-docs.citrus.cx/docs/guias-de-atendimento/canais-de-atendimento-1/webchat/configurar-canal-webchat/feed/ 0 Configurar Integração do Canal https://hml-docs.citrus.cx/docs/guias-de-atendimento/canais-de-atendimento-1/whatsapp/configurar-canal-whatsapp/ https://hml-docs.citrus.cx/docs/guias-de-atendimento/canais-de-atendimento-1/whatsapp/configurar-canal-whatsapp/#respond Tue, 27 Aug 2024 14:19:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/configurar-canal-whatsapp/
  1. Acesse a tela Configuração de integração do canal de atendimento (Administração > Atendimentos > Integração canal de atendimento > Configuração de integração do canal de atendimento > (botão) +Novo).


  2. Preencha os seguintes campos obrigatórios:


    - Nome: Um nome que define a integração do canal de atendimento.

    - Canal de atendimento: Opção "WhatsApp".

    - Tipo: Opção "WhatsApp".


  3. Clique no botão Salvar e continuar no topo direito da tela.


  4. Se desejar, marque as seguintes flags e preencha os campos referentes ao Tipo "WhatsApp":


    - "Habilitar mensagem de finalização de atendimento": o campo Mensagem passa a ser de preenchimento obrigatório. Essa mensagem é enviada ao cliente quando o Atendente finaliza o chamado.

    - "Habilitar mensagem padrão ao entrar na fila": o campo Mensagem passa a ser de preenchimento obrigatório. Essa mensagem é enviada para o cliente ao entrar na fila.

    - Mensagem padrão ao aceitar um atendimento: Essa mensagem é enviada ao cliente quando o Atendente aceita o chamado.

    - "Habilitar envio do número do protocolo antes da transferência para o atendimento": Se marcada, o cliente recebe o número do protocolo quando o Atendente aceita o chamado.


  5. Para o Tipo "WhatsApp" com bot, a flag "Habilitar bot" deve ser marcada e o campo Corpo de conhecimento preenchido pelo time de Implantação ou Suporte da Smartspace by Digivox.


  6. No bloco Configuração de WhatsApp, preencha os seguintes campos obrigatórios:


    - Número do telefone: Selecione o númera da conta WhatsApp Business API, já integrada na plataforma.

    - Nome do bot: O nome desejado para identificar a conta. Deve ser preenchido independente de um bot.

    - Mensagem padrão após 24h sem interação: Uma mensagem que informe ao cliente que sua sessão foi encerrada por sua falta de comunicação.


  7. No bloco Configuracão do roteamento clique no botão +Novo Assunto. É aberto na tela o popup para preenchimento dos campos obrigatórios Assunto e Palavra-chave. Digite o mesmo nome nesses campos e clique no botão Salvar para cadastrar o Assunto.


  8. Após o passo 7, selecione nos campos obrigatórios o Assunto e a Fila correspondente para configurar o roteamento e transferência ao Atendente.


  9. Clique no botão Salvar abaixo para adicionar na tabela. Se desejar excluir algum item, clique no ícone da Lixeira ao lado.


  10. Clique no botão Salvar no topo direito da tela.



Informações reunidas nesta documentação

]]> https://hml-docs.citrus.cx/docs/guias-de-atendimento/canais-de-atendimento-1/whatsapp/configurar-canal-whatsapp/feed/ 0 Pré-requisitos https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/pre-requisitos/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/pre-requisitos/#respond Tue, 27 Aug 2024 14:18:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/pre-requisitos/

O Administrador deve possuir permissões de acesso concedidas ao seu Perfil pelo time de Implantação ou Suporte da Smartspace by Digivox. 

Para cada Tipo de Canal de atendimento abaixo, é necessário já ter configurado na plataforma junto ao time de Implantação da Smartspace by Digivox: 

  • Email:  

– Os Setores. 

– Para autenticação de servidor de email Office 365, consulte E-mail Microsoft Office 365 com autenticação OAuth 2.0 . 

– Para autenticação de servidor de email Google, consulte Autenticação de e-mail do Google . 

 

  • WebChat: 

– O Attached data com Campos Extras da tela inicial do WebChat. 

– As Filas de atendimento, e em caso de uso com Chatbot, o fluxo do bot desenvolvido pelo time de Desenvolvimento da Smartspace by Digivox.  

– O Formulário Web para uso do canal fora do horário de expediente. 

– O Fluxo alternativo para o recurso de autenticação do cliente nesse canal. 

 

  • WhatsApp: 

– Número de telefone do WhatsApp Business API. 

– Filas de atendimento, e em caso de uso com Chatbot, o fluxo do bot desenvolvido pelo time de Desenvolvimento da Smartspace by Digivox. 

]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/pre-requisitos/feed/ 0 Permissões https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/permissoes/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/permissoes/#respond Tue, 27 Aug 2024 14:18:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/permissoes/

O Administrador precisa ter as seguintes permissões habilitadas em seu Perfil: 

– Administração 

– Configurações Gerais

– Listar integração canal atendimento 

– Criar integração canal atendimento 

– Editar integração canal atendimento 

– Excluir integração canal atendimento
 

 

* Confira como configurar Perfis de acesso.   

]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/integracao-de-canais-de-atendimento-10336/permissoes/feed/ 0 Configurações de comunicação https://hml-docs.citrus.cx/docs/get-started/administracao/configuracoes-de-comunicacao-10764/ https://hml-docs.citrus.cx/docs/get-started/administracao/configuracoes-de-comunicacao-10764/#respond Mon, 13 Nov 2023 13:21:50 +0000 https://docs.citrus.cx/docs/get-started/plataforma-citrus-cx-10735/configuracoes-de-comunicacao/

Todas as interações nos atendimentos com o cliente, notificações de usuários da plataforma e campanhas podem ser disparadas através de um e-mail de saída configurado e algumas atualizações, como comentários no protocolo, por SMS. 

Na tela de Configurações de comunicação (Administração> Configurações Gerais > Configuração de comunicação) será possível configurar os serviços para o envio de e-mails e SMS para seus clientes diretamente pelo Citrus, seja para informar o andamento de algum atendimento ou envio de alguma campanha. 

Para iniciar a configuração, basta seguir as instruções:

1. Acesse o menu Administração > Configurações Gerais > Configuração de comunicação e será exibida a seguinte tela: 

2. Na aba Servidor de E-mail, poderá ser informado os dados do servidor de E-mail que realizará o envio de e-mails para os clientes. Basta preencher os dados solicitados:

– Servidor SMTP: Informar o servidor SMTP a ser configurado neste campo (campo obrigatório).
– Porta SMTP: Informar a porta de comunicação a ser utilizada pelo servidor SMTP, exemplo 587 (campo obrigatório).
– Servidor IMAP: Informar o servidor IMAP a ser configurado na integração do canal de atendimento em questão (campo obrigatório).
– Porta IMAP: Deverá ser informada a porta do servidor IMAP a ser configurada, exemplo 993 (campo obrigatório).
– Email de Saída: Deverá ser informado por qual conta de e-mail será realizado o envio.
– Identificador: Informar o endereço de e-mail que será identificado nas mensagens enviadas (campo obrigatório).
– Login: Informe o login de acesso do e-mail.
– Senha: Informe a senha de acesso do e-mail.
– Habilitar TLS: Caso o e-mail a ser configurado possua TLS essa flag deverá ser habilitada
– Integração OAuth2: Habilitar essa opção caso escolha utilizar um dos provedores de e-mail com suporte a IMAP e SMTP via XOAUTH2 (Office 365, Google Workspaces, etc)

 

3. Após preencher as informações da configuração do servidor de E-mail, clique em Salvar.

 

4. No canto direito, temos o campo Testar Envio de Email onde pode ser inserido um endereço de e-mail para testar o funcionamento da configuração, para utilizar insira o endereço de e-mail e clique em Enviar para o cliente.

 

5. Na aba Integração com SMS, será possível configurar o envio de mensagens de texto para os clientes diretamente pelo Citrus. Preencha os campos:

– Broker: Selecione a opção referente ao broker para envio de mensagens
– Token de Acesso*:  Informe o código token de acesso (campo obrigatório).
– Integration ID: Informe o código de integração registrado no DCS. Esse código somente é obrigatório para integração com o broker DCS (campo obrigatório).
– WebHook: Informe o endereço de webhook (campo obrigatório).
– Habilitado: Marque essa opção para manter o envio de SMS habilitado.

 

6. Após preencher as informações sobre o SMS, clique em Salvar

 

7. Na parte inferior à esquerda, temos o campo Teste de envio de SMS onde pode ser inserido um número de telefone com DDD para testar o funcionamento da configuração, basta informar o número de telefone celular e clicar em Enviar para o cliente. 

 

Realizada alguma dessas duas configurações, o Citrus já estará configurado corretamente para realizar o envio de notificações.  

]]> https://hml-docs.citrus.cx/docs/get-started/administracao/configuracoes-de-comunicacao-10764/feed/ 0 Autenticação de e-mail Microsoft Office 365 https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/e-mail-microsoft-office-365-com-autenticacao-oauth-2-0-11022/ https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/e-mail-microsoft-office-365-com-autenticacao-oauth-2-0-11022/#respond Fri, 09 Dec 2022 14:52:00 +0000 https://docs.citrus.cx/docs/guia-do-usuario/administrador-configuracoes-10273/configuracoes-adicionais-10526/e-mail-microsoft-office-365-com-autenticacao-oauth-2-0/

E-mail Microsoft com autenticação OAuth 2.0

Clientes que utilizam serviços de e-mail Microsoft precisam de autorização baseada em token OAuth 2.0 desde outubro de 2022, quando a empresa de tecnologia começou a desativar a autenticação básica para vários protocolos de locatários por vulnerabilidades de segurança (a interrupção definitiva se deu a partir de janeiro de 2023).

Consulte o comunicado emitido pela Microsoft.

A plataforma Citrus adequou-se à implementação da Microsoft a partir da versão 2.57.0. A adaptação permite aos clientes que utilizam o serviço de e-mail Microsoft 365 (Exchange Online) realizar integrações com a plataforma Citrus de acordo com as normas de segurança.

Benefícios

  • Segurança aprimorada (sem senhas expostas): O usuário nunca precisa compartilhar sua senha com o aplicativo. A autenticação ocorre diretamente no endpoint seguro da Microsoft.
  • Autenticação compatível com MFA: Totalmente compatível com Autenticação Multifator (MFA), FIDO2, Windows Hello, e outros métodos. Suporta Microsoft Entra Conditional Access, permitindo aplicar políticas por usuário, dispositivo, localização etc.
  • Acesso limitado e específico: Permite controlar se o acesso é delegado (em nome do usuário) ou em nome da aplicação.
  • Integração: O OAuth 2.0 é o padrão exigido para acessar serviços como: Outlook / Exchange Online; OneDrive e SharePoint; Microsoft Teams; Microsoft Graph API (para dados unificados de usuários, grupos e mensagens). Além de permitir integrações seguras com automações, Power Automate, N8N e sistemas próprios.
  • Tokens temporários e renováveis: O uso de access tokens e refresh tokens evita a necessidade de armazenar credenciais. O token expira automaticamente e pode ser renovado com segurança usando o refresh_token. Facilita a revogação e o controle de sessão.
  • Fluxos flexíveis para diferentes cenários: A Microsoft oferece múltiplos fluxos de autenticação, adaptáveis ao tipo de aplicação.

Ativar consentimento do usuário no Microsoft Office 365

Clientes que utilizam uma conta de e-mail do Microsoft 365, com privilégio de Administrador, precisam ativar o consentimento de uso para permitir que aplicativos utilizem o OpenID Connect e o OAuth 2.0. Essas permisões são necessárias para autenticação e solicitação de acesso a dados.

* A configuração deve ser feita somente nos endereços de e-mail com privilégios de Administrador da conta Microsoft 365.

Para liberar o acesso, siga o passo a passo:

  1. Acesse a sua conta corporativa do Microsoft Office 365, como Administrador Global .
  2. Navegue até Entra ID > Aplicativos Corporativos > Consentimento e permissões > Configurações de consentimento do Administrador.
  3. Em Solicitações de consentimento do Administrador selecione "Sim" para usuários que podem solicitar consentimento do Administrador para os aplicativos para os quais não podem consentir.
  4. Defina as seguintes configurações:

    • Quem pode examinar as solicitações de consentimento do Administrador: Selecione usuários, grupos ou perfis designados como revisores para solicitações de consentimento do Administrador.

    • Usuários que serão notificados por e-mail para solicitações: Habilite ou desabilite as notificações por e-mail para os revisores, quando uma solicitação for feita.

    • Usuários que receberão lembretes sobre expiração de solicitações: Habilite ou desabilite as notificações de e-mail de lembrete aos revisores quando uma solicitação estiver prestes a expirar.

    • Quando solicitações expiram: Especifique por quanto tempo (dias) as solicitações permanecem válidas.

  5. Pressione Salvar.


    IMPORTANTE

    IMPORTANTE

    • Pode levar até uma hora para que o fluxo de trabalho seja habilitado.

    • É possível adicionar ou remover revisores para este fluxo de trabalho, modificando a lista de quem pode revisar solicitações de consentimento de Administrador.

    • Uma limitação desse recurso é que os revisores mantêm a capacidade de revisar as solicitações feitas enquanto eles estavam designados como revisores, e receberão e-mails de lembrete de expiração para essas solicitações depois que eles forem removidos da lista de revisores. Além disso, novos revisores não serão atribuídos às solicitações criadas antes de serem definidos como revisores.

    Mais detalhes na documentação Microsoft .


Configurar autenticação de e-mail de saída no Citrus

Todas as interações nos atendimentos com o cliente e notificações de usuários da plataforma Citrus são disparadas através de um e-mail de saída configurado.

Para realizar este tipo de comunicação utilizando uma conta Microsoft Office 365 existem algumas etapas que precisam ser seguidas. 

Confira as próximas instruções:

  1. Acesse o menu Administração > Configurações Gerais > Configuração de Comunicação.
  2. Na aba Servidor de e-mail devem ser informados os dados de autenticação da conta de e-mail.
  3. Para realizar a autenticação Microsoft clique no botão Entrar abaixo de "Integração OAuth2".
  4. Será exibido um pop-up da Microsoft para selecionar qual conta de e-mail deverá ser associada.

    Insira/selecione os dados de acesso e, em seguida, clique em Aceitar nas permissões listadas para acesso.


  5. Após logar e concluir a ação no pop-up da Microsoft, clique em Salvar para finalizar a configuração no Citrus.
  6. Teste o envio para validar o funcionamento do servidor de e-mail.

    Caso seja exibido o aviso de "Necessidade de aprovação de Administrador", será preciso conceder permissões nas configurações da conta na Microsoft.

Integrar e-mail no canal de atendimento

Depois da ativação de consentimento do usuário na Microsoft Office 365 e configuração de autenticação do e-mail de saída no Citrus será necessário realizar a Configuração de integração do canal de atendimento (no Citrus), para vincular os canais de atendimento cadastrados a serviços externos usados por sua empresa. Neste caso, o “E-mail”.

A partir dessa configuração os Atendentes poderão centralizar todas as suas operações, facilitando e agilizando o contato com clientes.

Proceda como a seguir:

  1. Acesse o menu Administração > Atendimentos > Integração canal de atendimento. 
  2. Clique em +Novo para incluir um novo canal de atendimento.
  3. Serão exibidos os primeiros campos para cadastro, preencha conforme solicitado:

    • Nome*: Informe um nome para identificar o canal.

    • Canal de atendimento*: Selecione o canal “E-mail”.

    • Tipo*: Selecione o tipo de canal de atendimento que será cadastrado. No caso, “E-mail”.

  4. Presssione Salvar e continuar.

  5. Na próxima tela do cadastro a opção de "Integração OAuth2" será novamente exibida.

    Clique em Entrar, insira as credenciais de e-mail e pressione Aceitar para concordar com termos de uso.

  6. Ao finalizar as configurações, clique em Salvar no topo da tela de Integração canal de atendimento. 

Confira o Guia Integração com Provedor de Identidade

]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/e-mail-microsoft-office-365-com-autenticacao-oauth-2-0-11022/feed/ 0