Evento do Twilio Segment

Sobre eventos do Twilio Segment

O evento Twilio Segment permite que você integre a Qualtrics com o Twilio Segment para enviar dados para a Qualtrics com base em eventos no Twilio Segment. O evento Twilio Segment suporta 3 casos de uso principais:

1. Iniciar um fluxo de trabalho com base em eventos de dados no Twilio Segment.
2. Atualização das informações de contato no XM Directory com base em eventos no Twilio Segment.
3. Adicionar dados de transação a um contato com base em eventos no Twilio Segment.

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 Twilio Segment.

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 data center
• Se estiver adicionando ou atualizando contatos no XM Directory, a ID do diretório em que você deseja que seus contatos sejam salvos.

Conectando ao segmento Twilio

1. Na guia Fluxos de trabalho, clique em Criar um fluxo de trabalho.
   
2. Selecione Iniciado quando um evento é recebido.
3. Selecione o evento Twilio Segment.
   
4. Em uma guia separada do navegador, faça login no Twilio Segment. Não feche a Qualtrics.
5. Vá para a guia Conexões.
   
6. Clique em Adicionar destino.
7. Procure a conexão do Qualtrics e adicione-a à sua área de trabalho. Clique nele para começar a configurar a conexão.
8. Dê um nome à conexão. Este nome é utilizado para fins organizacionais.
9. Insira seu Token da API Qualtrics. Consulte Gerando um token de API se precisar de ajuda para localizar seu token.
10. Insira seu ID do centro de dados Qualtrics. Consulte Localizando o ID do centro de dados se precisar de ajuda para localizar seu centro de dados.
11. Certifique-se de que Ativar destino esteja ativado.
12. Clique em Salvar alterações.
13. Na guia Mapeamentos, clique em Novo mapeamento.
14. Escolha o que você gostaria de fazer:
    
    • Criar e/ou atualizar contato no XM Directory: adicionar ou atualizar um contato no XM Directory com base em eventos de dados no Twilio Segment. Todos os contatos processados por este evento serão deduplicados de acordo com as configurações do seu diretório. Consulte Adicionando ou atualizando contatos no XM Directory pelo restante da configuração desta opção.
    • Transação de contato upsert: adicionar 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: inicie um fluxo de trabalho Qualtrics com base em eventos de dados no Twilio Segment. Consulte Acionamento de um fluxo de trabalho Qualtrics para o restante da configuração desta 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 XM Directory

O evento Twilio Segment permite que você atualize contatos no XM Directory com base em alterações em seus dados no Twilio Segment.

1. Siga as instruções em Configuração de um evento do Twilio Segment para integrar o Qualtrics com o Twilio Segment. Escolha a opção Criar e/ou atualizar contato no XM Directory ao configurar a integração.
2. Adicione as condições de filtro que desejar. Essas condições determinam quando os dados são enviados para a Qualtrics.
   
   Qdica: por padrão, esta integração inclui automaticamente uma condição para “Tipo de evento” que seja “Identificar”. Você pode modificar esse filtro ou adicionar novos, conforme necessário. Recomendamos que você inclua pelo menos 1 filtro para limitar os dados enviados para a Qualtrics.
3. Se desejar, use a seção Adicionar evento de teste para testar quais campos podem ser incluídos em seus mapeamentos.
4. Na seção Selecionar mapeamentos, mapeie o ID do diretório do Qualtrics. Se você tiver vários diretórios, escolha o diretório ao qual deseja adicionar contatos. Consulte Localizando o ID do pool para mais informações. 
5. Se desejar, ajuste os mapeamentos de campos de evento. Consulte esta página de suporte Twilio para obter mais informações. Muitas vezes, você não precisará efetuar ajustes nos mapeamentos pré-configurados.
6. 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 em seu diretório, ele será criado. Os dados de movimento serão gravados no contato recém-criado.

