Ir para o conteúdo principal
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Evento JSON


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


Qdica: Os eventos JSON só estão disponíveis para usuários que adquiriram acesso à API da Qualtrics. Se você estiver interessado em obter esse recurso, fale com seu Executivo de contas ou com o Gerente de sucesso do XM.

Sobre o evento JSON

Você já quis que uma solicitação feita no seu site acionasse um tíquete na Qualtrics? Você já quis criar uma integração perfeita entre a Qualtrics e seu próprio sistema interno? Você já quis acionar uma tarefa na guia Fluxos de trabalho, mas com um evento que acontece fora da Qualtrics?

Os eventos JSON permitem que o software externo inicie workflows via solicitação HTTP. Em vez de esperar que um evento na Qualtrics acione outras ações na plataforma, você pode simplesmente configurar um evento JSON para receber solicitações de terceiros.

Qdica: Você deve gerar um token de API antes que este recurso esteja disponível para você. Se você já tiver um token de API, não precisa gerar um novo.
Atenção: a configuração de um evento JSON requer conhecimento avançado de programação. Embora nossa equipe de suporte esteja feliz em ajudar com os fundamentos de colocar informações no evento, não podemos fornecer suporte sobre os aspectos da programação. Em vez disso, você pode perguntar à nossa comunidade de usuários dedicados.

Limitações

O evento JSON não é compatível com as seguintes configurações:

  • Qualquer coisa que não seja HTTP (por exemplo, fila de mensagens, SMS).
  • Chamadas HTTP de saída.
  • Processar XML (o corpo da solicitação XML será ignorado).
  • Processe qualquer coisa diferente de JSON.
  • Autenticar de qualquer forma além de um cabeçalho X-API-TOKEN ou nossa autorização básica HTTP modificada.
    Qdica: OAuth e outras formas de autenticação são incompatíveis com eventos JSON.
  • Qualquer análise sintática JSON que não possa ser satisfeita usando consultas JSONPath no corpo JSON.
  • Chamadas que excedem o limite da taxa de API de 3.000 por minuto.
  • Payloads que excedem 100 KB.

Tipos de autenticação suportados

Autenticação baseada em token/autorização de cabeçalho

Você pode autenticar transferindo seu token de API pelo cabeçalho da solicitação como X-API-TOKEN.

Exemplo: no exemplo de POST a seguir, em cURL, especificamos o URL base, o tipo de conteúdo e o token no cabeçalho. O ID da pesquisa e o formato da exportação são indicados no

body.curl -X POST -H 'X-API-TOKEN: yourapitokenhere' -H 'Content-Type: application/json' -d '{

     "SurveyId": "SV_012345678912345",

     "format": "csv"

 }' 'https://yourdatacenterid.qualtrics.com/API/v3/responseexports'

Autorização básica HTTP

Autenticação básica é geralmente uma versão codificada em Base64 do nome de usuário:senha. No entanto, para maior segurança, a Qualtrics usa uma string codificada em Base64 com nome de usuário:x-api-token.

Para utilizar a Autenticação básica, você deve definir cabeçalhos na solicitação HTTP. O cabeçalho específico é Autorização.

Exemplo: Digamos que seu nome de usuário Qualtrics seja demo@qualtrics.com e seu Token de API seja f8gIK7G6GFH985Y4. Primeiro você escreveria,

 demo@qualtrics.com:f8gIK7G6GFH985Y4

Depois da codificação Base64, isso apareceria como,

 Base ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=

Assim, o cabeçalho de autorização que você adicionar à sua solicitação HTTP teria o valor Básico ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=.

Qdica: Confira estas ferramentas para codificar base64 e decodificar base64.

