-
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 consolidar e analisar todo o feedback digital dos clientes em um só lugar. Em seguida, você pode analisar seus dados usando qualquer método de análise Qualtrics, incluindo o Text iQ em um dashboard 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 Conta.
- Navegue até a seção Qualtrics IDs da sua conta e copie seu token de API. Se você já tiver um token de API, não gere um novo token.
- Anote o seu nome de usuário do Qualtrics. Normalmente, esse é o endereço de e-mail que você usa para fazer login no Qualtrics. Se não souber seu nome de usuário Qualtrics, contato o administrador Marca.
- Usando seu nome de usuário do Qualtrics, construa uma string de credenciais usando o seguinte formato:
<Your Qualtrics Username>:<Your Qualtrics API Token>.Qdica: Se você usar o SSO para fazer login no Qualtrics, certifique-se de incluir o componente # do seu nome de usuário.Exemplo: Um exemplo de cadeia de credenciais é:
barnaby@qualtrics.com:63V9BuO9wMyvgo9HOf1OpeTOrhkvYGiRx1yMGrki - Codifique a cadeia de caracteres da credencial com codificação base64. Você pode usar qualquer codificador base64 on-line para fazer isso.
Exemplo: Minha string de credencial codificada em base64 é:
YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k= - Construa o cabeçalho de autorização no seguinte formato: Basic <credenciais codificadas em base64>. Observe o espaço entre “Basic” e as credenciais.
Exemplo: Meu cabeçalho de autorização final é:
Básico YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=
Você precisará dessa credencial de autorização na avançar seção. Copie-o em um local de fácil acesso.
Etapa 2: Criar uma automação no Qualtrics Social Connect
Esta seção aborda 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 fluxo de trabalho e , em seguida, em Iniciado por um evento.
- Escolha o Evento JSON.
- Clique em Copiar URL para copiar o endpoint evento. Você precisará desse endpoint evento para concluir a configuração no Qualtrics Social Connect. Salve-o em algum lugar onde possa acessá-lo mais tarde.
- Em uma nova guia do navegador, faça login no Qualtrics Social Connect.
Qdica: o Qualtrics Social Connect usa credenciais separadas de sua conta Qualtrics. Contato a equipe de suporte do Social Connect se tiver dúvidas sobre como acessar o Qualtrics Social Connect.
- Vá para Configurações Conta.
- Na guia Overview (Visão geral ), selecione Automation Recipes (Receitas de automação).
- Na seção On Case Update (Atualização de caso), clique em Add Automation Recipe (Adicionar receita de automação).
- Dê um nome à sua receita de automação.
- Certifique-se de que Mention esteja selecionado na seção Acionador e selecione Was created (Foi criado ) no menu suspenso.
- 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 deseja monitorar.
- Na seção Action (Ação ), selecione Acionador Webhook ( Acionar Webhook ) no menu suspenso.
- No campo URL, cole o endpoint evento que você copiou na etapa 4.
- No campo Authorization Header (Cabeçalho deautorização), cole o cabeçalho de autorização que você criou anteriormente.
- Se estiver usando uma chamada de API para recuperar tags, ative a opção Delay (Atraso ). Recomenda-se definir um atraso mínimo de 10 minutos para garantir que as tags tenham tido tempo de ser anexadas às menções.
- Clique em Add para concluir a configuração.
Para testar a conexão, gere uma nova menção (a maneira 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 avançar postagem quando isso acontecer naturalmente. Depois que a nova menção tiver sido gerada, abra o evento JSON em seu fluxo de trabalho Qualtrics e examine as propriedades JSON que foram capturadas pelo evento:
Etapa 3: Criando o conjunto de dados do Qualtrics
Para salvar os dados no Qualtrics, você deve criar um conjunto de dados do Qualtrics. Você pode criar um conjunto de dados Qualtrics chamando API Dataset diretamente da linha de comando.
- Abra um editor de texto e crie o comando API. O formato geral está abaixo:
curl -X POST API-H "Content-Type: application/json" -H "X-API-TOKEN: Your Qualtrics API Token" -d '{ "name":"Escolha um nome para seu conjunto de dados", "primaryKey":"Choose ID column name", "createProject": true, "fields": [ { "name":"Same ID column name as above", "type": "string" } ] }' - No comando API acima, você precisa substituir os seguintes valores:
- brandID: O ID de sua organização Qualtrics.
- Seu token API do Qualtrics: Seu token de API.
- Escolha um nome para seu conjunto de dados: Digite um nome para dar ao conjunto de dados.
- Escolha o nome da coluna 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 à API terá o seguinte formato:
{"result":{"name":"<Name of your dataset>", "primaryKey":"<id field that you defined>", "datasetId":"ID do conjunto de dados, é isso 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 Qualtrics Projetos como um projeto de dados importados. Clique em seu projeto para abri-lo.
- Depois de abrir o projeto de dados importados, você pode usar o editor de campos na guia Data & Analysis (Dados e amp; Análise ) para adicionar os campos que deseja importar do Social Connect. Consulte Campos comuns do Social Connect 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: Conclusão do Fluxo de trabalho
Agora que você estabeleceu uma conexão com o Qualtrics Social Connect e criou seu conjunto de dados, é hora de mapear os dados do Qualtrics Social Connect para o seu conjunto de dados.
- Abra o fluxo de trabalho que você criou anteriormente.
- Clique no sinal de mais(+) e selecione Tarefa.
- Escolha o Serviço da Web tarefa.
- Selecione Authenticated web service (Serviço da 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.
- Escolha OAuth para o tipo de conexão.
- Selecione Credenciais do cliente para o tipo de concessão.
- Digite seu Client ID e Client secret. Consulte API OAuth para obter mais informações sobre como criá-los.
- Cole o seguinte URL no ponto de extremidade do token: https://BrandID.DatacenterID.qualtrics.com/oauth2/token
- Substitua o texto em negrito acima pelas IDs correspondentes:
- BrandID: O ID de sua organização Qualtrics.
- DatacenterID: Seu ID do datacenter do Qualtrics.
- Clique em Conectar conta.
- Escolha sua conta recém-adicionada.
- Clique em Avançar.
- Selecione POST para o tipo de solicitação.
- Digite o URL no seguinte formato:
https://brandID.qualtrics.com/API/v3/datasets/DatasetID/dataOnde brandID é o ID da marca Qualtrics e DatasetID é o ID do conjunto de dados que você copiou anteriormente.
- Na seção Headers (Cabeçalhos), adicione Authorization (Autorização ) como uma Key (Chave).
- Para o Value (Valor), digite Bearer (Portador ) e adicione um espaço à direita.
- Clique no ícone de texto transportado, {a}, e escolha sua conta QSC.
- Na seção Body (Corpo), selecione JSON Key-value pairs (Pares chave-valor JSON ) e comece a mapear seus campos. Para a chave, digite o nome do campo. Para o valor, use texto transportado para selecionar o campo proveniente diretamente do evento JSON. A seção Common Social Connect Fields (Campos comuns do Social Connect) tem o código de texto transportado para dados não transformados do Social Connect.
- Quando terminar, clique em Salvar.
Etapa 5: Analisando os dados de conexão social do Qualtrics
Esta seção aborda como analisar os dados do Qualtrics Social Connect nos painéis CX e no Text iQ.
Exibição de dados de conexão social em painéis de CX
- Crie um novo dashboard em um projeto de dashboard CX.
- Clique em Add Source (Adicionar fonte), passe o mouse sobre External data sources (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 do Social Connect para obter mais informações sobre o tipo de campo sugerido para cada campo do conjunto de dados.
- Salve suas alterações quando terminar.
A edição de seu dashboard é igual à edição de qualquer dashboard do CX. Consulte as seguintes páginas de suporte para saber mais:
- Introdução aos dashboards CX
- Etapa 1: Criação do seu projeto e carimbo; adição de um Dashboard
- Etapa 2: Mapeamento de uma fonte de dados Dashboard
- Etapa 3: Planejamento do design do seu Dashboard
- Etapa 4: Criando seu Dashboard
- Etapa 5: Personalização adicional Dashboard
- Etapa 6: Compartilhamento e amp; administração de usuários
Usando o Text iQ
Recomendamos que você use o Text iQ em seu dashboard CX. Isso garantirá que todos os seus dados estejam em um só lugar, e os campos do Text iQ serão automaticamente mapeados para o dashboard se você os analisar por meio do dashboard. Quando estiver pronto para começar, clique no botão Analisar no Text iQ em seu dashboard.
A maioria dos campos de menção não será útil para análise de texto (por exemplo, autor, fonte, 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 a análise de texto de resposta pesquisa no Qualtrics. Consulte as seguintes páginas de suporte para saber mais:
Importação de enriquecimentos XM Discover
Esta seção aborda como importar os enriquecimentos XM Discover para o seu conjunto de dados. Embora não seja obrigatório integrar-se ao Qualtrics Social Connect, os enriquecimentos XM Discover ajudam você a analisar suas menções em tempo real, marcando-as com base no conteúdo da menção.
- No Social Connect, vá para Tags.
- Clique em Add XM Discover Enrichment (Adicionar enriquecimento do XM Discover ).
- Escolha o(s) tópico(s) para o(s) qual(is) você gostaria de adicionar enriquecimentos.
- Clique em Seguinte.
- Escolha os modelos de categoria que você gostaria de usar.
Qdica: há um limite de 2 categorias por tópico. Se precisar de mais do que isso, contato a equipe do Social Connect fazendo login na sua conta do Qualtrics Social Connect, clicando no ícone do perfil e selecionando Contato support.
. - Para Enriquecimento em tempo real, selecione Sim.
Atenção: Se você não ativar o enriquecimento em tempo real, os enriquecimentos XM Discover serão processados com um atraso de 7 ou mais minutos após a criação da menção no Social Connect e, portanto, as tags correspondentes não estarão disponíveis no seu 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 XM Discover em seu conjunto de dados do Qualtrics. Elas são salvas como o campode tags.
Como os Enriquecimentos 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 usando 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, seu código texto transportado para a criação do seu mapeamento, o tipo de campo como você deve salvá-los no Qualtrics e quaisquer notas especiais sobre o campo.
| Nome do campo do conjunto de dados | Caminho de texto canalizado (para mapeamento fluxo de trabalho ) | Tipo de campoDashboard | Descrição & Notas especiais |
| id | ~{aed://id} | Valor de texto | Identificador específico do Qualtrics Social Connect para essa menção (exclusivo por tópico). |
| uniqueId | ~{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 identificador 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 identificador do autor original da menção. (Caso este seja 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. Twitter UID). |
| messageTitle | ~{aed://message.title} | Texto aberto | |
| messageContent | ~{aed://message.content} | Texto aberto | O conteúdo está em formato HTML. Talvez você queira usar 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 a mensagem está. |
| messageSentiment | ~{aed://message sentimento | Set de texto | Qualquer uma das opções: positivo, negativo, neutro ou não definido. |
| messageType | ~{aed://message.type} | Set de texto | Tipo de mensagem.
Valores possíveis: “post”, “privatemessage”, “video”, “checkin”, “photo”, “text”, “quote”, “link”, “chat”, “audio”, “email”, “review”, “applause”, “like”, “retweet”, “shared”, “repin”, “user_favorite”, “reblog”, “engagement”, “comment”, “reply”, “tips”, “question”, “answer”, “postcard”, “listed”, “case”, “live_chat”, “document”, “user_tweet”, “user_mention”, “normal”, “other”. |
| sourceCategory | ~{aed://source.category} | Set de texto | Essa menção pode ser classificada na categoria.
Valores possíveis: “social”, “social_videos”, “social_photos”, “microblogs”, “forums”, “blogs”, “podcasts”, “comments”, “news”, “news_academic”, “news_consumer”, “news_corporate”, “news_government”, “news_journal”, “news_local”, “news_national”, “news_organisation”, “news_presswire”, “news_trade”, “wikis”, “reviews”, “qa”, “locations”, “apps”, “products”, “shops”, “classifieds”, “email”, “case”. |
| sourceService | ~{aed://source.service} | Set de texto | De qual fonte de “serviço conectado” vem a menção.
Valores possíveis: “twitter”, “facebook”, “facebook_ads”, “foursquare_venue”, “googleplus”, “instagram”, “instagram_hashtag”, “instagram_ads”, “linkedin_group”, “pinterest”, “rss”, “youtube”, “mixcloud”, “telegram_bot”, “tripadvisor”, “tumblr_blog”, “soundcloud”, “vimeo”, “linkedin_company”, “lithium”, “yelp_business”, “keywordsearch”, “mailservice”, “telligent_forum”, “instagram_business_profile”, “instagram_business_profile_hashtag”, “wechat”, “twilio”, “web”, “whatsapp”, “viber”, “linkedin_company_v2”, “apple_business_chat”, “gominga_locations”, “gominga_apps”, “gominga_products”, “gominga_shops”, “email_mailbox”, “ditto_brand”, “social_case”, “social_document”, “ios”, “android”, “custom”. |
| sourceType | ~{aed://source.type} | Set de texto | De que fonte vem a menção. (Nome interno para filtragem.)
Valores possíveis: “SearchProviderFacebook”, “SearchProviderFacebookAds”, “SearchProviderTwitter”, “SearchProviderGoogle”, “SearchProviderGooglePlus”, “SearchProviderFoursquare”, “SearchProviderInstagram”, “SearchProviderInstagramBusinessProfile”, “SearchProviderInstagramAds”, “SearchProviderInstagramHashtags”, “SearchProviderLinkedInGroups”, “SearchProviderLinkedInCompanies”, “SearchProviderLinkedInCompaniesV2”, “SearchProviderRss”, “SearchProviderOmgili”, “SearchProviderMoreOver”, “SearchProviderTrendiction”, “SearchProviderYahoo”, “SearchProviderWordpress”, “SearchProviderBing”, “SearchProviderYoutube”, “SearchProviderCustom”, “SearchProviderApi”, “SearchProviderPinterest”, “SearchProviderMixCloud”, “SearchProviderTripadvisor”, “SearchProviderTumblr”, “SearchProviderVimeo”, “SearchProviderSoundCloud”, “SearchProviderEmail”, “SearchProviderLithium”, “SearchProviderYelp”, “SearchProviderCase”, “SearchProviderDocument”, “SearchProviderTelegramBot”, “SearchProviderTelligent”, “SearchProviderWeChat”, “SearchProviderTwilio”, “SearchProviderWeb”, “SearchProviderWhatsApp”, “SearchProviderViber”, “SearchProviderAppleBusinessChat”, “SearchProviderGomingaLocations”, “SearchProviderGomingaApps”, “SearchProviderGomingaProducts”, “SearchProviderGomingaShops”, “SearchProviderIos”, “SearchProviderAndroid”. |
| sourceId | ~{aed://source.id} | Valor de texto | Identificação dessa mensagem no serviço de onde ela vem. (Por exemplo, o ID do tweet de uma mensagem do Twitter) |
| sourceUrl | ~{aed://source.url} | Valor de texto | O URL da mensagem no serviço de onde ela vem. (Por exemplo, o link para o comentário no próprio Facebook) |
| localizaçãoContinente | ~{aed://location.continent} | Set de texto | Código do continente. |
| localizaçãoPaís | ~{aed://location.country} | Set de texto | Código de país ISO 3166-1. |
| localizaçãoCidade | ~{aed://location.city} | Valor de texto | Nome completo da cidade. |
| localizaçãoRegião | ~{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 ao estágio do fluxo de trabalho em que uma menção/caso se encontra no momento.
Valores possíveis: “done”, “pending”, “new”. |
| permalink | ~{aed://permalink} | Valor de texto | Qualtrics Social Connect specific-url exclusivo para essa menção. |
| dateAdded | ~{aed://date.added} | Valor de texto | Registro de data e hora UNIX (em UTC) de quando a postagem foi indexada pelo Qualtrics Social Connect.
Se estiver usando esse campo, você deverá usar uma tarefa de código para transformar a data em um formato mais fácil de usar. Como alternativa, você pode usar a Data registrada padrão que será criada quando a postagem for importada para o Qualtrics, pois a data e hora serão aproximadamente as mesmas. |
| datePublished | ~{aed://date.published} | Valor de texto | Registro de data e hora UNIX (em UTC) de quando a postagem foi publicada.
Provavelmente, em vez disso, você deve usar texto transportado tarefa código com data formatada. |
| prioridade | ~{aed://prioridade} | Set de texto | |
| etiquetas | Conjunto de texto de múltiplas respostas | Matriz de strings; tags (inteligentes) adicionadas a essa menção. Os dados da tag inteligente não são enviados por meio de webhooks. Ele não estará no payload do objeto Mention. Eles só podem ser recuperados por meio de uma chamada de API. |