1. Siga as instruções em Configuração de um evento do Twilio Segment para integrar o Qualtrics com o Twilio Segment. Selecione a opção Transação de contato com upsert ao configurar a integração.
2. Adicione as 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” como “Acompanhamento” e “Nome do evento” é “Transação criada”. Você pode modificar esse filtro ou adicionar novos, conforme necessário. Recomendamos que você inclua pelo menos 1 filtro para limitar os dados enviados para a Qualtrics.
3. Se desejar, use a seção Adicionar evento de teste para testar quais campos podem ser incluídos em seus mapeamentos.
4. Na seção Selecionar mapeamentos, mapeie o ID do diretório do Qualtrics. Se você tiver vários diretórios, escolha o diretório ao qual deseja adicionar contatos. Consulte Localizando o ID do pool para mais informações.
5. 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 de suporte Twilio para obter mais informações. Muitas vezes, você não precisará efetuar ajustes nos mapeamentos pré-configurados.
6. Clique em Salvar.

Acionamento de um fluxo de trabalho Qualtrics

O evento Twilio Segment permite que você inicie um fluxo de trabalho no Qualtrics com base em eventos de dados no Twilio Segment.

1. Siga as instruções em Configuração de um evento do Twilio Segment para integrar o Qualtrics com o Twilio Segment. Escolha a opção Iniciar um fluxo de trabalho no Qualtrics ao configurar a integração.
2. Adicione as condições de filtro que desejar. Essas condições determinam quando os dados são enviados para a Qualtrics.
   
   Qdica: recomendamos incluir pelo menos 1 filtro para limitar os dados enviados à Qualtrics.
3. Utilize 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.
4. Na Qualtrics, retorne ao evento Twilio Segment. Clique em Copiar URL.
5. Retorne ao Twilio Segment. Na seção Selecionar mapeamentos, cole seu URL copiado no campo API HTTP para mapeá-lo para seu URL de fluxo de trabalho.
6. Se desejar, ajuste os mapeamentos para os campos que você deseja transferir para a Qualtrics. Na coluna à esquerda, insira o nome do campo, como deseja que ele seja exibido no Qualtrics.
7. Na coluna à direita, escolha a variável de evento que você deseja transferir para a Qualtrics clicando na caixa e selecionando um campo.
8. Ative Exibir visualização do registro de teste.
   Qdica: você não poderá ativar esta opção se não gerar o mapeamento de teste mais cedo. Role para cima até a seção Adicionar evento de teste para gerar o mapeamento de teste.
9. Destaque o payload do evento JSON e copie-o.
10. Clique em Salvar.
11. Retorne ao evento Twilio Segment na Qualtrics. Navegue para a seção Configurações avançadas.
12. Cole o payload do evento JSON que você copiou anteriormente no campo do objeto JSON.
13. Clique em Adicionar mapeamento de campo. Seus campos serão mapeados automaticamente para você com base no payload JSON.
14. Navegue para a seção Mapear campos e verifique se seus campos estão mapeados corretamente. Você pode ajustar seus campos conforme necessário.
15. Para o Caminho, insira os nomes do caminho de campo do Twilio Segment para os campos que você deseja salvar no Qualtrics.
16. Para o Tipo, selecione o tipo de dados que o campo contém:
    • String: os dados são uma string 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).
17. Clique em Adicionar um campo para mapear campos adicionais.
18. Clique no sinal negativo ( – ) para remover um campo do seu mapeamento.
19. 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 ativando um evento do Twilio Segment. Consulte Capturando dados do evento para obter maiores informações.
    Qdica: Confira a Sintaxe JSONPath para obter mais ajuda na interpretação do seu JSON.
20. Clique em Salvar.
21. Não se esqueça de adicionar uma tarefa ao seu fluxo de trabalho. Normalmente, esta é uma tarefa do XM Directory para distribuir uma pesquisa.
    Qdica: se você quiser salvar ou atualizar as informações de contato, consulte Adicionando ou atualizando contatos no XM Directory.
    Exemplo: digamos que um cliente conclua o tour de integração do novo usuário, que atualiza o registro no Twilio Segment. Essa alteração de dados pode acionar um fluxo de trabalho Qualtrics, que podemos usar para distribuir uma pesquisa ao cliente solicitando feedback sobre a experiência de integração.