🎬 API: Obtener fotos, videos y documentos

✨ ¿Por qué te encantará esta funcionalidad?

• Automatizar respaldos de toda la evidencia visual de tus tickets

• Alimentar análisis de contenido para detectar patrones en lo que envían tus clientes

• Cumplir normativas que requieren almacenar comunicaciones multimedia

📈 Impacto en tu Negocio

🤝 ¿Para qué puedo usarlo?

1. Respaldo automático de evidencia
• Exporta todos los comprobantes de pago que envían tus clientes
• Guarda capturas de errores reportados por usuarios

2. Análisis de contenido con IA
• Alimenta modelos de visión por computadora con las imágenes recibidas
• Detecta patrones en los documentos que envían tus clientes

3. Auditoría y cumplimiento
• Conserva registro de todas las comunicaciones multimedia
• Exporta archivos por rango de fechas para reportes periódicos

4. Integración con sistemas externos
• Sincroniza archivos con tu CRM o sistema de tickets externo
• Alimenta un data lake con contenido multimedia

🛠️ Guía Paso a Paso: Cómo usar el API

Paso 1: Obtén tu Token de Autenticación

1. Ve a Administrador → Usuarios de API

2. Copia tu Token de Acceso

3. Úsalo en el header de cada petición:

Authorization: Bearer TU_TOKEN_AQUI

📸 Token de API disponible en Administrador → Usuarios de API

Paso 2: Consulta archivos de un ticket específico

GET /v2/ticket/507f1f77bcf86cd799439011/media/?direction=inbound
Authorization: Bearer abc123def456

{
  "ticket_id": "507f1f77bcf86cd799439011",
  "total_media_files": 3,
  "media_files": [
    {
      "media_url": "https://storage.googleapis.com/.../imagen.jpg",
      "type": "image",
      "is_outbound": false
    }
  ]
}

Paso 3: Consulta archivos por rango de fechas

GET /v2/tickets/media/?from=2024-11-01T00:00:00Z&to=2024-11-30T23:59:59Z&page=1&page_size=50
Authorization: Key abc123def456

{
  "status": 200,
  "message": "Media files retrieved successfully",
  "data": {
    "start_date": "2024-11-01T00:00:00",
    "end_date": "2024-11-30T23:59:59",
    "total_media_files": 45,
    "total_tickets": 12,
    "tickets_media": [
      {
        "case_id": "507f1f77bcf86cd799439011",
        "files": [
          {
            "media_url": "https://storage.googleapis.com/.../doc.pdf",
            "type": "attachment",
            "is_outbound": true
          }
        ]
      }
    ]
  },
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_pages": 2,
    "has_next": true,
    "next_page": 2
  }
}

🛑 Zona de Peligro: Lee esto antes de usar el API

🔢 Límites y Restricciones

🔧 Solución de Problemas

Error 400: "Invalid date format"

• ✅ Formato correcto: 2024-12-05T10:30:00Z

• ✅ Con zona horaria: 2024-12-05T10:30:00-03:00

• ❌ Incorrecto: 2024-12-05 10:30:00 (sin T ni timezone)

Error 400: "Date range cannot exceed 30 days"

Error 404: "Ticket not found"

• Verifica que el ID del ticket sea correcto

• Confirma que estás usando el token correcto (del mismo establishment)

Archivos con media_url: null

• El archivo expiró en WhatsApp (archivos de WhatsApp expiran después de cierto tiempo)

• Error de red durante la recuperación

• Archivo eliminado del almacenamiento de origen

📂 Glosario de Términos

🧪 Pruébalo Ahora

Opción 1: Documentación Interactiva (Recomendado)

1. Abre el enlace

2. Busca los endpoints de Ticket Media

3. Haz clic en "Try it out"

4. Ingresa tu token y parámetros

5. ¡Ejecuta y ve la respuesta en tiempo real!

📸 [Imagen: Captura de la interfaz de Swagger mostrando el endpoint de media]

Opción 2: Desde Terminal

curl -X GET "https://api.postcenter.app/v2/ticket/TU_TICKET_ID/media/" \
  -H "Authorization: Key TU_TOKEN"