Concierge Radar

Herramienta de la cuenta de agente: requiere OAuth y la elección explícita de agente registrada por concierge_agente_confirmar. Esta herramienta busca por nombre entre los clientes de la agente autenticada. La respuesta contiene como máximo cinco nombres e identificadores opacos y excluye teléfono, correo, notas y documentos.

concierge_clientes_buscar

Herramienta de la cuenta de agente: requiere OAuth y la elección explícita de agente registrada por concierge_agente_confirmar. Esta herramienta consulta el avance de una búsqueda iniciada por la agente autenticada y devuelve hasta cinco opciones. La llamada puede permanecer abierta hasta 35 segundos por defecto mientras el estado es pending o partial. Si terminado=false, la búsqueda sigue en curso y retry_after_seconds indica el intervalo para volver a consultar el mismo work_id. Cada opción incluye los campos hotel, proveedor y costo_agencia cuando el motor dispone de esos datos.

concierge_cotizacion_consultar

Consulta pública: una sesión pendiente devuelve choose_audience; una sesión de viajero con elección explícita registrada recupera su búsqueda. Recupera el mismo trabajo de búsqueda de la sesión pública, sin iniciar otro ni acceder a clientes o cotizaciones de agentes. Si sigue en curso, espera su resultado hasta 35 segundos por defecto según capacidad disponible. done contiene hoteles, fotos, fechas, ocupación y tarifas observados, con su aviso de disponibilidad; needs_details una pregunta por datos faltantes; error una falla. pending todavía no contiene tarifas y permite consultar el mismo trabajo de nuevo tras retry_after_seconds. No requiere registro ni datos de contacto y no reserva.

concierge_viajero_consultar

Registra la elección explícita “Soy agente de viajes” para la cuenta conectada. Requiere OAuth válido y soy_agente=true; conserva una elección ya confirmada sin repetir la pregunta. No convierte una cuenta de viajero en agente ni amplía permisos; tampoco crea clientes, cotizaciones o reservas.

concierge_agente_confirmar

Recorrido público de viajeros: requiere una sesión con elección explícita registrada por concierge_empezar. La sesión pendiente choose_audience no admite esta operación. Crea un enlace para continuar el viaje por WhatsApp con Concierge Radar. Requiere la aceptación explícita del viajero en confirmar_whatsapp y admite opcion_id para conservar el hotel elegido. Conserva el contexto del viaje, sin requerir teléfono ni registro. La persona abre el enlace y envía el texto preparado; la herramienta no envía mensajes ni contacta a terceros. El bot puede solicitar correo opcional al final.

concierge_viajero_whatsapp

Recorrido público de viajeros: requiere una sesión con elección explícita registrada por concierge_empezar. La sesión pendiente choose_audience no admite esta operación. Inicia o actualiza una búsqueda pública de tarifas de hospedaje en Radar. La primera llamada recibe los detalles conocidos del viaje; las siguientes aceptan cambios o respuestas breves. El trabajo corre en segundo plano; esta llamada espera su resultado hasta 35 segundos por defecto, según capacidad disponible. done contiene tarifas observadas; needs_details una pregunta por datos faltantes; error una falla. pending todavía no contiene tarifas: el mismo trabajo es consultable con concierge_viajero_consultar tras retry_after_seconds. La comparación flexible explora hasta tres fechas de llegada y las duraciones aceptadas. No requiere registro ni datos de contacto y no reserva. La misma idempotency_key reutiliza exclusivamente el mismo mensaje.

concierge_viajero_buscar

Herramienta de la cuenta de agente: requiere OAuth y la elección explícita de agente registrada por concierge_agente_confirmar. Esta herramienta crea un borrador privado desde una opción final del motor, un cliente propio y un precio total de venta confirmado. La operación no genera ligas, envíos ni reservas.

concierge_cotizacion_crear_borrador

Herramienta de la cuenta de agente: requiere OAuth y la elección explícita de agente registrada por concierge_agente_confirmar. Esta herramienta crea un cliente privado únicamente con su nombre. La operación requiere confirmación explícita y su contrato excluye teléfono, correo, notas y documentos.

concierge_clientes_crear

Herramienta de la cuenta de agente: requiere OAuth y la elección explícita de agente registrada por concierge_agente_confirmar. Esta herramienta crea un borrador privado con hoteles y servicios aportados por la agente, incluidos viajes multidestino. Requiere un cliente propio y precios de venta explícitamente confirmados, en centavos de una sola moneda. Admite hasta 20 servicios contando alternativas, con hasta cuatro alternativas del primer hospedaje; los hoteles de las demás etapas permanecen incluidos. No admite grupos de alternativas independientes por ciudad. No consulta proveedores ni verifica tarifas o disponibilidad, y no genera ligas, reservas, cobros ni mensajes.

concierge_cotizacion_crear_itinerario

Crea una sesión temporal o registra la elección explícita de uso de Concierge Radar. Sin sesion devuelve choose_audience y las opciones “Soy agente de viajes” y “Busco un viaje para mí”. Con la misma sesion y tipo registra la elección y activa el recorrido correspondiente. Una sesión pendiente no admite búsquedas ni enlaces de WhatsApp. La elección registrada se conserva. La conexión OAuth no identifica esa elección. El recorrido de viajero es público; las funciones de agente requieren una cuenta conectada.

concierge_empezar