Objetos Personalizados permitem que você estenda os objetos padrão Pessoas e Conversas do Intercom para armazenar dados que representam seu negócio de forma mais flexível. Referências permitem definir como esses objetos estão relacionados entre si para que os dados relevantes possam ser exibidos para as pessoas certas.
Tipos de referência
Referenciando múltiplos objetos
Este é um tipo de referência mais comum. Por exemplo, vários pedidos podem pertencer à mesma pessoa, mas um pedido pode pertencer a apenas uma pessoa. Então, você poderia criar um Objeto Personalizado chamado “Order” e criar tanto um atributo referência Pessoas quanto um atributo referência Order para relacioná-los entre si.
No seu Objeto Personalizado chamado "Order":
No seu atributo Pessoas:
Referenciando objeto único
Outro tipo de referência é a referência “um-para-um”. Por exemplo, você tem muitas pessoas no seu sistema e precisa que elas forneçam detalhes do passaporte para reservar um voo.
Assumindo que uma pessoa só pode ter um passaporte por vez e que um passaporte pode pertencer a apenas uma pessoa, você criaria um Objeto Personalizado para “Passport” com atributos para “passport_number” e “expiry_date” e então criaria uma referência que o vincula à pessoa com a opção 'Permitir referência a múltiplas pessoas' desativada (off).
E no atributo Pessoas, você cria uma referência para o objeto “Passport” com a opção desativada (off) também.
No seu Objeto Personalizado chamado "Passport":
No seu atributo Pessoas:
Editando tipos de referência
As referências ainda podem ser editadas depois de salvas, exceto seus nomes. Note que se você editar a opção, todas as associações existentes podem ser deletadas. Isso significa que bots e Data connectors que usam esse atributo podem falhar.
Usando Objetos Personalizados em botões de fluxo de trabalho
Ao usar Objetos Personalizados em botões de fluxo de trabalho, você precisa de dois atributos de conversa que referenciem seu tipo de Objeto Personalizado: um para exibir opções; e outro para armazenar a seleção do usuário.
Antes de começar
Crie dois atributos de conversa que referenciem seu tipo de Objeto Personalizado:
Atributo de exibição — configure como “referência múltipla” para armazenar todas as opções retornadas pelo seu data connector. É usado para gerar os botões mostrados ao cliente.
Atributo de seleção — configure como “referência única” para armazenar a escolha única do cliente.
Configurando o data connector
Ao criar seu data connector, a configuração segue esta ordem:
Nome e descrição — dê ao conector um nome claro (ex.: “Get order options”) e descreva quando os colegas devem usá-lo. Isso é configurado no início da configuração.
Mapeamento de objeto — mapeie os campos da resposta da API para os atributos relevantes do Objeto Personalizado. Certifique-se de mapear o ID para o campo
external_idpara evitar duplicatas.Atualizar referências de Pessoas ou Conversas — esta é a etapa final na seção de mapeamento de objeto. Selecione o atributo de exibição (“referência múltipla”) aqui para que o data connector preencha as opções dos botões no seu fluxo de trabalho.
Configurando a etapa do fluxo de trabalho
Na etapa seletora de Objeto Personalizado do seu fluxo de trabalho:
Geração de botões — use o atributo de exibição (“referência múltipla”) para ler e mostrar todas as opções.
Seleção do usuário — use o atributo de seleção (“referência única”) para salvar a escolha do cliente.