ContainerLatino Chile
API de cotizaciones para agentes IA
Cualquier asistente puede preparar y enviar una solicitud de cotización con el permiso de la persona interesada. No hace falta registrarse ni crear una clave API.
El canal de recepción está configurado. Comprueba la respuesta de cada envío: una solicitud pendiente todavía no confirma un Lead recibido.
Chile: código postal de siete dígitos; teléfono nacional de 9 dígitos o +56 y 9 dígitos. Puedes declarar la región con su código CUT de dos dígitos (01 a 16) en entidadFederativa, nombre técnico conservado por compatibilidad. El código postal no la asigna automáticamente. Las cotizaciones se preparan en CLP. La recepción externa depende de la configuración de una fuente chilena propia.
Cómo utilizarla
- Consulta GET /cl/api/agents/v1/devis para leer el esquema JSON, los valores admitidos, los campos obligatorios y un ejemplo.
- Recopila los datos del proyecto y presenta a la persona el texto de consentimiento que devuelve la API.
- Después de recibir su autorización, envía un objeto JSON con
POST /cl/api/agents/v1/devisyContent-Type: application/json.
Consentimiento quotbox-marketplace-v1: Acepto que ContainerLatino trate mi solicitud y ponga mi proyecto y mis datos de contacto a disposición de un máximo de 5 profesionales registrados en Quotbox para que puedan responder con cotizaciones. Esta solicitud no me inscribe en campañas publicitarias.
El agente debe incluir consentement: true y consentimientoQuotboxAgente: "quotbox-marketplace-v1"solo después de obtener ese consentimiento. El teléfono del ejemplo es un marcador: usa el número real facilitado por la persona interesada. La URL privada de Quotbox se utiliza únicamente en el servidor.
Respuestas
- 200: Quotbox ha creado un Lead para los profesionales inscritos.
- 202: la solicitud está guardada y su entrega a Quotbox sigue pendiente. Conserva la referencia; no crees otra solicitud.
- 422: faltan datos o hay campos inválidos.
- 429: se ha alcanzado un límite de solicitudes; consulta
Retry-After.
También pueden devolverse 400 para JSON ilegible, 413 para un cuerpo demasiado grande, 415 para otro tipo de contenido y 503 cuando la recepción no está disponible. Los datos de contacto pueden ser consultados por un máximo de 5 profesionales registrados, conforme al consentimiento.