Configurar painéis personalizados

Um painel personalizado mostra um ou mais URLs de recursos externos. Podem ser documentação, ferramentas ou outros recursos. É possível configurar um painel para um URL personalizado ou um painel de links personalizados com vários links. As opções de configuração para esses tipos de painel variam um pouco. Por exemplo, você pode especificar o texto do link no painel de links personalizados.

Configurar um painel para um URL personalizado

É possível configurar um painel personalizado com um URL para um recurso externo. Você pode incluir uma barra de navegação no painel. Também é possível adicionar cabeçalhos HTTP, por exemplo, para autenticação.

Para configurar um painel para um URL personalizado, siga estas etapas:

  1. No portal da plataforma CCAI, clique em Configurações > Gerenciamento de operações. Se o menu Configurações não aparecer, clique em Menu.

  2. Acesse o painel Área de trabalho do agente.

  3. Em Gerenciamento de painéis personalizados, clique em Gerenciar lista de painéis personalizados. O painel Painel personalizado vai aparecer.

  4. Clique em Adicionar painel personalizado > URL personalizado. O painel Adicionar URL personalizado vai aparecer.

  5. Para adicionar um nome ao painel personalizado, faça o seguinte:

    1. Clique no campo Selecionar idioma e escolha uma opção para o nome do painel personalizado.

    2. No campo Insira o nome do painel personalizado, digite um nome para o painel.

  6. Opcional: para adicionar um nome de painel em outro idioma, clique em Adicionar nome de painel personalizado e repita as etapas com um idioma diferente.

  7. Se você adicionou o nome do painel em vários idiomas, selecione o idioma padrão.

  8. No campo URL de exibição, insira o URL de um recurso externo. É possível usar variáveis e funções no URL.

  9. Opcional: para controlar dinamicamente o idioma do painel personalizado com base no local atribuído ao agente ou na seleção de idioma, consulte Controlar dinamicamente o idioma do painel personalizado.

  10. Marque a caixa de seleção Mostrar uma barra de navegação no painel personalizado se quiser que uma barra de navegação apareça com esse painel.

  11. Para adicionar um cabeçalho HTTP, faça o seguinte:

    1. Em Cabeçalhos HTTP, clique em Adicionar campo.

    2. Insira uma chave e um valor para o cabeçalho HTTP. É possível usar variáveis e funções no valor.

  12. Para adicionar outro cabeçalho HTTP, clique em Adicionar campo e repita essas etapas.

  13. Clique em Adicionar painel de URL personalizado. Seu painel personalizado aparece na lista Painel personalizado.

É possível configurar um painel personalizado com uma lista de links para recursos externos. Esse painel oferece aos agentes acesso rápido aos recursos necessários durante o atendimento de chamadas e sessões de chat.

Para configurar um painel de links personalizados, siga estas etapas:

  1. No portal da plataforma CCAI, clique em Configurações > Gerenciamento de operações. Se o menu Configurações não aparecer, clique em Menu.

  2. Acesse o painel Área de trabalho do agente.

  3. Em Gerenciamento de painéis personalizados, clique em Gerenciar lista de painéis personalizados. O painel Painel personalizado vai aparecer.

  4. Clique em Adicionar painel personalizado > Links personalizados. O painel Adicionar painel de links personalizados aparece.

  5. Para adicionar um nome ao painel personalizado, faça o seguinte:

    1. Clique no campo Selecionar idioma e escolha uma opção para o nome do painel personalizado.

    2. No campo Insira o nome do painel personalizado, digite um nome para o painel.

  6. Opcional: para adicionar um nome de painel em outro idioma, clique em Adicionar nome de painel personalizado e preencha a nova linha usando um idioma diferente.

  7. Se você adicionou o nome do painel em vários idiomas, selecione o idioma padrão.

  8. Para adicionar um link, faça o seguinte:

    1. Clique em Adicionar link. O painel Adicionar link aparece.

    2. No campo URL, insira o URL de um recurso externo. É possível usar variáveis e funções no URL.

    3. Opcional: para controlar dinamicamente o idioma do painel personalizado com base no local atribuído ao agente ou na seleção de idioma, consulte Controlar dinamicamente o idioma do painel personalizado.

  9. Para adicionar um texto de link ao URL, faça o seguinte:

    1. Clique no campo Selecionar idioma e depois em um idioma para o texto do link.

    2. No campo Texto do link, digite o texto do link.

  10. Opcional: para adicionar um texto de link em outro idioma, clique em Adicionar texto do link e preencha a nova linha usando um idioma diferente.

  11. Se você adicionou texto do link em vários idiomas, selecione o idioma padrão.

  12. Em Mostrar link em, especifique se o link será aberto em uma nova guia ou no painel.

  13. Para adicionar um cabeçalho HTTP, faça o seguinte:

    1. Em Cabeçalhos HTTP, clique em Adicionar campo.

    2. Insira uma chave e um valor para o cabeçalho HTTP. É possível usar variáveis e funções no valor.

  14. Para adicionar outro cabeçalho HTTP, clique em Adicionar campo e repita essas etapas.

  15. Clique em Adicionar.

  16. Clique em Adicionar painel de URL personalizado. Seu painel personalizado aparece na lista Painel personalizado.

