Objetos Personalizados te permiten extender los objetos estándar Personas y Conversaciones de Intercom para almacenar datos que representan tu negocio de manera más flexible. Las referencias permiten definir cómo se relacionan esos objetos entre sí para que los datos relevantes se muestren a las personas adecuadas.
Tipos de referencia
Referenciando múltiples objetos
Este es un tipo de referencia más común. Por ejemplo, múltiples pedidos pueden pertenecer a la misma persona, pero un pedido solo puede pertenecer a una persona. Así que podrías crear un Objeto Personalizado llamado “Order” y crear tanto un atributo referencia a Personas como un atributo referencia a Order para relacionarlos entre sí.
En tu Objeto Personalizado llamado "Order":
En tu atributo Personas:
Referenciando un solo objeto
Otro tipo de referencia es la referencia "uno a uno". Por ejemplo, tienes muchas personas en tu sistema y requieres que proporcionen detalles del pasaporte para reservar un vuelo.
Asumiendo que una persona solo puede tener un pasaporte a la vez y un pasaporte solo puede pertenecer a una persona, crearías un Objeto Personalizado para “Passport” con atributos para “passport_number” y “expiry_date” y luego crearías una referencia que lo vincule a la persona con el interruptor 'Permitir referencia a múltiples personas' desactivado.
Y en el lado del atributo Personas, creas una referencia al objeto "Passport" con el interruptor desactivado también.
En tu Objeto Personalizado llamado "Passport":
En tu atributo Personas:
Editando tipos de referencia
Las referencias aún pueden editarse una vez que las has guardado, excepto sus nombres. Ten en cuenta que si editas el interruptor, todas las asociaciones existentes para esto pueden eliminarse. Esto significa que los bots y los Data connectors que usan este atributo podrían fallar.
Usando Objetos Personalizados en botones de flujo de trabajo
Al usar Objetos Personalizados en botones de flujo de trabajo, necesitas dos atributos de conversación que referencien tu tipo de Objeto Personalizado: uno para mostrar opciones; y otro para almacenar la selección del usuario.
Antes de comenzar
Crea dos atributos de conversación que ambos referencien tu tipo de Objeto Personalizado:
Atributo de visualización — configúralo en "referenciar muchos" para que pueda almacenar todas las opciones devueltas por tu data connector. Se usa para generar los botones que se muestran al cliente.
Atributo de selección — configúralo en "referenciar uno" para que almacene la elección única del cliente.
Configurando el data connector
Al crear tu data connector, la configuración sigue este orden:
Nombre y descripción — da al conector un nombre claro (por ejemplo, "Obtener opciones de pedido") y describe cuándo deben usarlo los compañeros de equipo. Esto se configura al inicio de la configuración.
Mapeo de objetos — asigna los campos de respuesta de tu API a los atributos relevantes del Objeto Personalizado. Asegúrate de mapear el ID al campo
external_idpara evitar duplicados.Actualizar referencias desde Personas o Conversaciones — este es el paso final en la sección de mapeo de objetos. Selecciona el atributo de visualización ("referenciar muchos") aquí para que el data connector llene las opciones de botones en tu flujo de trabajo.
Configurando el paso del flujo de trabajo
En el paso selector de Objeto Personalizado de tu flujo de trabajo:
Generación de botones — usa el atributo de visualización ("referenciar muchos") para leer y mostrar todas las opciones.
Selección del usuario — usa el atributo de selección ("referenciar uno") para guardar la elección del cliente.