Configurando um evento JSON

  1. Primeiro, você precisará criar um workflow. Vá para a página Fluxos de trabalho independentes.
    Na guia Fluxos de trabalho, clique em Criar fluxos de trabalho e depois comece quando um evento é recebido

    Qdica: você também pode usar eventos JSON no Guia Fluxos de trabalho em um projeto. Só recomendamos adicionar um fluxo de trabalho a um projeto específico se ele estiver explicitamente relacionado. (Por exemplo, você está distribuindo esse projeto com o evento JSON.)
  2. Certifique-se de que você está na guia Seus fluxos de trabalho.
  3. Clique em Criar um fluxo de trabalho.
  4. Selecione Iniciado quando um evento é recebido.
  5. Selecione o evento JSON.
    selecionando o evento JSON para iniciar o workflow
  6. Se desejar, especifique um Resumo do acionador, que deve descrever a finalidade do evento JSON. adicionando um resumo, copiando o ponto de extremidade e ativando a autenticação
  7. Você receberá um URL. Use para chamar seu novo fluxo de trabalho de fora da Qualtrics, usando Postman, seu próprio sistema interno ou outros aplicativos similares. Para copiá-lo, clique em Copiar URL.
  8. Por padrão, os eventos JSON requerem autenticação. Se quiser permitir solicitações não autenticadas, desative Solicitar autenticação pela Qualtrics.
  9. Agora, você pode definir os dados do evento. Isso irá capturar dados da solicitação de entrada. Para iniciar, clique em Configurações avançadas.
    definindo dados do evento na seção de configurações avançadas

    Qdica: Para obter informações sobre a seção Teste, consulte Capturando eventos abaixo.
  10. Na caixa à esquerda, dê o nome do campo JSON. Na caixa à direita, indique o local dentro dos dados do evento (corpo da requisição HTTP).
    Qdica: Os locais devem estar no formato JSONPath. Consulte a tabela abaixo para obter um guia rápido da sintaxe JSONPath.
  11. Para adicionar outro campo, clique em Adicionar um campo JSON.
  12. Se você quiser adicionar um parâmetro QUERY, adicione-os na seção Parâmetros QUERY. Para obter maiores informações sobre o que são esses parâmetros e como eles funcionam na API, consulte nossa Documentação da API sobre parâmetros.
    Aviso: Não é aconselhável passar dados de identificação pessoal através de parâmetros QUERY. Quaisquer informações de identificação pessoal ou dados confidenciais devem ser passados pelo corpo POST sempre que possível, uma vez que POST é mais seguro. Entre em contato com o Suporte da Qualtrics se tiver dúvidas ou preocupações.
  13. Para remover um campo, clique no sinal negativo ( ).
  14. Para salvar suas alterações, clique em Salvar.
  15. Agora você pode adicionar condições e uma tarefa ao seu workflow clicando no sinal de mais ( + ). As condições determinam quando um workflow é executado, enquanto as tarefas são o resultado do workflow. Consulte o Visão geral dos fluxos de trabalho para mais informações
    clicando no sinal de mais e, em seguida, na tarefa ou nas condições

Qdica: Clique em seu evento JSON para alterar os parâmetros e os campos JSON.

Atenção: um evento JSON só pode ser acionado via API a partir da mesma conta que criou o evento. Se uma conta diferente for usada para disparar a API para um evento JSON, você ainda poderá receber uma resposta da API 202 com êxito, no entanto, isso significa que um token de API válido foi usado para fazer uma solicitação válida, mas não significa necessariamente que o token de API correto foi usado ou que o evento JSON foi acionado corretamente. Se você receber uma mensagem de êxito na API de 202, verifique a plataforma para confirmar se a API correta foi usada.

 

Capturando eventos

Ao criar um evento de API externo, você pode precisar analisar sintaticamente os dados do corpo da publicação. No entanto, pode ser difícil, por vezes, analisar sintaticamente esses dados. Se você quiser descobrir o que sua API externa está enviando, siga estas etapas.

  1. Clique em seu evento JSON.
    selecionando o evento JSON
  2. Por padrão, os campos JSON de captura dos resultados de teste para que possam ser usados como texto transportado em outras tarefas nesta opção de fluxo de trabalho serão ativados. Essa opção faz com que os campos analisados sintaticamente no corpo do payload fiquem automaticamente disponíveis como texto transportado quando você adicionar suas tarefas de fluxo de trabalho.
    clicar em executar um novo teste
  3. Clique em Executar um novo teste.
  4. Você verá uma mensagem informando que a Qualtrics está aguardando o recebimento do evento de seu sistema externo. Acione sua API externa.o evento JSON que aguarda o recebimento de um evento de seu sistema externo
    Qdica: Para cancelar este teste, clique em Cancelar teste.
  5. Se o teste tiver sido bem-sucedido, você verá a mensagem Conectado com êxito ao servidor. O payload será analisado sintaticamente e adicionado à janela.um teste com êxito - o payload JSON está na janela do evento
  6. Se desejar, clique em Executar um novo teste para executar outro teste. Você precisará executar sua próxima chamada de API após clicar nesta opção.
  7. Clique em Salvar.