Controlar dinamicamente o idioma do painel personalizado

Você pode usar a variável {AGENT_LOCATION_LANGUAGE} ou {AGENT_LANGUAGE} no URL personalizado para controlar dinamicamente o idioma de um painel personalizado:

  • Idioma do local do agente: adicione a variável {AGENT_LOCATION_LANGUAGE} ao URL para mostrar o painel personalizado no idioma do local atribuído ao agente. Exemplo: https://YOUR_CCAAS_HOST/lang={AGENT_LOCATION_LANGUAGE}. Para mais informações, consulte Variáveis.

  • Idioma do agente: adicione a variável {AGENT_LANGUAGE} ao URL para mostrar o painel personalizado no idioma selecionado pelo agente no seletor de idioma da área de trabalho do agente. Se um agente mudar o idioma no seletor de idioma, os painéis personalizados serão recarregados e vão mostrar o idioma selecionado. Exemplo: https://YOUR_CCAAS_HOST/lang={AGENT_LANGUAGE}. Para mais informações, consulte Variáveis.

Variáveis

Você pode incluir as seguintes variáveis em URLs e valores de campo de cabeçalho HTTP. Essas variáveis capturam informações sobre o agente, o usuário final e a sessão.

Variáveis de agente

  • {AGENT_ID}: o ID do agente

  • {AGENT_CUSTOM_ID}: o ID personalizado do agente

  • {AGENT_EMAIL}: o e-mail do agente

  • {AGENT_ALIAS}: o alias do agente

  • {AGENT_LOCATION_LANGUAGE}: o código do idioma do local atribuído ao agente. Por exemplo, en-US. Para usar essa variável, o agente precisa de um local e um idioma atribuídos. Para mais informações, consulte Configurar local e idioma.

  • {AGENT_LANGUAGE}: o código do idioma de exibição que o agente seleciona no seletor de idioma da área de trabalho do agente. Por exemplo, en-US. Se um agente mudar o idioma no seletor, os painéis personalizados serão recarregados e vão mostrar o idioma selecionado. Para mais informações, consulte Mudar o idioma de exibição.

Variáveis do usuário final

  • {UJET_ID}: o ID do usuário final

  • {ANI}: o número de telefone do usuário final

  • {DEVICE_TYPE}: o tipo de dispositivo do usuário final

Variáveis de sessão

  • {SESSION_TYPE}: o tipo de sessão

  • {PHONE_NUMBER}: o número de telefone do usuário final

  • {SESSION_ID}: o ID da chamada ou do chat

  • {MENU_PATH}: o caminho do URL para o menu

  • {QUEUE_NAME}: o nome da fila

  • {QUEUE_ID}: o ID da fila interna

  • {LANGUAGE}: o idioma da fila

  • {OUTBOUND_PHONE_NUMBER}: o número de telefone de saída

  • {SUPPORT_PHONE_NUMBER}: o número de telefone de suporte para o qual o usuário final está ligando

Funções

É possível incluir funções da tabela a seguir em URLs e valores de campo de cabeçalho HTTP.

Função Sintaxe Descrição
Valor padrão =DEFAULT_VALUE(value_1, value_2) Usa value_1, a menos que seja nulo ou vazio. Nesse caso, usa value_2.
Concatenação OR =CONCAT_OR(value_1, value_2, value_3) Concatenação de vários valores com OR. Exemplo: value_1 OR value_2 OR value_3.
Concatenação E =CONCAT_AND(value_1, value_2, value_3) Concatenação de vários valores com AND. Exemplo: value_1 AND value_2 AND value_3.
JSON =JSON({"key_1":"value_1", "key_2":"[value_2]"}) JSON para string. Exemplo: {"key_1":"value_1","key_2":"value_2"}.
Matriz JSON =JSON_ARRAY({"key_1":"value_1"},{"key_2":"value_2"}) Matriz JSON para string. Exemplo: [{"key_1":"value_1"},{"key_2":"value_2"}].