Archivos

Busca archivos entrantes en el dispositivo actual ---- Prueba este endpoint en el probador de API en vivo ¿Necesitas ayuda?

API de WhatsApp y CRM

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

GET https://api.getincloud.ai/v1/chat/{deviceId}/files

Busca archivos entrantes en el dispositivo actual

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y juega con el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Parámetros

Campo	Dónde	Tipo	Obligatorio	Descripción
`type`	query	array	No	Filtra archivos por tipo de medio
`search`	query	string	No	Busca archivos por nombre de archivo, descripción, ID de mensaje o ID de chat `maxLength: 100`
`chat`	query	array	No	Filtra archivos por ID(s) de WhatsApp de chat. Se permiten varios IDs de chat separados por comas. Ejemplo de ID de WhatsApp: `1234567890@c.us`
`ids`	query	array	No	Filtra archivos por IDs
`message`	query	array	No	Filtra archivos por IDs de WhatsApp del mensaje de origen. Se pueden definir varios IDs separados por comas. Ejemplo de ID de WhatsApp: `3EB02B134C4F0CA8D148`
`flow`	query	string	No	Filtra por el flujo del mensaje multimedia que contiene el archivo: usa `in` para mensajes entrantes y `out` para mensajes salientes `enum: ['in', 'out']`
`after`	query	string	No	Archivos creados después de la fecha indicada en formato ISO 8601: `2023-10-01T00:00:00.000Z` `format: date-time`
`before`	query	string	No	Archivos creados antes de la fecha indicada en formato ISO 8601: `2023-10-15T12:00:00.000Z` `format: date-time`
`page`	query	number	No	Número de página de resultados (empezando desde 0) `minimum: 0` · `maximum: 300` · `default: 0` · `format: integer`
`size`	query	number	No	Tamaño de página de resultados `minimum: 1` · `maximum: 50` · `default: 20` · `format: integer`
`sort`	query	string	No	Criterio de ordenación de archivos `enum: ['date:asc', 'date:desc']` · `default: date:desc`

Respuestas

Código	Descripción
`200`	Archivo
`400`	Datos de consulta o cuerpo de la solicitud no válidos
`401`	No autorizado: token de API no válido o ausente
`403`	Faltan los permisos necesarios
`404`	Recurso no encontrado
`409`	Conflicto
`429`	Demasiadas solicitudes: inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Servicio no disponible temporalmente: inténtalo de nuevo más tarde

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Search most recent files
curl --request GET \
  --url 'https://api.getincloud.ai/v1/chat/{deviceId}/files?size=20&page=0' \
  --header 'Token: <api token goes here>'


// Search group only files
curl --request GET \
  --url 'https://api.getincloud.ai/v1/chat/{deviceId}/files?type=group' \
  --header 'Token: <api token goes here>'


// Get files by chat WID
curl --request GET \
  --url 'https://api.getincloud.ai/v1/chat/{deviceId}/files?chat=1234567890%40c.us' \
  --header 'Token: <api token goes here>'


// Get inbound files only
curl --request GET \
  --url 'https://api.getincloud.ai/v1/chat/{deviceId}/files?flow=in&size=20' \
  --header 'Token: <api token goes here>'


// Get files by specific type
curl --request GET \
  --url 'https://api.getincloud.ai/v1/chat/{deviceId}/files?type=image%2Cvideo%2Cdocument&size=20' \
  --header 'Token: <api token goes here>'

AnteriorArchivar chat SiguienteAsignar chat

¿Te sirvió esta página?