Sintaxe de caminho JSON

A tabela abaixo fornece alguns dos fundamentos da sintaxe JSONPath. Observe que eles não são estabelecidos pela Qualtrics, mas são padrões usados com JSON.

Atenção: a configuração de um evento JSON requer conhecimento avançado de programação. Embora nossa equipe de suporte esteja feliz em ajudar com os fundamentos de colocar informações no evento, não podemos fornecer suporte sobre os aspectos da programação. Em vez disso, você pode perguntar para nossa comunidade de usuários dedicados.
Cam.JSON Descrição Exemplo
$ O objeto/elemento raiz $.store[0].name
@ O objeto/elemento atual $.store[?(@.name===”ACME Store”)]
. Operador inferior $.eventDescription
.. Operador descendente recursivo $.lojas[0]..preço
* Curinga $.lojas[*].nome
[] Operador de subscrito $.store[0].name
[,] Operador de união $.lojas[0,1]
[início:fim:etapa] Operador de fatia de matriz $.store[0:10:2]
?() Aplica um filtro $.store[?(@.name==”ACME Store”)]
() Expressão de script $.stores[(@.length-1)]

Exemplo de sintaxe JSONPath

Neste exemplo, mostraremos como, com um objeto JSON, a tabela JSONPath pode ser usada.

Este é o nosso objeto JSON:

