You are viewing the Portuguese (Brazil) site, but your language preference is set to English. Switch to English site →

Menu

Mapeamento de Identificadores globais para Identificadores de espaço de trabalho

Você pode identificar objetos do Flex Insights (também conhecidos como WFO), como relatórios, métricas e dashboards, usando dois tipos de identificadores:

Identificador do espaço de trabalho

Também chamado de "object id", URI ou identificador local, é um identificador numérico associado a cada objeto, que geralmente é exibido no formato /gdc/md/{workspace_id}/obj/5308 ou simplesmente como 5308.

  • O identificador do espaço de trabalho é local para cada espaço de trabalho do Flex Insights e não pode ser modificado externamente.
  • Qualquer objeto criado em um espaço de trabalho faz com que esse número aumente em 1.

Identificadores globais

Também chamados de identificadores externos ou simplesmente de identificadores. Existem duas categorias distintas:

  • Para os objetos do modelo de dados (atributos, fatos etc.), o identificador tem o seguinte formato "attributes.conversation.ivr_path".
  • Para os objetos da IU (relatórios, métricas, dashboards), o formato é um alfanumérico de 12 caracteres, por exemplo, "b08a2c8ca8f4".

O identificador global de um objeto pode ser manipulado sob determinadas condições, mas o Flex Insights garante que ele seja exclusivo em cada espaço de trabalho individual.

A Twilio usa o identificador global para garantir que o conjunto de objetos integrados ao mesmo identificador global tenha a mesma definição em todos os espaços de trabalho do Flex Insights. Os identificadores de espaço de trabalho, por outro lado, são utilizados para identificar objetos específicos dentro de um espaço de trabalho.

Aqui está um exemplo em que dois relatórios têm identificadores de espaço de trabalho diferentes, em dois espaços de trabalho do Flex Insights, mas o identificador global é o mesmo. A empresa A e a empresa B querem usar os relatórios Q e A. Em suas instâncias individuais do Flex Insights, as empresas A e B veriam o mesmo identificador global (ou seja, abPBFm6ZgjV4), mas diferentes identificadores de espaço de trabalho (por exemplo, 4309 para a empresa A e 51684 para a empresa B).

Global Identifiers vs Local Identifiers V3

Todas as solicitações da API do Flex Insights devem usar o identificador do espaço de trabalho, de modo que o Flex Insights forneça APIs para tradução entre os identificadores de espaço de trabalho e os identificadores globais. Isso permite que você mapeie seus objetos para seus identificadores globais usando seu identificador do espaço de trabalho.

Pré‐requisitos

Antes de iniciar o mapeamento entre o identificador global e o identificador do espaço de trabalho, você precisa dos seguintes:

  • um espaço de trabalho provisionado do Flex Insights
  • as credenciais de um usuário com acesso ao espaço de trabalho do Flex Insights
  • o identificador global do objeto que você deseja mapear para um identificador do espaço de trabalho
  • Suporte ao cliente da API REST para cookies que são usados para passar authentication tokens (tokens de autenticação)

Autenticação de API

Certifique‐se de que você esteja autenticado em relação à API do Flex Insights tendo um TT (token temporário) válido. O procedimento é detalhado em Autenticação de API

Obtenção do ID do espaço de trabalho e o identificador global

Você precisará de:

ID do espaço de trabalho: faça login no portal do Analytics e verifique a URL na barra de endereço do navegador. Por exemplo:

Workspace id

O ID do espaço de trabalho é a cadeia de caracteres que aparece entre o segmento #s=/gdc/projects/ e a barra vertical. Neste caso, o ID do espaço de trabalho é z2nxqtb1r6weuly0iivexz6hu5dathua.

Identificador global do objeto: provavelmente será fornecido por você em algum documento, documentação externa ou pelos Serviços especializados. O formato esperado é abJBDYXwfBG1.

Mapeando os Identificadores

Agora você tem tudo o que precisa para começar a mapear seus identificadores!

        
        
        

        Ao analisar o JSON de resposta, você pode obter o Identificador do espaço de trabalho em identifiers[0]uri

        Vários identificadores podem ser mapeados em uma chamada da API, pois são passados como uma lista JSON. Uma lista de mapeamentos é retornada como uma resposta.

              
              
              

              Se você quiser mapear o identificador do espaço de trabalho para o identificador global, poderá chamar a mesma API com o parâmetro uriToIdentifier em vez de identifierToUri e fornecer uma lista de Identificadores de espaço de trabalho.

                    
                    
                    

                    Depois de obter o identificador do espaço de trabalho, é seguro presumir que, para cada espaço de trabalho do Flex Insights, o identificador do espaço de trabalho nunca será alterado.

                    O Identificador do espaço de trabalho pode ser usado em qualquer chamada da API (por exemplo, exportação de dados brutos).

                    Classifique esta página:

                    Precisa de ajuda?

                    Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

                    Obrigado pelo seu feedback!

                    Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

                    Enviando seu feedback...
                    🎉 Obrigado pelo seu feedback!
                    Algo deu errado. Tente novamente.

                    Obrigado pelo seu feedback!

                    thanks-feedback-gif