-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Integração com o Qualtrics Social Connect
Sobre a integração com o Qualtrics Social Connect
A integração com o Qualtrics Social Connect permite que você consolide e analise todo o feedback do seu cliente digital em um só lugar. Em seguida, você pode analisar seus dados usando qualquer método de análise da Qualtrics, incluindo o Text iQ em um painel CX.
Etapa 1: criação do cabeçalho de autorização
Esta seção aborda como criar o cabeçalho de autorização para a integração. Você precisará disso para configurar a integração com o Qualtrics Social Connect.
- Vá para Configurações da conta.
- Navegue para a seção IDs do Qualtrics da sua conta e copie seu token de API. Se você já tiver um token de API, não gere um novo.
- Anote seu nome de usuário do Qualtrics. Normalmente, este é o endereço de e-mail que você usa para fazer login na Qualtrics. Se você não souber seu nome de usuário do Qualtrics, entre em contato com o Administrador da marca.
- Usando seu nome de usuário Qualtrics, crie uma string de credenciais usando o seguinte formato:
<Seu nome de usuário> Qualtrics;:<Seu token de API Qualtrics;.Qdica: Se você usar SSO para fazer login na Qualtrics, certifique-se de incluir o componente # do seu nome de usuário.Exemplo: uma cadeia de credenciais de exemplo é:
barnaby@qualtrics.com:63V9BuO9wMyvgo9HOf1OpeTOrhkvYGiRx1yMGrki - Codifique a string da credencial com a codificação base64. Você pode usar qualquer codificador base64 on-line para fazer isso.
Exemplo: Minha cadeia de credenciais codificada em base64 é:
YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k= - Construir o cabeçalho de autorização no seguinte formato: Básico <base64 credenciais codificadas>. Observe o espaço entre “Básico” e as credenciais.
Exemplo: Meu cabeçalho de autorização final é:
YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=
Você precisará dessa credencial de autorização na próxima seção. Copie-o em algum lugar facilmente acessível.
Etapa 2: Criar uma automação no Qualtrics Social Connect
Esta seção abrange a configuração inicial que você precisará concluir no Qualtrics Social Connect para configurar a integração. Para iniciar a configuração, primeiro você precisará criar um fluxo de trabalho no Qualtrics.
- No Qualtrics, vá para Fluxos de trabalho.
- Clique em Criar um workflow e, em seguida, Iniciado por um evento.
- Selecione Evento JSON.
- Clique em Copiar URL para copiar o ponto de extremidade do evento. Você precisará desse ponto de extremidade do evento para concluir a configuração no Qualtrics Social Connect. Salve-o em algum lugar onde você poderá acessá-lo mais tarde.
- Em uma nova guia do navegador, efetue login no Qualtrics Social Connect.
Qdica: O Qualtrics Social Connect usa credenciais separadas da sua conta Qualtrics. Entre em contato com a equipe de suporte do Social Connect se tiver perguntas sobre o acesso ao Qualtrics Social Connect.
- Vá para Configurações da conta.
- Na guia Síntese, selecione Automação Receitas.
- Na seção Na atualização do caso, clique em Adicionar receita de automação.
- Dê um nome à sua receita de automação.
- Certifique-se de que Menção esteja selecionada na seção Acionador e selecione Foi criado a partir do menu drop-down.
- Clique no sinal de mais ( + ) para escolher um ou mais tópicos a serem monitorados.
- Na seção Filtro, configure as regras de filtragem para as menções que você deseja monitorar.
- Na seção Ação, selecione Acionar Webhook no menu suspenso.
- No campo URL, cole o ponto de extremidade do evento que você copiou no passo 4.
- No campo Cabeçalho de autorização, cole o cabeçalho de autorização que você criou anteriormente.
- Se você estiver usando uma chamada API para recuperar tags, ative a opção Atrasar. Recomenda-se definir um atraso mínimo de 10 minutos para garantir que as tags tenham tido o tempo para serem anexadas às menções.
- Clique em Adicionar para concluir a configuração.
Para testar a conexão, gere uma nova menção (a forma de gerar a menção dependerá de sua fonte, como criar um novo tweet ou deixar um comentário). Como alternativa, você pode aguardar a próxima postagem quando ela acontecer naturalmente. Assim que a nova menção tiver sido gerada, abra o evento JSON no fluxo de trabalho da Qualtrics e consulte as propriedades JSON que foram capturadas pelo evento:
Etapa 3: Criação do conjunto de dados Qualtrics
Para salvar os dados no Qualtrics, você precisa criar um conjunto de dados Qualtrics. Você pode criar um conjunto de dados da Qualtrics chamando a API do conjunto de dados diretamente da linha de comando.
- Abra um editor de texto e construa o comando da API. O formato geral é o seguinte:
curl -X POST https://brandID.qualtrics.com/API/v3/datasets -H "Content-Type: application/json" -H "X-API-TOKEN: Your Qualtrics API Token" -d '{ "name": "true, "fields": [ } "name": "Same ID column name", "createProject": true, "fields": [ } "name": "Same ID column name" than " " - No comando API acima, você precisa substituir os seguintes valores:
- brandID: ID da sua organização Qualtrics.
- Seu token de API da Qualtrics: Seu token de API.
- Escolha um nome para o conjunto de dados: insira um nome para dar ao conjunto de dados.
- Selecione o nome da coluna de ID: especifique o nome do campo que conterá a chave de identificação do seu projeto. Recomendamos o uso de “uniqueId”.
- Abra o Terminal em seu computador e cole o comando. Pressione Enter para executar o comando.
- Copie o ID do conjunto de dados do resultado. Você precisará disso mais tarde. O resultado da chamada da API será no seguinte formato:
{"result":{"name":"<Name of your dataset> ","primaryKey":"<id field that you defined> ","datasetId":"ID do conjunto de dados, este é o que você precisa copiar","fields":[<list of fields that you defined> ]},"meta":{"requestId":"<internal request ID> ","httpStatus":"200 - OK"}} - Depois de criar seu conjunto de dados, ele estará disponível na página Projetos da Qualtrics como um projeto de dados importados. Clique em seu projeto para abri-lo.
- Depois de abrir seu projeto de dados importados, você pode usar o editor de campos na guia Dados & Análise para adicionar os campos que deseja importar do Social Connect. Consulte Campos comuns de conexão social para obter mais informações sobre os campos disponíveis para você. Ao adicionar seus campos, recomendamos que você os salve como um tipo de texto aberto em seu conjunto de dados.
Etapa 4: Concluir o workflow
Agora que você estabeleceu uma conexão com o Qualtrics Social Connect e criou seu conjunto de dados, é hora de mapear dados do Qualtrics Social Connect para seu conjunto de dados.
- Abra o workflow que você criou anteriormente.
- Clique no sinal de mais (+) e selecione Tarefa.
- Selecione Web Service tarefa.
- Selecione Serviço web autenticado.
- Clique em Seguinte.
- Clique em Adicionar uma conta de usuário.
- Dê um nome à sua conta. Isso é para seus próprios fins organizacionais.
- Selecione OAuth para o tipo de conexão.
- Escolha Credenciais do cliente para o tipo de concessão.
- Insira o ID do cliente e a chave secreta do cliente. Consulte API OAuth para obter mais informações sobre como criá-los.
- Cole o seguinte URL no ponto de acesso de token: https://BrandID.DatacenterID.qualtrics.com/oauth2/token
- Substitua o texto em negrito acima pelos IDs correspondentes:
- BrandID: ID da sua organização Qualtrics.
- DatacenterID: seu ID do centro de dados Qualtrics.
- Clique em Conectar conta.
- Selecione sua conta recém-adicionada.
- Clique em Seguinte.
- Selecione POST para o tipo de solicitação.
- Insira o URL no seguinte formato:
https://brandID.qualtrics.com/API/v3/datasets/DatasetID/dataOnde brandID é seu ID de marca Qualtrics e DatasetID é o ID do conjunto de dados que você copiou anteriormente.
- Na seção Cabeçalhos, adicione Autorização como chave.
- Para o Valor, insira Portador e adicione um espaço à direita.
- Clique no ícone de texto transportado, {a}, e escolha sua conta QSC.
- Na seção Corpo, selecione pares de valores-chave JSON e comece a mapear seus campos. Para a Chave, insira o nome do campo. Para o valor, use texto transportado para selecionar o campo diretamente do evento JSON. A seção Campos comuns de conexão social tem o código de texto transportado para dados não transformados do Social Connect.
- Quando terminar, clique em Salvar.
Etapa 5: Análise de dados de conexão social do Qualtrics
Esta seção aborda como analisar seus dados do Qualtrics Social Connect nos dashboards CX e no Text iQ.
Exibição de dados de conexão social nos dashboards CX
- Criar um novo dashboard em um projeto de dashboard CX.
- Clique em Adicionar fonte, posicione o cursor sobre Fontes de dados externas e selecione o projeto que contém seus dados de conexão social.
- Ajuste os tipos de campo para seus campos importados. Consulte Campos comuns de conexão social para obter mais informações sobre o tipo de campo sugerido para cada campo de conjunto de dados.
- Grave suas modificações quando tiver concluído.
Editar seu painel é o mesmo que editar qualquer painel CX. Confira as seguintes páginas de suporte para saber mais:
- Introdução aos dashboards CX
- Passo 1: Criando o Seu Projeto & Adicionando um Painel
- Etapa 2: mapear uma fonte de dados do dashboard
- Etapa 3: Planejamento do design de dashboard
- Etapa 4: Construindo seu Painel
- Etapa 5: Personalização adicional do painel
- Etapa 6: Compartilhar & Administrar usuário
Usando Text iQ
Recomendamos que você use o Text iQ em seu painel CX. Isso garantirá que todos os seus dados estejam em um só lugar e que seus campos de Text iQ serão mapeados automaticamente para seu dashboard se você analisá-los por meio do painel. Quando estiver pronto para começar, clique no botão Analisar no Text iQ em seu dashboard.
A maioria dos campos mencionados não será útil para análise de texto (por exemplo, autor, origem, ID etc.). Ao escolher os dados a serem importados para o Text iQ, certifique-se de selecionar o campo de conteúdo da mensagem.
O uso do Text iQ para dados de conexão social funciona da mesma forma que analisar o texto de resposta da pesquisa na Qualtrics. Confira as seguintes páginas de suporte para saber mais:
Importação de XM Discover Enrichments
Esta seção aborda como importar enriquecimentos do XM Discover para seu conjunto de dados. Embora não seja obrigatória a integração com o Qualtrics Social Connect, os enriquecimentos do XM Discover ajudam você a analisar suas menções em tempo real, marcando as menções com base no conteúdo da menção.
- No Social Connect, vá para Tags.
- Clique em Adicionar XM Discover Enrichment.
- Escolha o(s) tópico(s) para o(s) qual(is) deseja adicionar enriquecimentos.
- Clique em Seguinte.
- Selecione os modelos de categoria que você deseja usar.
Qdica: Há um limite de 2 categorias por tópico. Se você precisar de mais do que isso, entre em contato com a equipe do Social Connect fazendo login em sua conta do Qualtrics Social Connect, clicando no ícone do perfil e selecionando Entrar em contato com o suporte.
. - Para Enriquecimento em tempo real, selecione Sim.
Atenção: se você não ativar o enriquecimento em tempo real, os enriquecimentos do XM Discover serão processados com um atraso de 7 minutos ou mais após a criação da menção no Social Connect e, portanto, as tags correspondentes não estarão disponíveis no fluxo de trabalho do Qualtrics.
- Clique em Salvar.
Retorne ao seu fluxo de trabalho no Qualtrics. Certifique-se de mapear seus campos no fluxo de trabalho do Qualtrics para salvar os enriquecimentos do XM Discover no conjunto de dados do Qualtrics. Estes são gravados como o campo de tags.
Como os enriquecimentos do XM Discover são exportados como uma lista separada por vírgulas, você precisará especificar o delimitador de campo em seu dashboard usando o editor de recodificação. Certifique-se de selecionar Vírgula como seu delimitador. Você também pode renomear seus campos utilizando o editor de recodificação para torná-los mais amigáveis para visualização no dashboard.
Campos comuns de conexão social
Esta seção contém uma tabela de campos comumente usados do Social Connect, o código de texto transportado para criar seu mapeamento, o tipo de campo que você deve salvá-los como na Qualtrics e quaisquer notas especiais sobre o campo.
| Nome do campo do conjunto de dados | Caminho de texto transportado (para mapeamento de fluxo de trabalho) | Tipo de campo do dashboard | Descrição & Notas especiais |
| id | ~{aed://id} | Valor de texto | Identificador específico do Qualtrics Social Connect para esta menção (único por tópico). |
| ID único | ~{aed://unique_id} | Valor de texto | Identificador específico do Qualtrics Social Connect para essa menção. |
| authorName | ~{aed://author.name} | Valor de texto | Nome de usuário ou handle do autor da menção. |
| authorFullname | ~{aed://author.fullname} | Valor de texto | Nome completo do autor da menção. |
| authorId | ~{aed://author.id} | Valor de texto | Identificador específico do serviço do autor (por exemplo, UID do Twitter) |
| originalAuthorName | ~{aed://original_author.name} | Valor de texto | Nome de usuário ou handle do autor original da menção. (No caso de ser um retweet, repin, …) |
| originalAuthorFullname | ~{aed://original_author.fullname} | Valor de texto | Nome completo do autor original da menção. |
| originalAuthorId | ~{aed://original_author.id} | Valor de texto | Identificador específico do serviço do autor original (por exemplo, UID do Twitter). |
| messageTitle | ~{aed://message.title} | Texto aberto | |
| messageContent | ~{aed://message.content} | Texto aberto | O conteúdo está no formato HTML. Você pode querer utilizar uma tarefa de código para remover qualquer HTML ou emojis. |
| messageLanguage | ~{aed://message.language} | Set de texto | Código de idioma ISO 639-1 do idioma em que esta mensagem se encontra. |
| messageSentiment | ~{aed://message.sentiment} | Set de texto | Qualquer um dos positivos, negativos, neutros ou não definidos. |
| Tipo de mensagem | ~{aed://message.type} | Set de texto | Tipo de mensagem.
Valores possíveis: “post”, “privatemessage”, “video”, “checkin”, “foto”, “text”, “de cotação”, “link”, “chat”, “áudio”, “email”, “review”, “applause”, “like”, “weweet”, “Shared”, “repin”, “user_favorito”, “reblog”, “engagement”, “weweet”, “response”. |
| SourceCategory | ~{aed://source.category} | Set de texto | Categoria na qual esta menção pode ser classificada.
Valores possíveis: “social”, “social_videos”, “social_de fotos”, “microblogs”, “fóruns”, “blogs”, “podcasts”, “comentários”, “news_diário”, “news_acadêmico”, “news_consumer”, “news_corporate”, “news_government”, “news_diário”, “news_local”, “news_national”, “news_organisation”. |
| sourceService | ~{aed://source.service} | Set de texto | Qual a origem do “serviço conectado” de onde vem a menção.
Possíveis valores: “twa_tag_tambem”, “facebook”, “facebook_ads”, “foursquare_local”, “googleplus”, “instagram”, “instagram_hashtag”, “instagram_ads”, “linkedin_group”, “pinterest”, “rss”, “youtube”, “mixcloud”, “blog_padambot”, “telegrviambot” |
| Tipo fonte | ~{aed://source.type} | Set de texto | De que fonte vem a menção. (Nome interno para filtragem.)
Valores possíveis: “SearchwebProvedorFacebook”, “ProviderSearchingSearderSearderSearderSearderSearderSearderSearchterSearchingSearchedProviderProviderProviderPlus”, “SearchlinkProvedorNavegaçãoProviderSearderSearderSearderSearderSearderSearderSearderProviderPlus”, “SearchlinkProviderSearderSearderSearderSearderProviderPlus”, “SearchlinkProviderSearderSearderProviderPlus”, “SearchderSearderProviderPlus”, “SearchderProviderSearProviderPlus”, “SearchderProviderSearProviderSearProviderPlus”, “SearchlineSearderProvedor de pesquisaProvisionar” SearderProviderPlus, “SearderProviderSearderSearderSearderProviderProviderPlus”, “SearchlinkProviderSearderProviderSearProviderPlus”, “SearchlinkProviderSearderSearderSearderProviderPlus”, “SearchlinkSearderProviderSearderProviderPlus”, “SearchedProvedoreSearcheSearderProviderProviderPlus”, “SearçãoProviderSearchedProviderSearcheProviderSearchedProvedoreSearcheSearcheProvedoreSearcheProviderSearProviderSearProviderPlus” SearchedProviderSearchderSearProviderSearProviderSearProviderSearProviderAds SearchlinkProvedorDePesquisaProvedoreProvedorDePesquisaProvedoreProvedorDeSearcheSearcheProvedoreSearcheSearderProvedoreSearcheSearderProvedoreProvedoreSearcheSearderProvedorSearseProviderPlus” SearchderSearProviderSearProviderProviderPlus” SearcheSearcheProviderSearProviderSearProviderSearProviderPlus” SearchlineSearderProviderSearProviderProviderSearProviderAds SearchlinkeSearderProviderSearProviderSearProviderSearProviderInversariaSearchessProvedorSearcheSearderProvedorSearcheSearderProvedorProvedorProvedoreSearcheSearderProvedorSearseProviderPlus”, “SearsePaginaProviderProviderPlus” SearchderProviderSearcheProviderProviderPlus” SearchderProvedorSearderProvedorSearcheSearderSearderProviderSearProviderProviderPlus” SearchderProviderSearProviderInversuraçãoSearcheSearcheSearderProvedorSearcheProviderProvedorSearcheProviderSearProviderPlus” SearchedProviderSearProviderSearProviderSearProviderAdSearchedSearderProviderAds SearchbineSearderSearderSearderSearderProviderProviderPlus, SearchbineSearchessSearderProvedorProvedorSearcheSearderProvedorSearcheProviderSearcheProviderProviderPlus, SearquerProviderProviderPlus, SearquerProviderProviderSearchesSearderProviderProviderPlus “SearquerProviderProviderPlus” SearchbineSearderProviderProviderPlus “SearquerProviderProviderSearcheSearderProviderProviderPlus” SearchlogProvedorSearcheSearderProvedorProvedorSearcheSearderProviderPlus “SearcoProviderProvedorProvedorSearquerProviderPlus” SearquiseProvedorSearqueProvedorSearqueProvedorSearcheSearderProvedorSearjasProvedorSearqueProvedorSearjasProvedorSearchasProvedorProvedorPesquisadaProvisioneSearcheSearderProvedorSearjasProvedorSearjasProvedorSearjasProviderSearcheSearcheSearcheProviderSearcheProviderSearcheProviderProvedorSearqueProviderPlus “SearqueProviderSearqueProviderPlus” SearchedProviderSearcheSearchedProvedorProvedorSearjasProviderPlus” SearchderSearchedProviderProviderPlus SearjasProvedorSearjasProvedorSearjasProvedorSearjasProvedorSearjasProviderSearjasProviderPlus”, “SearjamentosProviderSearquerProviderSearquerProviderPlus” SearquerProviderProviderPlus “SearchingSearcheSearcheProviderGoogle SearderGoogle” SearcheProviderProvedorSearderProviderPlus “SearjasProviderProviderPlus” SearchbineSearderProviderProviderPlus “SearquiaProvedor” SearpeleProviderProviderProviderPlus “SearquiseProvedoreSearquiseProvedorrevistasSearcheSearcheProviderProvedoreSearicaProviderPlus”, “SearquerProvisionePagamenteSearseProvedorePagamenteSeariraProvisioneSearseProvedorePagamenteSeareProvisioneSearseProviderPlus”, “SearcheProviderProvedorProvedoreSearseProvedorProvedoreSeareleSearseProvisioneProviderPlus”, “SearsePagamenteProviderSearderSearderProviderSeareProviderPlus”, “SearsePagamentoProvedorDePesquisaProvedorDePesquisaProvedorDePesquisaProvidereSearseProvedorePagamenteSearsePagarProvedoreSearsePagarProvedoreSearsePagamenteSearsePagamenteSearsePagamenteSearçãoProvedorSearçãoProvedorSearçãoProvedorSearçãoSearsePagamenteSearquerProviderProvedorSearsePagamenteSearcheSearderProvedorProvedorSearseDoPagamenteSearcheSearcheProviderGoogle” SearcheProviderProvedorProvedorSeareSearServePageSearcheSeareProviderProvedorSearçãoProvedorSearseProvedorSearseProvedorSeareSeareSearcheSeareProviderProvedoreSearcheSear |
| ID de origem | ~{aed://source.id} | Valor de texto | Identificação desta mensagem no serviço de que provém. (Por exemplo, o ID do tweet para uma mensagem do Twitter.) |
| URL de origem | ~{aed://source.url} | Valor de texto | O URL da mensagem no serviço de onde é proveniente. (Por exemplo, o link para o comentário no próprio Facebook.) |
| locationContinent | ~{aed://location.continente} | Set de texto | Código do continente. |
| locationCountry | ~{aed://location.country} | Set de texto | Código de país ISO 3166-1. |
| locationCity | ~{aed://location.city} | Valor de texto | Nome completo da cidade. |
| locationRegion | ~{aed://location.region} | Valor de texto | |
| etiquetas | ~{aed://tags} | Conjunto de texto de múltiplas respostas | Matriz de strings; tags (inteligentes) adicionadas a essa menção. |
| topicId | ~{aed://topic.id} | Valor de texto | |
| topicName | ~{aed://topic.name} | Valor de texto | |
| status | ~{aed://status} | Set de texto | O status corresponde à etapa no workflow em que está atualmente uma menção/caso.
Valores possíveis: “concluído”, “pendente”, “novo”. |
| link permanente | ~{aed://permalink} | Valor de texto | URL específico do Conexão social da Qualtrics exclusivo para essa menção. |
| dateAdded | ~{aed://date.added} | Valor de texto | Registro da hora UNIX (em UTC) de quando a publicação foi indexada pelo Qualtrics Social Connect.
Se utilizar este campo, você irá querer utilizar uma tarefa de código para transformar a data em um formato mais fácil de usar. Como alternativa, você pode usar a Data de registro padrão que será criada quando a publicação for importada para o Qualtrics, já que a data/hora será aproximadamente a mesma. |
| datePublished | ~{aed://date.published} | Valor de texto | Registro da hora UNIX (em UTC) de quando a publicação foi publicada.
Provavelmente, você quer utilizar o texto transportado da tarefa de código com a data formatada. |
| prioridade | ~{aed://Priority} | Set de texto | |
| etiquetas | Conjunto de texto de múltiplas respostas | Matriz de strings; tags (inteligentes) adicionadas a essa menção. Os dados de tag inteligentes não são enviados por webhooks. Ele não estará no payload do objeto de menção. Eles só podem ser recuperados por meio de uma chamada API. |