POST/api/mod/ventas/{espacio}/conversations/evidence

Recibe una imagen del cliente

Cuando tu cliente manda una imagen o un PDF en el chat, pásalo aquí. Con un pedido abierto es su comprobante de pago: se registra y el agente contesta en qué quedó el pago.

PERMISOlee (vale cualquier clave)
CRÉDITOSgasta créditos
AUTENTICACIÓNBearer bth_…

PARÁMETROS

CAMPO	TIPO	REQUERIDO	QUÉ ES
espacio	string	SÍ	El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Ventas.

CUERPO · MULTIPART/FORM-DATA

CAMPO	TIPO	REQUERIDO	QUÉ ES
file	archivo	SÍ	La imagen (JPG, PNG…) o el PDF, hasta 10 MB.
session_id	string	SÍ	La conversación en la que llegó: el mismo session_id con el que conversas.

RESPUESTA 200

CAMPO	TIPO	QUÉ ES
response	string	El mensaje para tu cliente: pago recibido, en revisión, ilegible…
estado	string	El estado de la conversación, como en conversar.
session_id · tenant_id	string	La sesión y el espacio.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUS	CUÁNDO	DETAIL LITERAL
403	El espacio no tiene el módulo Ventas	módulo no habilitado para este espacio.
402	La cuenta agotó sus créditos del ciclo	La cuenta de este espacio agotó sus créditos de este ciclo.
404	El agente no tiene activado facturacion_activo	Función no disponible.
409	No hay un pedido abierto en esa conversación (y no reconoció la imagen)	No hay un pedido en proceso para este chat.
415	No es una imagen ni un PDF	tipo de archivo no soportado (imagen o PDF).
400	El archivo llegó vacío	archivo vacío.
413	El archivo pasa de 10 MB	archivo demasiado grande (máximo … bytes).
429	El espacio mandó demasiadas peticiones seguidas: espera unos segundos	Demasiadas solicitudes; intenta en un momento.
502	No se pudo registrar el comprobante. detail trae tu mensaje_handoff: enséñaselo a tu cliente y pásalo a una persona	—

Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.

CONVIENE SABER

La imagen no se guarda en Ventas: se pasa al cobro del pedido y se descarta.
Con vision_imagen_activo, una imagen sin pedido abierto no da 409: si es un producto, el agente sigue la conversación; si es un pago, dice que lo vio pero que no hay pedido al que asociarlo.
Si el carrito está completo (productos, ciudad y método de pago) y llega el comprobante, se toma como la confirmación: se crea el pedido y se registra el pago.