Evento do Twilio Segment
Sobre eventos de segmento Twilio
O evento Twilio Segment permite que você integre o Qualtrics ao Twilio Segment para enviar dados ao Qualtrics com base em eventos no Twilio Segment. O evento Twilio Segment suporta 3 casos de utilização principais:
- Início de um fluxo de trabalho baseado em eventos de dados no segmento Twilio.
- Atualizando informações de contato no XM Directory com base em eventos no segmento Twilio.
- Adicionar dados de transação a um contato com base em eventos no segmento Twilio.
Configuração de um evento de segmento Twilio
Para usar o evento Twilio Segment, você deve concluir uma configuração no Twilio Segment e Qualtrics. Você deve adicionar o Qualtrics como um destino de webhook em sua instância Twilio Segment. Esta seção abordará a configuração da integração inicial com o segmento Twilio.
Para configurar a conexão, você precisará dos seguintes IDs da Qualtrics:
- Seu token de API (se você já tiver um token, não gere um novo)
- Seu ID do centro de dados
- Se você adicionar ou atualizar contatos no XM Directory, a ID do diretório em que deseja salvar os contatos.
Conectando ao segmento Twilio
- Na guia Fluxos de trabalho, clique em Criar um fluxo de trabalho.
- Selecione Iniciado quando um evento é recebido.
- Selecione o evento Twilio Segment.
- Em uma guia separada do navegador, efetue login no segmento Twilio. Não feche fora da Qualtrics.
- Vá para a guia Conexões.
- Clique em Adicionar destino.
- Procure a conexão Qualtrics e adicione-a à sua área de trabalho. Clique nele para começar a configurar a conexão.
- Dê um nome à conexão. Este nome é utilizado para fins organizacionais.
- Insira seu Token da API da Qualtrics. Consulte Gerar um token de API se precisar de ajuda para encontrar seu token.
- Insira o ID do centro de dados Qualtrics. Consulte Localizando o ID do centro de dados se precisar de ajuda para encontrar seu centro de dados.
- Certifique-se de que Ativar destino esteja ativado.
- Clique em Salvar alterações.
- Na aba Mapeamentos, clique em Novo mapeamento.
- Escolha o que deseja fazer:
- Criar e/ou atualizar contato no XM Directory: adicionar ou atualizar um contato no XM Directory com base em eventos de dados no segmento Twilio. Todos os contatos processados por esse evento serão desduplicados de acordo com as configurações do seu diretório. Consulte Adição ou atualização de contatos no XM Directory para o restante da configuração desta opção.
- Transação para contato de upsert: adicione dados de transação a um contato. Se o contato não existir, o contato será criado e, em seguida, os dados de transação serão adicionados a esse contato. Consulte Adicionando transações a contatos para o restante da configuração para esta opção.
- Iniciar um fluxo de trabalho no Qualtrics: iniciar um fluxo de trabalho da Qualtrics com base nos eventos de dados no segmento Twilio. Consulte Acionando um fluxo de trabalho do Qualtrics para o restante da configuração para esta opção.
Qdica: Você pode usar todas essas opções, se desejar! Você só precisará criar mapeamentos adicionais depois de configurar o primeiro.
Adição ou atualização de contatos no diretório XM
O evento Twilio Segment permite que você atualize contatos no XM Directory com base em alterações em seus dados no segmento Twilio.
- Siga as instruções em Configuração de um evento de segmento Twilio para integrar o Qualtrics com o segmento Twilio. Escolha a opção Criar e/ou atualizar contato no XM Directory ao configurar a integração.
- Adicione quaisquer condições de filtro que desejar. Essas condições determinam quando os dados são enviados para a Qualtrics.
Qdica: Por padrão, essa integração inclui automaticamente uma condição para “Tipo de evento” é “Identificar”. Você pode modificar este filtro ou adicionar novos, conforme necessário. Recomendamos que você inclua pelo menos 1 filtro para limitar os dados que são enviados para a Qualtrics. - Se desejar, use a seção Adicionar evento de teste para testar quais campos podem ser incluídos em seus mapeamentos.
- Na seção Selecionar mapeamentos, mapeie seu ID do diretório do Qualtrics. Se você tiver vários diretórios, selecione o diretório ao qual deseja adicionar contatos. Consulte Localizando o PoolID para mais informações.
- Se desejar, ajuste os mapeamentos de campo de evento. Consulte esta página Suporte Twilio para obter mais informações. Muitas vezes, você não precisará fazer ajustes nos mapeamentos pré-configurados.
- Clique em Salvar.
Adicionando transações a contatos
O evento Twilio Segment permite que você adicione dados de transação a contatos existentes em seu XM Directory. Se o contato ainda não existir no seu diretório, ele será criado. Os dados de transação serão gravados no contato recém-criado.
- Siga as instruções em Configuração de um evento de segmento Twilio para integrar o Qualtrics com o segmento Twilio. Selecione a opção de transação Upsert contact ao configurar a integração.
- Adicione quaisquer condições de filtro que desejar. Essas condições determinam quando os dados são enviados para a Qualtrics.
Qdica: por padrão, essa integração inclui automaticamente uma condição para “Tipo de evento” é “Rastrear” e “Nome do evento” é “Transação criada”. Você pode modificar este filtro ou adicionar novos, conforme necessário. Recomendamos que você inclua pelo menos 1 filtro para limitar os dados que são enviados para a Qualtrics.
- Se desejar, use a seção Adicionar evento de teste para testar quais campos podem ser incluídos em seus mapeamentos.
- Na seção Selecionar mapeamentos, mapeie seu ID do diretório do Qualtrics. Se você tiver vários diretórios, selecione o diretório ao qual deseja adicionar contatos. Consulte Localizando o PoolID para mais informações.
- Se desejar, ajuste os mapeamentos de campo de evento (por exemplo, se houver campos extras que você deseja transferir para a Qualtrics). Consulte esta página Suporte Twilio para obter mais informações. Muitas vezes, você não precisará fazer ajustes nos mapeamentos pré-configurados.
- Clique em Salvar.
Acionamento de um fluxo de trabalho do Qualtrics
O evento Twilio Segment permite iniciar um fluxo de trabalho na Qualtrics com base em eventos de dados no Twilio Segment.
- Siga as instruções em Configuração de um evento de segmento Twilio para integrar o Qualtrics com o segmento Twilio. Escolha a opção Iniciar um fluxo de trabalho no Qualtrics ao configurar a integração.
- Adicione quaisquer condições de filtro que desejar. Essas condições determinam quando os dados são enviados para a Qualtrics.
Qdica: Recomendamos que você inclua pelo menos 1 filtro para limitar os dados enviados à Qualtrics. - Use a seção Adicionar evento de teste para gerar um mapeamento de campo de teste.
Qdica: Você precisará de pelo menos 1 condição de filtro para gerar um evento de teste.
- Na Qualtrics, retorne ao evento Twilio Segment. Clique em Copiar URL.
- Retorne ao segmento Twilio. Na seção Selecionar mapeamentos, cole seu URL copiado no campo API HTTP para mapeá-lo para seu URL de workflow.
- Se desejar, ajuste os mapeamentos para os campos que você deseja transferir para a Qualtrics. Na coluna à esquerda, insira o nome do campo como você quer que ele apareça no Qualtrics.
- Na coluna à direita, escolha a variável de evento que você deseja transferir para a Qualtrics clicando na caixa e selecionando um campo.
- Ativar Exibir visualização do registro de teste.
Qdica: Você não poderá ativar essa opção se não tiver gerado o mapeamento de teste anteriormente. Role para cima até a seção Adicionar evento de teste para gerar o mapeamento de teste.
- Destaque o payload de evento JSON e copie-o.
- Clique em Salvar.
- Retorne ao evento Twilio Segment na Qualtrics. Navegue para a seção Configurações avançadas.
- Cole o payload de evento JSON que você copiou anteriormente no campo do objeto JSON.
- Clique em Adicionar mapeamento de campos. Seus campos serão mapeados automaticamente para você com base no payload JSON.
- Navegue para a seção Mapear campos e verifique se seus campos estão mapeados corretamente. Você pode ajustar seus campos conforme necessário.
- Para Caminho, insira os nomes de caminho de campo do Segmento Twilio para os campos que você deseja salvar no Qualtrics.
- Para o Tipo, selecione o tipo de dados que o campo contém:
- Cadeia: os dados são uma cadeia de texto.
- Número: os dados são um valor numérico.
- Booleano: os dados são um valor booleano (ou seja, verdadeiro ou falso).
- Clique em Adicionar um campo para mapear campos adicionais.
- Clique no sinal de menos ( – ) para remover um campo do seu mapeamento.
- Se desejar, você pode testar a integração para verificar se os dados corretos são transferidos para a Qualtrics clicando em Executar dados de teste e, em seguida, disparando um evento do Segmento Twilio. Consulte Capturando dados do evento para obter mais informações.
Qdica: Confira a sintaxe JSONPath para obter mais ajuda na interpretação do JSON.
- Clique em Salvar.
- Não se esqueça de adicionar uma tarefa ao seu workflow. Normalmente, esta é uma tarefa do XM Directory para distribuir uma pesquisa.
Qdica: Se você deseja salvar ou atualizar informações de contato, consulte Adição ou atualização de contatos no Diretório XM.Exemplo: Digamos que um cliente conclua o tour de integração do novo usuário, que atualiza seu registro no Twilio Segment. Essa alteração de dados pode acionar um fluxo de trabalho da Qualtrics, que podemos usar para distribuir uma pesquisa ao cliente solicitando que ele forneça feedback sobre a experiência de integração.