> For the complete documentation index, see [llms.txt](https://soporte.optiwe.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://soporte.optiwe.com/developers/descargar-documentos.md).

# Descargar documentos

En situaciones se requiere que un chatbot tenga la capacidad de descargar documentos de servidores externos.&#x20;

A continuación se detalla las especificaciones que debe tener la API en el servidor externo para que el bot sea capas de descargar el documento.

* **URL de ejemplo**: `https://sistema-externo.com/files/file_id/?param1=param1Value&param2=param2Value`
* **Verbo HTTP**: `GET`
* **Encabezados de solicitud**:
  * Accept: application/pdf
* **Encabezados de respuesta**:
  * Content-Type: application/pdf
  * Content-Disposition: attachment; filename="file\_name.pdf"
  * Content-Length: file\_length
* **HTTP status esperado**: `200`

**Observaciones:**

* La URL es un ejemplo. Los parámetros `file_id` , `param1` y `param2` son opcionales. La URL la puede definir a su conveniencia.
* El header `Content-Disposition` debe detallar el nombre del archivo.
* El header `Content-Length` debe detallar el tamaño del archivo en bytes.
