Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.
Contacts

O que significa quando "valor inválido" aparece em vermelho ao lado de uma propriedade de um contato?

Ultima atualização: Janeiro 15, 2019

Você pode descobrir que alguns valores das propriedades de seus contatos são exibidos em vermelho com um erro de "Valor inválido" 

 

Por que esse erro aparece

Os valores da propriedade podem ser inválidos se:

  1. O valor da propriedade não corresponde ao formato exigido pelo tipo de propriedade (por exemplo, o contato tem um valor de texto em uma propriedade de tipo selecionador de data).
  2. A propriedade é uma propriedade de enumeração (seleção suspensa, várias caixas de seleção, seleção de rádio ou caixa de seleção única) e o valor do contato não corresponde aos valores definidos nas opções da propriedade.

Como isso acontece

  1. O contato tem um valor definido quando a propriedade é um tipo e, em seguida, a propriedade é alterada para outro tipo, tornando o valor do contato inválido. Por exemplo, você está usando um campo de texto de linha única para capturar a data de aniversário dos seus contatos que preenche um dos seus formulários:
    • Um contato preenche o formulário e fornece o valor em 25 de outubro de 2015.
    • Depois, edite o tipo de propriedade e faça uma propriedade de seletor de data.
    • Agora que a propriedade é uma propriedade de seletor de data, o valor de 25 de outubro de 2015 é inválido, pois os valores de seletor de data devem ser armazenados no backend como unix timestamps (e.g., 1445745600000) embora o valor de data/hora da propriedade seja exibido no aplicativo como formato de data humano, como 10/25/2015.
  2. O contato tem um valor de propriedade inválido definido através da API de formulários, o que permite que qualquer valor seja passado a uma propriedade, mesmo que o valor seja inválido.
    • Por exemplo, ao passar um valor para uma propriedade de selecionador de data por meio da API de formulários, o valor deve ser passado no formato de milissegundos do UNIX. Como mencionou acima, o aplicativo do HubSpot exibirá o registro de data e hora em um formato legível, mas o valor deve ser passado como um registro de data e hora:
      • Se quiser definir um valor para uma propriedade de data para o seu contato em 25 de outubro de 2015, os valores de aprovação de 10/2015, 10 a 25 de 2015 ou 25 de outubro de 2015 podem resultar em um erro de valor inválido.
      • Em vez disso, você deve passar um valor de 1445745600000 (o timestamp do HubSpot equivalente de 25 de outubro de 2015) via API de Formulários.
    • Em outro exemplo, você está passando valores através de formulários de API para uma propriedade de enumeração, como a propriedade do HubSpot padrão Persona. Esta propriedade tem várias opções de propriedades diferentes que podem ser configuradas e cada opção possui um rótulo e um valor interno diferentes:
      • Ao passar um valor por meio da API de formulários para qualquer propriedade de enumeração, você deve passar o valor interno, não o rótulo.
      • O HubSpot exibirá o rótulo de cada opção de propriedade quando o valor interno correto for passado. Se um valor inválido for passado, esse valor será exibido como está, mas será colorido em vermelho e o valor inválido aparecerá quando você passar o mouse sobre o valor. 

        Persona_property_label_and_values.png
    • Em um terceiro exemplo, você está usando a API de formulários para transmitir valores a uma única propriedade de caixa de seleção (que também é uma propriedade de enumeração).
      • As únicas propriedades de caixa de seleção têm duas opções com rótulos Sim e Não e valores internos correspondentes verdadeiro e falso, respectivamente.
      • Se você passar o valor Sim via API de Formulários, esse valor é inválido porque você deve passar pelo valor interno correspondente para essa opção, que seria verdadeiro.

Para mais informações sobre a API de formulários, confira ou documentação do desenvolvedor.

Como corrigir um erro de valor inválido

Para corrigir um problema de erro inválido na enumeração

  1. Adicione esses valores inválidos como opções para a propriedade e depois mesclar as opções inválidas com as opções corretas e válidas. Confira este artigo para obter informações sobre como mesclar opções de propriedade. Observação: isso não funcionará para propriedades de caixa de seleção única ou outras propriedades padrão, como Persona ou Estágio de Ciclo de Vida, porque as opções de propriedade não são editáveis.
  2. Crie uma lista de contatos que têm qualquer valor para a propriedade de enumeração usando o filtro de lista "conhecido" para a propriedade de contato selecionada e depois exporte esses contatos. Uma vez exportado:
    • Se o valor que foi definido no contato corresponder ao rótulo da opção de propriedade, você não precisará alterar nada; você pode apenas reimportar os contatos com esse valor, porque o processo de importação procura o rótulo da propriedade (é somente por meio da API, onde você precisa passar o valor interno).
    • Se o valor que foi definido no registro não corresponder ao rótulo da opção de propriedade, defina o rótulo correto e depois reimporte os contatos.
  3. Exporte os dados de envio do formulário em que os valores inválidos foram definidos e depois reimporte os contatos com o rótulo da opção de propriedade.