Referencia de atributos de interacción

Los objetos de interacción se devuelven mediante Listar interacciones de una ubicación, Obtener interacciones agregadas y Obtener interacciones por ID. Los dos endpoints paginados los envuelven en una conexión de estilo Relay: tanto data.interactions (por ubicación) como data.rollupInteractions (agregación de la cuenta) contienen edges[].node, pageInfo y totalCount. La consulta por ID no utiliza paginación; data.interactionDetails es un objeto { "interactions": [ ... ] } simple sin edges, pageInfo ni totalCount.

Campos de interacción

Campo	Tipo	Descripción
id	String	UUID de la interacción. Pásalo como `interactionId` al responder
interactionId	String	El mismo UUID que `id`
source	String	Nombre de host del sitio de reseñas o de la red social (e.g, `maps.google.com`, `yelp.com`)
title	String	Título de la interacción, cuando el origen proporciona uno
content	String	Texto del cuerpo de la reseña o publicación
authorName	String	Nombre visible del autor
rating	Integer	Valoración en estrellas, de 1 a 5 (solo reseñas)
date	String	Marca de tiempo de la interacción en formato ISO 8601
permalink	String	Enlace directo a la interacción en el sitio de origen
category	String	Categoría general: e.g, `Review` o `Social`
type	String	Tipo específico de interacción: `Review`, `Question`, `Comment`, `Recommendation`, `Post`, `Photo`, `Message`, `Response`
responded	Boolean	Indica si existe una respuesta del propietario
notes	String	Notas privadas del propietario de la cuenta
responses	Array	Respuestas del propietario asociadas a esta interacción (consulta más abajo)
responseCount	Integer	Número de respuestas asociadas
canRespond	Boolean	Indica si se puede publicar una respuesta desde Listings API para este origen
locationId	Integer	ID numérico en la base de datos de la ubicación a la que pertenece la interacción
flaggedReason	String	Motivo por el que se marcó la interacción, si lo hay

Campos del objeto de respuesta

Cada elemento del array responses de una interacción (y el objeto devuelto por Responder a una interacción):

Campo	Tipo	Descripción
id	String	ID único de la respuesta (pásalo como `responseId` al editarla o archivarla)
interactionId	String	ID de la interacción a la que pertenece esta respuesta
content	String	Texto de la respuesta
authorName	String	Nombre mostrado como autor de la respuesta
date	String	Marca de tiempo de creación de la respuesta
respondedWith	String	ID de la plantilla de respuesta utilizada, si la hay
respondedBy	Integer	ID del usuario de Listings API que envió la respuesta
interactionStatus	String	Estado del ciclo de vida: `CREATED`, `FAILED`, `COMPLETED` o `CONFIRMED`
editedResponse	Boolean	Indica si esta respuesta se ha editado desde su publicación inicial
remarks	String	Observaciones del sistema (e.g, detalles del fallo)

Flujo de estados de la respuesta

El campo interactionStatus permite seguir el progreso de una respuesta durante su publicación en el sitio de origen:

CREATED → COMPLETED: publicada en la plataforma de publicación; esa plataforma no ofrece doble confirmación
CREATED → COMPLETED → CONFIRMED: publicada y posteriormente confirmada por la plataforma de publicación
CREATED → FAILED: el envío a la plataforma de publicación no se completó correctamente; consulta remarks

Valores enumerados de los filtros

Los endpoints paginados aceptan estos valores enumerados como filtros:

responseStatus: RESPONDED, PENDING
sortOrder: NEWEST_FIRST, OLDEST_FIRST, LAST_RESPONDED
category: REVIEW (y otras categorías generales disponibles por cuenta)