Adicionando contatos do diretório

Sobre a adição de contatos do diretório

A guia Contatos do diretório contém todos os contatos adicionados ao diretório da sua organização. Todos os contatos adicionados a uma lista de destinatários são adicionados a esse diretório automaticamente, mas você também pode adicionar pessoas diretamente ao próprio diretório usando o botão Adicionar contatos do diretório.

Campos disponíveis

Se você está carregando um CSV ou TSV de contatos ou digitando-os manualmente, há certas informações que você deve incluir para seus contatos.

• Nome: o primeiro nome do contato.
• Sobrenome: o sobrenome do contato.
• E-mail: o endereço de e-mail do contato. É recomendável mesclar duplicatas neste campo.
• ExternalDataReference: informações adicionais sobre o contato. Isso é comumente usado para armazenar dados, como um número de ID do funcionário ou estudante. Ele pode ser usado para fazer login nos autenticadores e configurar como o diretório mescla duplicatas.
• Dados integrados: os dados integrados são campos adicionais que contêm o campo que você deseja. Estes não precisam seguir uma determinada convenção de nomes. Na captura de tela acima, Departamento, Cidade e País são todos dados integrados.
  Qdica: Os nomes de dados integrados têm um máximo de 200 caracteres. Os valores devem ter um máximo de 1024 caracteres cada.
  Aviso: anteriormente, todos os campos de dados integrados diferenciavam maiúsculas de minúsculas. Para a grande maioria dos usuários, os dados integrados não diferenciam mais maiúsculas de minúsculas, o que significa que “teste” e “teste” seriam tratados como o mesmo campo. No entanto, ainda aconselhamos a consistência de maiúsculas e minúsculas como uma prática recomendada, pois há uma pequena porção de contas em que essa alteração não foi feita.
  Aviso: não use Pontos como um campo de dados integrados porque ele é um campo reservado no XM Directory. Além disso, não use nenhum dos outros campos padrão da Qualtrics.
• Idioma: uma coluna opcional que identifica o idioma do contato utilizando códigos de idioma.
• Telefone: uma coluna opcional que identifica o número de telefone do contato. Consulte a página de suporte de Distribuições por SMS para ver os formatos de número de telefone aceitos.

Dados de data e hora

Se você tiver dados integrados salvos em um formato de data, poderá usar um filtro para procurar datas futuras ou datas que ocorreram recentemente. Para procurar por data, o campo de data deve estar no formato ISO-8601, com horas em UTC. (Ou seja, AAAA-MM-DDT-HH:mm:ss+ZZZZ . Mais informações sobre esses símbolos podem ser encontradas na página de suporte Sintaxe de formato de data).

Carregar um arquivo

1. Clique em Adicionar contatos do diretório.
   
2. Clique em Carregar um arquivo.
   
3. No Excel, crie um documento com os campos obrigatórios e salve-o como CSV ou TSV. Ou clique em Baixar um modelo de amostra, preencha as colunas apropriadas, adicione os dados incorporados desejados e salve o arquivo.
   
4. Quando o arquivo estiver pronto, arraste-o e solte-o no espaço fornecido ou clique em Selecionar um arquivo e selecione o arquivo em sua pasta.
5. Clique em Seguinte.
6. Revise as condições de importação do contato. Quaisquer regras para toda a diretoria para mesclar contatos duplicados serão exibidas aqui. Essas regras são definidas nas configurações do diretório e serão aplicadas aos contatos em seu arquivo.
   
   Qdica: o acesso à guia Configurações do diretório requer a permissão Gerenciar diretório. Fale com o seu Administrador da marca se você estiver interessado em obter acesso a essa configuração.
7. Revise os campos em seu arquivo para garantir que as informações estejam corretas. Se um campo não for reconhecido corretamente, clique no nome do campo para visualizar um menu suspenso de opções e selecione o campo correto.
   Qdica: Se os dados não estiverem formatados corretamente na visualização (por exemplo, agrupados em vez de divididos em colunas), talvez seus dados não estejam separando (ou “delimitando”) corretamente. Para corrigir isso, selecione o link azul Mostrar opções e escolha um Delimitador e/ou embalagem diferente.
   Qdica: Se um contato for carregado com um campo incorporado vazio que já tenha um valor armazenado nesse campo, o campo não será sobregravado e o valor atual permanecerá.
