Discussions

Hola a todos!

Les escribo desde el equipo de Predial. Estamos configurando una acción personalizada directamente en el Agente de IA de HubSpot para buscar propiedades en tiempo real consumiendo su API en el endpoint GET /api/v1/property/search/ mediante el método GET.

Contamos con nuestra API Key activa y la autenticación funciona. Sin embargo, tenemos una limitación estricta en la interfaz de HubSpot: el sistema solo nos permite enviar parámetros simples tipo clave-valor en la URL (clave=valor). La interfaz cuenta con dos casilleros de texto plano: uno para la "Clave" (parámetro de la URL) y otro para el "Valor". Por este motivo, la plataforma no nos deja estructurar de forma nativa u orgánica el objeto JSON complejo que la documentación de Tokko exige para el parámetro data.

Como confirmamos que sí podemos exponer nuestra API Key directamente en HubSpot, queremos prescindir de un middleware e invocar a Tokko de manera directa. Para lograrlo, necesitamos que nos indiquen detalladamente y paso a paso cómo debemos completar estos casilleros:

• Formato exacto para simular el objeto JSON: ¿Cómo deberíamos rellenar los campos de Clave y Valor en HubSpot para que Tokko interprete correctamente el parámetro data? Por ejemplo, si en el casillero de Clave escribimos la palabra data, ¿cuál es el string o estructura exacta que debemos pegar en el casillero de Valor para que filtre por propiedades activas y tome la variable del usuario? ¿Debería verse en texto plano como un JSON compacto?:
  {"current_status": "all_active", "text": "{{query}}"}
  ¿O la interfaz de Tokko requiere que ese valor viaje completamente codificado para URL (URL-encoded) dentro de la variable data? Agradeceríamos que nos pasen el ejemplo de texto plano exacto listo para copiar y pegar.
• Mapeo para búsqueda de texto libre: Cuando el usuario en el chat de HubSpot escribe una dirección (ej: "Palestina 933") o un código de referencia, guardamos ese texto en una variable interna llamada {{query}}. Dentro del JSON que va en data, ¿el atributo correcto para buscar por ese texto libre es text, query, q o se debe estructurar dentro de un objeto de localización más específico?
• Ejemplo de Payload de respuesta exitosa: Les solicitamos si nos pueden facilitar un ejemplo del JSON completo (la respuesta HTTP) que devuelve este endpoint cuando encuentra propiedades. Lo necesitamos en detalle para poder cargar y mapear manualmente las variables de salida en HubSpot (como el Precio, Dirección, Fotos y la URL de la propiedad en nuestra web) para que el agente de IA pueda mostrárselas ordenadas al cliente en el chat.

Quedamos atentos a su guía detallada paso a paso para poder replicarla exactamente en nuestro panel de HubSpot.

¡Muchas gracias por el soporte!