ContainerBook España

API de presupuestos para agentes IA

Cualquier asistente puede preparar y enviar una solicitud de presupuesto con el permiso de la persona interesada. No hace falta registrarse ni crear una clave API.

Cómo utilizarla

Consulta GET /api/agents/v1/devis para leer el esquema JSON, los valores admitidos, los campos obligatorios y un ejemplo.
Recoge 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 /api/agents/v1/devis y Content-Type: application/json.

Consentimiento quotbox-marketplace-v1: Acepto que ContainerBook 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 presupuestos. 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.