8. Clique em Carregar o arquivo para carregar os contatos para seu diretório.

Solução de problemas de importações de arquivo

A Qualtrics facilita a verificação do status das importações de contato e corrige os erros que possam ter ocorrido. Nós fornecemos um arquivo linha a linha de cada contato e informações sobre se ele foi importado corretamente. Isso serve como referência para que, se seus contatos não forem importados, você pode identificar qual foi o problema, corrigir o arquivo e tentar novamente.

Para obter um status detalhado da sua importação:

1. Após carregar seu arquivo, clique no ícone da caixa de ferramentas no canto superior direito da guia Diretório de contatos.
   
   Qdica: Se estiver importando contatos para uma lista de destinatários específica, você também poderá clicar na caixa de ferramentas dentro da lista de destinatários.
2. Clique em Exibir detalhes da importação.
3. Revise o resumo da importação. Isso incluirá quantos contatos foram criados, quantos contatos foram atualizados e quantos contatos falharam na importação. Além disso, a sua importação receberá um ID de progresso, que é útil estar disponível se você precisar entrar em contato com o Suporte da Qualtrics.
   
4. Para fazer o download do seu arquivo de relatório de erros, clique em Faça o download de um relatório.
   
   Qdica: Dependendo do tamanho do seu upload, o relatório pode demorar alguns minutos para ser gerado.
5. Abra o arquivo em um editor de planilha eletrônica em seu computador e revise o arquivo para quaisquer contatos que falharam. A coluna mais útil para identificar contatos falhados é a coluna ImportStatus. Mais informações sobre cada coluna estão abaixo.

Campos do relatório de erros

Abaixo está uma descrição de cada campo no relatório de erros:

• SourceIndexId: o índice, ou ID de linha, do contato no arquivo de importação.
• E-mail: o endereço de e-mail associado ao contato.
• ContactId: o ID do contato em seu diretório.
• ImportStatus: o status de importação para o contato. Os valores incluem: Adicionado, Atualizado e Falha.
• ImportStatusCode: o código de status para a importação. Consulte a seção seguinte para obter uma lista de códigos e seus significados.
• TransactionId: se aplicável, o ID da transação do contato é carregado ou atualizado.
  Qdica: Você pode configurar transações ao utilizar uma automação de importação de contatos ou ao adicionar contatos via API.
• TransactionStatus: se aplicável, o status para a transação. Os valores incluem: Adicionado, Atualizado e Falha.
• TransactionStatusCode: o código de status para a transação. Consulte a seção seguinte para obter uma lista de códigos e seus significados.
• ContactListContactId: se você adicionar contatos a uma lista de destinatários ou criar uma nova lista, o ID do contato na lista de destinatários específica.
• ContactListContactStatus: ao adicionar contatos a uma lista de destinatários ou criar uma nova lista, o status da adição ou atualização. Os valores incluem: Adicionado, Atualizado e Falha.
• ContactListContactStatusCode: o código de status para o contato na lista de destinatários. Consulte a seção seguinte para obter uma lista de códigos e seus significados.

Códigos de status

Abaixo está uma lista de códigos de status possíveis e suas descrições.

Entrada manual

1. Clique em Adicionar contatos do diretório.
   
2. Selecione Entrada manual.
   
3. Revise as condições de importação do contato. Quaisquer regras para toda a diretoria para mesclar contatos duplicados serão exibidas aqui. Essas regras são definidas nas configurações do diretório e serão aplicadas aos contatos que você inserir.
   
4. Preencha os campos disponíveis. Você pode digitar ou copiar e colar informações de contato.
5. Clique no sinal de mais (+) para adicionar uma coluna adicional para dados integrados. Lembre-se, isso pode ser o que você quiser.
6. Clique em Avançar para carregar seus contatos.

Adicionando contatos de interceptores digitais

Você pode adicionar automaticamente contatos ao XM Directory a partir de quaisquer interceptores digitais que você possa ter criado. Mais informações sobre como configurar a criação automática de contatos em projetos de Website/App Feedback podem ser encontradas na página de suporte Integração do XM Directory com interceptores digitais.

Perguntas frequentes