{
 "eventDescription": "Monthly Revenue",
 "}

 stores": [
 {
 "name": "Acme Store",
 "total": 1000000,
 "topItem":

 { "price": "} store": "description": "Anvil" }
,
 {
 "name": "The Banana Stand",
 "total": "}",
 "topItem":



 { "price": "4
", "Gob",

 "Descrição total": "}": "topItem": { "price": "4",
 "Gob", "Descrição total": "}
": "
topItem": { "price": "4", "Descrição total": "}"

Agora, devemos adicionar os valores de retorno que vemos na tabela JSONPath para torná-lo mais claro.

$ -> Acme Store
 @ -> [
 {
 "name": "Acme Store",
 "total": 1000000,
 "topItem":

 {"price": "50", "description": "Anvil" roll 
 ↑ 

 . -> receita mensal
 .. -> {


&


gt; 50

 -> ["Acme Store", "
The Banana
 Stand", "Pizza Planet"]


 [] -> Acme Store
 [,] -> [
 A macro desconhecida: {"name"}


 macro desconhecida: {"name"}
 Item[

*Change [start:end:step] "




:

step] "name".
s() -> [{
 "name": "Acme Store",
 "total": 1000000,
 "topItem":

 {"price": "50", "Description": "Anvil" (] }]

 () -> [
 {
 "name": "Pizza Planet",
 "total": ] 80000,
 "topItem":

 "" "peponi description" "pizza Planet","total": ] 80000,
 "topItem":" "peponi price" {"name" "pizza Planet","total": ] 80000,
 "topItem":
 "" "peponi price"

Exemplo de API no Javascript do nó

O exemplo abaixo é um modelo básico que você pode seguir ao formatar seus dados do evento.

Atenção: a configuração de um evento JSON requer conhecimento avançado de programação. Embora nossa equipe de suporte esteja feliz em ajudar com os fundamentos de colocar informações no evento, não podemos fornecer suporte sobre os aspectos da programação. Em vez disso, você pode perguntar para nossa comunidade de usuários dedicados.
solicitação var = requer('solicitar-promessa');
 var levantyId = "SV_XXXXXXXXXXXX";
 var trigger Id = "OC_XXXXXXXXX";
 var brandId = "YOUR_BRAND_ID";
 var userId = "UR_XXXXXXXXXXXXXXX";
 var datacenter = "xx1";
 var "apiqual_QUALken" ICiQUALken = "YTRvar/vol

"
     contextId=" + levantyId + "&userId=" + userId + "&brandId=" + brandId + "&trigger Id=" + trigger Id;
 var payload = {
     "text": "This is some text",
     "object": {
        }
     } {array
    ": 
    
    
     "true
    " ["b", "
        ", "


"
        "X-API-TOKEN": apiToken
     }
 };

 request.post(options).then(function (ret) {
     console.log("success:", url, payload);
 }).catch(function (err) {
     console.log("error: ", url);
     console.log(err);
 });

Exemplo: integração com Freshdesk

Qdica: Isto é separado da tarefa do Freshdesk.

O evento JSON pode ser utilizado para integrar com Freshdesk como uma regra de webhook no Escalonador. Isso significa que os eventos no Freshdesk podem acionar tarefas na Qualtrics, como a criação de um tíquete ou a distribuição de uma pesquisa.

Qdica: O Suporte da Qualtrics pode ajudar você a configurar seu Evento JSON e conectá-lo por meio do Freshdesk. No entanto, podem existir algumas perguntas sobre a funcionalidade Freshdesk que eles não podem responder. Se você tiver perguntas sobre o lado do Freshdesk, tente verificar a respectiva documentação sobre Regras de envio.
  1. Na Qualtrics, defina seu Evento como Evento JSON.
    selecionando o evento JSON
  2. Copie o URL.
    clicando em Copiar URL no evento JSON
  3. Em uma nova guia, acesse o Freshdesk.
  4. Na seção Admin, navegue para a opção que melhor se adequa ao tipo de regra que você deseja definir.
    Três opções diferentes na parte superior da seção de produção do helpdesk quando você clica na engrenagem administrativa na barra lateral à esquerda

    Qdica: Saiba a diferença entre Dispatch’r, Supervisor e Observer na documentação de suporte do Freshdesk.
  5. Crie uma nova regra.
    Botão Nova regra em preto em cima à direita
  6. Defina condições para determinar qual evento do Freshdesk deve acionar uma tarefa no Qualtrics.
    Nome é Qualtrics CSAT, a descrição é Pesquisa enviada quando o ticket é resolvido. Condição definida como exemplo aqui, o status é resolvido. Ação expandida para exibir Webhook acionador

    Exemplo: talvez quando um agente do Freshdesk fizer isso para que o status do tíquete seja alterado de qualquer status para Resolvido, você gostaria de enviar uma pesquisa CSAT usando a Qualtrics.
  7. Adicione uma nova ação e selecione Acionar webhook.
    A ação tem um menu expandido com o webhook do acionador destacado
  8. Defina o Tipo de solicitação como POST.
    O campo do tipo de solicitação diz POST e o URL de chamada de retorno tem o URL do evento JSON
  9. No URL de callback, cole o URL do evento JSON da etapa 2.
  10. Para usar a autenticação de token, adicione cabeçalhos personalizados, insira X-API-TOKEN: e defina-o igual ao seu token de API.
    Na caixa de cabeçalho personalizada, diz X-API-TOKEN: e, em seguida, um token de API excluído
  11. Para usar a autenticação básica HTTP, clique em Requer autenticação, adicione seu nome de usuário do Qualtrics e, em vez da senha, insira seu token de API.
    Autenticação padrão - autorização necessária selecionada e informação acima preenchida
  12. Certifique-se de que a Codificação seja JSON.
    A codificação é JSON e o e-mail do solicitante é selecionado a partir do corpo
  13. Selecione manualmente o conteúdo a ser transferido ou selecione Avançado para inserir um corpo JSON.
  14. Grave sua regra.
  15. Na Qualtrics, conclua seu fluxo de trabalho. Neste exemplo, vamos adicionar uma Tarefa do diretório XM.
    selecionando a tarefa do diretório xm
  16. Não se esqueça de publicar as alterações da pesquisa quando estiver pronto para iniciar.
Qdica: Para obter mais informações sobre os webhooks do Freshdesk, consulte a documentação vinculada no site de suporte.

Exemplo: integração com ServiceNow

Qdica: Isso é separado da tarefa da ServiceNow.

O evento JSON pode ser usado para integrar com ServiceNow. Isso significa que os eventos no ServiceNow podem acionar tarefas no Qualtrics, como a criação de um tíquete ou a distribuição de uma pesquisa.

Qdica: O Suporte da Qualtrics pode ajudar você a configurar seu Evento JSON e conectá-lo por meio do ServiceNow. No entanto, pode haver algumas perguntas sobre a funcionalidade ServiceNow que eles não podem responder. Se você tiver perguntas sobre como acessar o e ativar sua instância de desenvolvedor do ServiceNow, tente verificar a respectiva documentação sobre Instâncias de desenvolvedor pessoais.
  1. Na Qualtrics, defina seu Evento como Evento JSON.
    selecionando o evento JSON
  2. Copie o URL.
    clicando em Copiar URL no evento JSON
  3. Em uma nova guia, faça login na instância de desenvolvedor do ServiceNow.
  4. Selecione Mensagem REST.
    escolhendo uma mensagem REST
  5. Clique em Novo.
  6. Nomeie sua mensagem restante.
    dando um nome à mensagem, especificando o ponto de extremidade e escolhendo o tipo de autenticação
  7. No campo Ponto de acesso, cole o URL que você copiou na Etapa 2.
  8. Modifique o tipo de autenticação para Básico.
  9. Vá para a ficha de registro Requisição HTTP.
    selecionando a solicitação HTTP e adicionando o X-API-TOKEN
  10. Clique duas vezes para adicionar X-API-TOKEN.
  11. Clique duas vezes para colar seu token de API.
    colando o token de API
  12. Em uma nova linha, adicione o nome Content-type.
  13. Defina o valor para application/json.
  14. Clique em Enviar.
    clicando em Enviar
  15. Reabra sua mensagem Rest.
    abrindo a mensagem restante
  16. Em Métodos HTTP, clique em Novo.
    clicando em Novo
  17. Atribua um nome ao método.
    configuração do método HTTP e atribuição de um nome
  18. Defina o método HTTP como POST.
  19. Defina o Tipo de autenticação como Herdar do superior.
  20. Clique em Enviar.
  21. Reabra o método HTTP POST que você acabou de criar.
    abrindo o método POST
  22. Na parte inferior da página, selecione Visualizar uso do script.
    copiando o texto
  23. Copie o texto.
  24. Procure e selecione Regras comerciais.
    Administração de serviços Regras comerciais pesquisadas e selecionadas à esquerda. Botão Novo na parte superior, centro
  25. Selecione Novo.
  26. Selecione uma tabela.
    Campos vitais destacados em vermelho na página
  27. Selecione Avançado.
  28. Determine quando a regra comercial é executada.
    Exemplo: se você selecionou Incidente para sua tabela e deseja enviar uma pesquisa CSAT para tickets resolvidos, você pode adicionar uma condição indicando que essa regra deve ser executada quando o estado Incidente for alterado para Resolvido.
    Qdica: O Suporte da Qualtrics pode ajudar você a configurar seu Evento JSON e conectá-lo por meio do ServiceNow. No entanto, pode haver algumas perguntas sobre a funcionalidade ServiceNow que eles não podem responder. Se você tiver perguntas sobre como/quando as regras de negócios são executadas, consulte a documentação do ServiceNow sobre como as regras de negócios funcionam.
  29. Vá para a guia Avançado.
    Aba avançada aberta e corpo JSON realçado. Botão Enviar na parte inferior
  30. Cole o conteúdo que você copiou da etapa 22, onde se diz Adicionar seu código aqui.
    colando o conteúdo
  31. Adicione um corpo. É aqui que você comunica as informações que gostaria de passar para a Qualtrics.
    adicionando um corpo

    Exemplo: este é um exemplo do código final que você incluiria neste campo. A maioria desse código é a mensagem de saída fornecida pelo ServiceNow e varia de exemplo para exemplo. Infelizmente, o Suporte Qualtrics não pode ajudar você com qualquer codificação personalizada; se você tiver problemas com seu código, entre em contato com a comunidade do ServiceNow para obter ajuda.

    A parte em negrito do código inclui três funções adicionais não incluídas no código original: um corpo JSON que chama o ID do usuário e o estado do incidente e uma chamada que recupera o endereço de e-mail do cliente incidente para que ele possa ser enviado ao CSAT (em itálico abaixo). Consulte a documentação do ServiceNow e consulte a comunidade dele se tiver perguntas adicionais.

    (função executeRule(current, prior /*null when async*/) {
    
         // Adicione seu código aqui
        
      tente { 
         var r = new sn_ws.RESTMessageV2('Qualtrics JSON Event ', 'JSON Event POST');
         var body = {
              "User ID": gs.getUserID()
              "Incident state": current.state.getDisplayValue()
         ;
         
         var target = new GlideRecord('sys_user');
          target.addQuery('sys_id', '=', current.caller_id);
          target.query();
          during(target.next()) {
              body["email"] = target.email.getDisplayValue();
          }      
          var resposta = r.execute();
          var responseBody = response.getBody();
          var httpStatus = response.getStatusCode();
          gs.addInfoMessage(httpStatus);
         ficha 
     catch(ex) {
          var message = ex.message;
          gs.addInfoMessage("Erro ao comunicar com a Qualtrics " + mensagem);
    
    
    
    ) }(current, prior);
  32. Adicione o corpo à solicitação. Adicione o seguinte na parte em negrito do código da etapa anterior:
     r.setRequestBody(JSON.stringify(body)); 
  33. Clique em Enviar.
  34. Na Qualtrics, conclua seu fluxo de trabalho. Para continuar o exemplo da pesquisa CSAT, provavelmente adicionaríamos uma Tarefa do diretório XM.
    escolhendo a tarefa do diretório xm
  35. Não se esqueça de publicar as alterações da pesquisa quando estiver pronto para iniciar.

Exemplo: Integração com Microsoft Dynamics através do fluxo da Microsoft

Qdica: Esta é separada da tarefa da Microsoft Dynamics.

O evento JSON faz isso para que os eventos no Microsoft Dynamics possam acionar tarefas no Qualtrics, como a criação de um tíquete ou a distribuição de uma pesquisa. Por exemplo, sempre que você excluir um registro de conta no Microsoft, poderá distribuir uma pesquisa da Qualtrics ao proprietário da conta que faz perguntas de saída. (Por exemplo, lamentamos vê-lo ir embora! Como foi o seu tempo conosco? Como podemos melhorar?)

Para integrar o Evento JSON com ações que ocorrem no Microsoft Dynamics, você realmente precisa fazer a configuração dentro do Microsoft Flow em vez do Dynamics. Não se preocupe – O fluxo do Microsoft vem livre com todas as contas do Microsoft Dynamics, para que você possa efetuar login em Flow com suas informações Dynamics aqui.

Qdica: O Suporte da Qualtrics pode ajudar você a configurar seu Evento JSON e conectá-lo por meio do Microsoft Flow e do Microsoft Dynamics. No entanto, podem existir algumas perguntas sobre a funcionalidade da Microsoft que eles não podem responder. Se tiver dúvidas sobre o lado da Microsoft, confira a documentação do Flow e seus recursos para Dynamics.
  1. Na Qualtrics, defina seu Evento como Evento JSON.
    selecionando o evento JSON
  2. Copie o URL.
    clicando em Copiar URL no evento JSON
  3. Em uma guia separada, vá para https://us.flow.microsoft.com/en-us/ e use suas informações do Microsoft Dynamics para efetuar login em Fluxo.
  4. Selecione Meus fluxos à esquerda.
    Canto superior esquerdo do fluxo microsoft, meus fluxos selecionados a partir da 3ª opção do menu esquerdo e o novo botão no topo clicado e expandido para mostrar o terceiro da opção em branco automatizado na lista
  5. Clique em Novo e selecione Automático – em branco.
  6. Nomeie o fluxo.
    Crie uma janela de fluxo automatizada. imagem e instruções à esquerda, etapas descritas à direita da janela, descendo a linha
  7. Selecione um acionador. Este é o evento que acontece na Microsoft que iniciará a tarefa no Qualtrics. Você pode escolher o que serve aos seus propósitos, mas para este exemplo, escolhemos “Quando um registro é excluído (Dynamics 365)”.
  8. Clique em Criar.
  9. Em Nome da organização, efetue login em sua conta Dynamics.
    ampliou quando um registro foi excluído com os campos de nome da organização e nome da entidade diretamente abaixo. Novo botão de etapa na parte inferior, à esquerda do centro
  10. Em Nome da entidade, selecione o tipo de registro ou arquivo. Para nosso exemplo, usaríamos “Contas”.
  11. Clique em Próxima etapa e selecione Adicionar uma ação.
  12. Selecione HTTP.
    http e opções expandidas
  13. Modifique o Método para POST.
  14. Cole o URL do seu evento JSON no campo URI.
  15. Use a autenticação de token. Em Cabeçalhos, insira X-API-TOKEN e no campo ao lado dele, cole seu token de API.
  16. Em Corpo, você pode inserir um corpo JSON. Isso ajuda você a decidir as informações que deseja passar do Dynamics para o Qualtrics.
    Qdica: Use o botão Adicionar conteúdo dinâmico para selecionar campos de registro de dinâmica que você gostaria de trazer para a Qualtrics. Certifique-se de seguir o formato JSON adequado, como exibido na captura de tela. Para obter ajuda na solução de problemas de conteúdo dinâmico, entre em contato com o suporte da Microsoft.
  17. Quando terminar, clique em Salvar.
  18. Na Qualtrics, conclua seu fluxo de trabalho. Neste exemplo, vamos adicionar uma Tarefa do diretório XM.
    selecionando o evento de diretório xm
  19. Não se esqueça de publicar as alterações da pesquisa quando estiver pronto para iniciar.
Qdica: O fluxo do Microsoft é preferido para essas etapas porque ele pode enviar mais informações para a Qualtrics no corpo JSON. Se você configurar isso dentro do Microsoft Dynamics em vez de Flow, somente os campos alterados durante o evento Dynamics serão enviados para a Qualtrics. Por exemplo, se você optar por acionar com base em uma atualização de registro e apenas um campo “e-mail” for alterado, o “nome” e o “endereço” não serão enviados para a Qualtrics, mesmo que você peça especificamente esses campos no corpo. O fluxo enviará tudo o que você solicitou à Qualtrics, independentemente de esse campo ter sido alterado no evento acionador.

Exemplo: integração com Genesys PureCloud

Qdica: Para configurar essa integração, você deve ter acesso às ações de dados Genesys Cloud Architect e Genesys Web Service.

Utilizando eventos JSON, você pode integrar com Genesys PureCloud para enviar aos clientes uma pesquisa de acompanhamento após concluir uma interação por telefone ou chat de suporte.

  1. Na pesquisa que você deseja enviar, navegue até Fluxos de trabalho.
    clicando em criar um workflow e, em seguida, em um evento
  2. Criar um novo workflow baseado em eventos.
  3. Para o evento workflow, selecione o evento JSON.
    escolhendo o evento JSON
  4. Clique em Copiar URL para copiar o ponto de extremidade do evento para seu clipboard.
    clicando em Copiar URL
  5. Sem fechar a janela Evento JSON, abra uma nova guia em seu browser e navegue para Genesys.
  6. Navegue para Admin.
    acessando ações da guia Admin
  7. Clique em Ações.
  8. Clique em Adicionar ação.
    o botão Adicionar ação
  9. Selecione Serviços web Ações de dados como o Nome da integração.
    dando um nome à integração e dando um nome à ação

    Qdica: Se você não tiver a opção de selecionar as ações de dados de serviços da Web, precisará ativar a integração. Consulte esta página para obter mais informações.
  10. Dê à sua ação um Nome de ação.
  11. Clique em Adicionar.
  12. Navegue para a guia Configuração.
    selecionando JSON e definindo nossas propriedades na guia de configuração de contratos
  13. Vá para a aba Contratos.
  14. Em Contrato de entrada, selecione JSON.
  15. Configure as propriedades que são enviadas à Qualtrics.

    Exemplo: por exemplo, o código abaixo passará o endereço de e-mail, o número de telefone, o nome e o sobrenome.

    {
            "type": "object",
            "properties": {
              "emailAddress": {
                "type": "string"
              },
              "phoneNumber": {
                "type": "string"
              },
              "firstName": {
                "type": "string"
              },
              "lastName": {
                "type": "string"
              }
           ,
            "additionalProperties": true
          }
  16. Vá para a guia Configuração.alterando a solicitação para POST e colando nosso URL JSON
  17. Modifique o tipo de solicitação para POST.
  18. No campo Solicitar modelo de URL, cole o URL do evento JSON no Qualtrics.
  19. Clique em Adicionar cabeçalho.
    adicionando nosso token de API como um cabeçalho
  20. Na caixa Chave, insira X-API-TOKEN.
  21. Na caixa Valor, insira seu token da API Qualtrics.
  22. Vá para a guia Teste.adicionar valores de teste antes de executar um teste
  23. Insira valores de teste para suas propriedades.
  24. Clique em Executar ação.
  25. Genesys dirá se a ação foi bem sucedida. Se falhar, a resposta do erro será exibida para ajudar você a corrigir o problema.
    a mensagem de ação com êxito
  26. Retorne ao seu evento JSON no Qualtrics e verifique se suas propriedades foram passadas para a Qualtrics com sucesso.visualizando o payload de teste e clicando em Salvar
  27. Clique em Salvar.
  28. Clique no sinal de mais ( + ) e, em seguida, em Tarefa para configurar a tarefa que você deseja seguir quando o evento JSON for acionado. Em nosso caso, queremos enviar uma pesquisa aos entrevistados, então selecionamos a tarefa do XM Directory.Clicar no sinal de mais e, em seguida, na tarefa
    Qdica: ao configurar sua tarefa, use o menu de texto transportado para usar valores transmitidos pela Genesys (por exemplo, e-mail, nome do cliente etc.).
  29. Depois de configurar a tarefa na Qualtrics, retorne ao Genesys e clique em Salvar & Publicar.
    publicando a ação
  30. Clique em Sim.
  31. Navegue para Admin.selecionando arquiteto na página de administração
  32. Clique em Arquiteto.
  33. Selecione Convite de pesquisa no menu suspenso do fluxo.selecionando o convite de pesquisa no menu suspenso do fluxo
  34. Clique em Adicionar.dando um nome, uma descrição e um setor de atividade ao fluxo
  35. Dê ao seu fluxo um Nome, uma Descrição e um Setor de atividade.
  36. Clique em Criar fluxo.
  37. Na seção Dados da sua Caixa de ferramentas, selecione Chamar ação de dados e arraste-a para a caixa drop-down no fluxo.Arrastando o título Ação de dados de chamada para o fluxo
  38. Dê um nome à sua ação.dando um nome à ação de dados de chamada, selecionando a categoria e selecionando a ação de dados que criamos anteriormente
  39. Para a Categoria, selecione Serviços web Ação de dados.
  40. Para a ação de dados, selecione a ação de dados que você criou anteriormente.
  41. Ao lado de cada propriedade, clique no menu suspenso e selecione Expressão.adicionando expressões a cada propriedade
  42. Para os valores da característica, insira os dados que estão sendo enviados para cada característica. A caixa preencherá automaticamente seus campos à medida que você digita.
    Qdica: Esta página tem todas as propriedades padrão incluídas no fluxo de convite de pesquisa. Você também pode usar expressões complexas em situações em que as informações de contato do cliente estão em falta ou requer formatação adicional.
    Qdica: As informações de contato são precedidas da Survey.CustomerContact.
  43. Clique na caixa mais abaixo em seu fluxo.adicionando a ação de abortar pesquisa no final do fluxo
  44. Selecione Caixa de ferramentas, depois, Convites de pesquisa e Cancelar pesquisa.
  45. Selecione Cancelar adesão para a disponibilidade.alterar a disponibilidade para cancelar a adesão antes de publicar o fluxo
  46. Clique em Publicar. Genesys irá validar o fluxo e, em seguida, publicá-lo. Depois que isso for feito, o fluxo estará em vigor e começará a enviar pesquisas aos clientes quando eles concluírem as interações de suporte.

Perguntas frequentes

Muitas das páginas neste site foram traduzidas do inglês original usando tradução automática. Embora na Qualtrics tenhamos feito nossa diligência prévia para obter as melhores traduções automáticas possíveis, a tradução automática nunca é perfeita. O texto original em inglês é considerado a versão oficial, e quaisquer discrepâncias entre o inglês original e as traduções automáticas não são juridicamente vinculativas.