Integre o Webex Contact Center com o Zendesk

list-menuComentários?
Ao integrar o Webex Contact Center com o console do Zendesk CRM, você pode iniciar o Desktop de dentro do Zendesk.

Pré-requisitos

O conector CRM opera com base na versão do widget especificada no JSON do layout da área de trabalho. É extremamente importante garantir que a versão do widget no layout da área de trabalho seja mantida atualizada. Em novembro de 2025, a versão mais recente do widget é 1.2.2. Espera-se que os administradores garantam que todos os layouts de desktop desse conector de CRM usem essa versão do widget. Se o layout não for atualizado para usar a versão mais recente, a funcionalidade não será mais suportada e poderá deixar de funcionar corretamente.

O tamanho mínimo suportado para a interface do softphone é de 500 px. Qualquer valor menor que 500 px pode resultar em problemas de exibição ou funcionalidade.

Antes de integrar o Webex Contact Center ao console do Zendesk CRM, certifique-se de ter o seguinte:

Antes de começar

Se você tiver uma versão mais antiga do aplicativo Webex Contact Center para Zendesk, desinstale a versão antiga antes de instalar a versão mais recente. Para obter mais informações, consulte Desinstalar o Webex Contact Center para Zendesk.

A instalação deste pacote é aplicável à nova plataforma Webex Contact Center. Isso não se aplica à plataforma Webex Contact Center 1.0.

1

Entre na sua conta do Zendesk.

2

Siga o assistente de início rápido.

3

(Opcional) Para adicionar sua equipe ao Zendesk, clique em Adicionar sua equipe.

4

Navegue até Configurações > Marketplace.

5

Na página do Marketplace, pesquise Webex Contact Center.

6

Selecione o aplicativo Webex Contact Center.

Zendesk Marketplace screen with "webex contact center" entered into the search field.

7

Na lista suspensa Selecionar conta para instalar este aplicativo, selecione a conta apropriada.

8

Clique em Instalar e siga o assistente de instalação para instalar o aplicativo.

9

Na página de instalação do Webex Contact Center, certifique-se de que a URL da área de trabalho seja a URL da área de trabalho da sua região:

10

Clique em Salvar.

1

No console do Zendesk, navegue até Configurações > Gerenciar > Pessoas.

Zendesk console settings screen showing where 'Manage' and 'People' sections are located.

2

Clique em Editar para ver o agente recém-ativado.

3

Na área Função do perfil do agente, clique em Gerenciar na Central de Administração.

4

Nas configurações de funções e acesso do agente, selecione Administrador na lista suspensa Função.

5

Clique em Salvar.

Você pode baixar o arquivo JSON do Desktop Layout para o Zendesk em https://github.com/CiscoDevNet/webex-contact-center-crm-integrations/tree/main/Zendesk.

Para obter mais informações sobre o layout do Webex Contact Center Management Portal Desktop, consulte o capítulo Provisionamento do Guia de Cisco Webex Contact CenterConfiguração e Administração.

1

Vá para o Webex Contact Center. Management Portal

2

Na barra de Management Portal navegação, escolha Provisionamento > Layout da área de trabalho.

3

Clique em Novo layout e insira os detalhes do layout da área de trabalho.

4

Faça upload do arquivo JSON do Zendesk Desktop Layout.

5

Clique em Salvar para salvar a configuração.

Agora você pode iniciar o Webex Contact Center Desktop no console do Zendesk CRM.

Se você tiver uma versão mais antiga do aplicativo Webex Contact Center para Zendesk, desinstale a versão antiga antes de instalar a versão mais recente.

1

Entre na sua conta do Zendesk.

2

Navegue até Configurações > Gerenciar.

3

Selecione Webex Contact Center.

4

No menu de opções, clique em Desinstalar.

5

Clique em Desinstalar para confirmar.

  • Suportamos Agent Desktop o login usando somente os conectores WebRTC for Salesforce (SFDC) e Microsoft Dynamics (MS Dynamics).
  • Atualmente, esse recurso é aplicável somente aos agentes.

Antes de fazer chamadas externas

Antes de fazer chamadas externas, certifique-se de fazer o seguinte:

  • Crie o ponto de entrada externo e configure uma estratégia de ponto de entrada externo.

  • Habilite a ANI externa para o perfil do agente.

  • Defina a ANI de discagem externa para um mapeamento de número de discagem para ponto de entrada.

Para obter mais informações, consulte o capítulo Provisionamento do Guia de Cisco Webex Contact CenterConfiguração e Administração.

Para obter informações sobre como usar o Desktop, consulte o Guia Cisco Webex Contact Center Agent Desktop do usuário.

1

Faça login no console do agente do Zendesk em https://<your-instance>.zendesk.com/agent/.

2

Na barra de ferramentas no canto superior direito do console do Zendesk, clique no ícone Webex Contact Center.

Zendesk agent console screen showing the prompt window to sign in to Webex Contact Center.

3

Faça login com suas credenciais do Webex Contact Center Desktop.

O Webex Contact Center Desktop integrado abre no lado direito do console do Zendesk.
4

Insira o número de discagem (DN) e as informações da equipe.

  • Digite seu DN e nome da equipe na primeira vez que você entrar no Webex Contact Center para Zendesk. Nas sessões subsequentes, o mesmo DN e o mesmo nome da equipe aparecem automaticamente no aplicativo.

  • Se você estiver executando o Zendesk em várias guias na janela do navegador, o aplicativo Webex Contact Center estará ativo em apenas uma guia.

  • Você pode clicar no ícone do Webex Contact Center a qualquer momento para minimizar o aplicativo e continuar trabalhando no Zendesk.

1

Faça login no console do agente do Zendesk em https://<your-instance>.zendesk.com/agent/.

2

Na barra de ferramentas no canto superior direito do console do Zendesk, clique no ícone Webex Contact Center.

3

Faça login com suas credenciais do Webex Contact Center Desktop.

Quando o sistema atribui uma chamada recebida a você, seu estado muda para Chamada. O aplicativo pesquisa os registros do cliente com base na ANI ou no número de telefone recebido e você pode:
  • Crie tickets do Zendesk diretamente do desktop do agente durante chamadas ativas com clientes.
    1. Se isCaseCreationForAllInboundCallsEnabledfor definido como verdadeiro no layout do desktop, um novo ticket será criado para cada chamada recebida, independentemente de o chamador já ter um ticket aberto.
    2. Se isCaseCreationForAllInboundCallsEnabledestiver definido como false no layout da área de trabalho, ele não criará nenhum ticket novo e fará o seguinte:
      • Se houver um ticket aberto, ele abrirá esse ticket e o vinculará automaticamente ao chamador.
      • Se houver vários tíquetes abertos, todos serão listados e o agente deverá escolher em qual tíquete trabalhar.
      • O agente também pode criar um novo ticket e vinculá-lo ao chamador usando o widget de conector.
  • Crie novos registros de clientes sem problemas no aplicativo de desktop do agente (somente quando nenhum perfil de cliente correspondente for encontrado).
  • Preencha automaticamente os campos do ticket com dados variáveis CAD relevantes com base nas configurações do layout do desktop.
  • Vincule tíquetes a vários contatos, aproveitando a funcionalidade de pesquisa pop-up existente (cenários de correspondência única, sem correspondência e de várias correspondências). A vinculação do ticket é baseada nos eventos de navegação. Por exemplo, se o conector abrir o ticket XYZ quando a chamada chegar, mas o agente navegar até o ticket ABC, depois que a chamada terminar, o ticket ABC será atualizado.
Tabela 1. Casos de uso
Então, não.CenárioSolução
1Criação de tickets a partir do Zendesk Connector para cenário de registro de partida únicaSe existir um único registro de usuário correspondente, os agentes poderão criar e vincular um ticket novo ou existente.
  • Os valores das variáveis CAD são preenchidos no ticket com base nas configurações do layout do desktop.
  • Se existir um único registro de usuário correspondente, esse usuário será associado ao ticket.
  • Se nenhum registro de usuário correspondente existir, o usuário recém-criado será associado ao ticket.
2Criação de tickets a partir do Zendesk Connector para vários cenários de recordes de partidasSe existirem vários registros de usuário correspondentes, os agentes poderão selecionar um perfil relevante e adicionar um ticket existente ou criar um novo.
3Criação de tickets a partir do Zendesk Connector em caso de ANI inválida (cenário sem registro de correspondência)Caso nenhum registro correspondente seja encontrado para ANI inválida,
  • Os agentes podem pesquisar a lista de clientes do conector Zendesk usando o número ou o nome do chamador para criar ou vincular um ticket.
  • Se nenhum perfil for encontrado, os agentes poderão criar um novo cliente e um novo ticket.
4Criação de tickets a partir do Zendesk Connector em caso de ANI anônima (cenário sem registro de correspondência)Caso nenhum registro correspondente seja encontrado para ANI anônima,
  • Os agentes podem pesquisar a lista de clientes do conector Zendesk usando o número ou o nome do chamador para criar ou vincular um ticket.
  • Se nenhum perfil for encontrado, os agentes poderão criar um novo cliente e um novo ticket.
1

Faça login no console do agente do Zendesk em https://<your-instance>.zendesk.com/agent/.

2

Na barra de ferramentas no canto superior direito do console do Zendesk, clique no ícone Webex Contact Center.

3

Faça login com suas credenciais do Webex Contact Center Desktop.

4

Vá até a página inicial e selecione um registro de cliente.

5

Na lista de tíquetes, clique em um tíquete para abri-lo.

6

No painel vertical do lado direito, clique no ícone Aplicativos.

7

Clique em Ligar no aplicativo Webex Contact Center.

O sistema disca o número associado ao ticket.

Personalizações de propriedades de layout de desktop

A seção a seguir descreve a personalização de cada propriedade do arquivo de layout de desktop personalizado.

O administrador pode personalizar o comportamento do conector Zendesk de acordo com o caso de uso comercial necessário.

Propriedade de layout de desktop

Descrição

Valores possíveis

Fora de Dialani

Esse recurso está desativado por padrão.

Você pode definir a ANI externa para chamadas click-2-dial. Esse valor substitui o valor definido no. Management Portal

<OutDialAniValue>

por exemplo, +11234567890

Criação de casos de ocorrência para todas as chamadas de entrada ativada

Esse recurso é ativado por padrão.

Defini-lo como verdadeiro cria um novo ticket para todas as chamadas recebidas.

Defini-la como false permite a criação de tickets somente quando não há tickets abertos ou pendentes associados a esse chamador.

verdadeiro, falso

Nome da variável CAD do Advance Search

Esse recurso está desativado por padrão.

Use esse recurso com o AdavanceSearchCRMObjectName para ativar o Screen Pop com base na pesquisa avançada.

Especifique o nome da variável CAD para pesquisar o valor no Zendesk CRM.

< cad_variable >

Por exemplo, NPI

Nome do objeto AdvanceSearchCRM

Esse recurso está desativado por padrão.

Use esse recurso com o AdavanceSearchCADVariableName para ativar o Screen Pop com base na pesquisa avançada.

Especifique o objeto do CRM e o nome do campo do objeto para pesquisar o valor da variável CAD.

< crm_object > < crm_object_field >:

Por exemplo, usuário npi:

Campo dinâmico de tíquetes

Esse recurso está desativado por padrão.

Use esse recurso com TicketDynamicFieldValue para associar o objeto de ticket a outros campos, como formulários.

Especifique o nome do campo do ticket.

< ticketDynamicField>

Por exemplo, ticket_form_id

TicketDynamicFieldValue

Esse recurso está desativado por padrão.

Use esse recurso com TicketDynamicField para associar o objeto de ticket a outros campos dinâmicos, como formulários.

Especifique o valor do campo Ticket.

<ticketDynamicFieldValue>

Por exemplo, 12152079860369

Assunto dinâmico do tíquete

Esse recurso é ativado por padrão.

Use esse recurso para personalizar suas próprias linhas de assunto para os tickets gerados pelo Webex Contact Center.

Você pode usar variáveis CAD.

Certifique-se de colocar as variáveis CAD entre chaves {}.

Valor padrão: Call {ActivityDateTime}

Por exemplo, ligue para 23.01.2023 às 21h34.

Formato de data e hora

Esse recurso é ativado por padrão.

Use esse recurso para alterar o formato de data e hora.

Valor padrão: mm.dd.YYYY hh:mm a

Campos personalizados a serem atualizados para tickets existentes

Esse recurso está desativado por padrão.

Use esse recurso com TicketCustomFieldsMapping para ativar ou desativar o recurso de atualização de campos personalizados para tickets existentes.

verdadeiro, falso

Mapeamento de campos personalizados de tíquetes

Esse recurso está desativado por padrão.

Use esse recurso para mapear as variáveis CAD do WebExcc e os IDs de campo personalizados do Zendesk CRM para preencher automaticamente os valores das variáveis CAD nos campos personalizados do objeto do ticket.

O JSON de mapeamento tem 3 chaves:

wxccFieldName: nome da variável CAD WebExcc. Isso pode ser configurado com um ou mais campos WebExcc. Os seguintes campos WebExcc estão disponíveis por padrão.

  • wxccFieldName: ActivityDateTime - Este é o campo Data e hora da atividade.

  • wxccFieldName: InteractionID - Esse é o campo ID da sessão de contato.

  • wxccFieldName: PhoneNumber - Esse é o campo ANI/Phone.

  • wxccFieldName: direção - Este é o campo Direção da chamada (entrada/saída)

  • wxccFieldName: QueueName - Esse é o campo Nome da fila.

  • wxccFieldName: WrapupCode - Este é o campo Wrap Up Code.

ZendeskTicketFileLDID: ID do campo personalizado do ticket do Zendesk

isDefaultValueEnabled: sinalizador booleano para verificar se é necessário usar o valor padrão ou o valor dinâmico da variável CAD para vincular ao ID do campo personalizado.

[{"wxccFieldName":"< wxccFieldName >",
"zendeskTicketFileldID":"< zendeskTicketFileldID >",
"isDefaultValueEnabled”:false}]

Exemplo #1 —

[{"wxccFieldName":"activityDateTime",
"zendeskTicketFileldID":"12093897017233",
"isDefaultValueEnabled”:false}]

Neste exemplo, isDefaultValueEnabled é false e o aplicativo procura a variável CAD no valor wxccFieldName. A variável CAD é ActivityDateTime. Seu valor é recuperado e preenchido no campo Personalizado, cujo ID é 12093897017233.

Exemplo #2 —

[{"wxccFieldName":"WxCC",
"zendeskTicketFileldID":"12093897017233",
"isDefaultValueEnabled”:true}]

Neste exemplo, o isDefaultValueEnabled é verdadeiro, então o aplicativo procura o valor padrão ou estático especificado no valor wxccFieldName. WxCC é o valor padrão e o mesmo é preenchido no campo Personalizado, cujo ID é 12093897017233.

Este artigo foi útil?
Este artigo foi útil?