Skip to main content

La API Felo PPT ahora exporta archivos PPTX reales

· 8 min de lectura
Felo Search Tips Buddy
Felo Search Tips Buddy
Committed to answers at your fingertips

La API de tareas PPT de Felo OpenAPI ahora exporta presentaciones generadas como archivos .pptx editables. Una clave de API, un flujo asíncrono de cuatro pasos y un enlace de descarga.

Tu agente puede investigar un tema, construir un esquema y generar una presentación terminada sin que uses una herramienta de diseño. Antes, no podía entregarte un archivo que tu equipo abriera en PowerPoint.

Ese vacío ya no existe. Felo OpenAPI ahora exporta presentaciones generadas como archivos .pptx reales. La API de tareas PPT ya producía diapositivas editables dentro de Felo; los nuevos endpoints de exportación las convierten en un archivo de PowerPoint que puedes descargar, editar y compartir. Mismo API key, mismo patrón asíncrono, una llamada extra.

Pruébalo ahora: https://openapi.felo.ai/docs/api-reference/ppt-tasks

Felo PPT Task API ahora exporta archivos .pptx reales: investigación a presentación en un solo flujo, POST /v2/ppts/{id}/export, download_url válido por 30 minutos

Qué cambió​

Antes de esta actualización, la API de tareas PPT terminaba en una URL de diapositivas de Felo. Recibías una presentación, pero el proceso se detenía ahí: para mostrarla a un cliente, una clase o una junta, alguien tenía que reconstruirla en PowerPoint manualmente.

Ahora el flujo termina completo. Cuando una tarea de generación PPT llega a COMPLETED, llamas a un endpoint de exportación y haces polling a un segundo. La API devuelve un download_url firmado que apunta a un archivo .pptx genuino — la misma presentación, en el formato que todos usan.

Dos aspectos hacen esto más que una simple conversión de formato:

  • La presentación es editable. No es un PDF, ni un conjunto de imágenes planas. Texto, diseños y estructura de tema se mantienen en PowerPoint, así que un colega puede corregir un número o reordenar una sección sin regenerar nada.
  • La investigación ya está hecha. La generación PPT de Felo no solo coloca tu prompt en diapositivas. Investiga el tema, reúne fuentes, estructura el argumento y aplica un tema. Recibes una presentación lista para exponer, no un primer borrador que necesita reescritura.

Esa combinación es el objetivo. La mayoría de las herramientas investigan bien y te entregan texto, o formatean bien y te dan estructura vacía. Felo hace ambas cosas, y ahora entrega el resultado como archivo.

Cómo funciona la exportación​

La exportación es asíncrona, igual que el resto de la API de tareas PPT. Envías un trabajo, haces polling hasta que termina y descargas el resultado.

Paso 1 — Genera la presentación​

Crea una tarea PPT con un prompt. Si quieres un estilo específico, lista los temas disponibles primero y pasa el ID del tema.

POST https://openapi.felo.ai/v2/ppts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "query": "Q3 competitive landscape review, 12 pages",
  "ppt_config": {
    "ai_theme_id": "02968979-a69f-42c4-b136-de02c40ab2d7"
  }
}

La respuesta devuelve un task_id y un ppt_business_id. Guarda ambos — necesitas el task ID para hacer polling de la generación y el business ID para exportar.

Paso 2 — Haz polling hasta que la presentación esté lista​

GET https://openapi.felo.ai/v2/tasks/{task_id}/historical
Authorization: Bearer YOUR_API_KEY

Haz polling cada 2–5 segundos. Cuando task_status indique COMPLETED, la presentación existe y puedes exportarla. También recibes un ppt_url si quieres previsualizar las diapositivas en Felo primero.

Paso 3 — Envía la exportación​

POST https://openapi.felo.ai/v2/ppts/YOUR_PPT_BUSINESS_ID/export
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{}

Ese es todo el cuerpo de la solicitud: {}. La exportación se ejecuta como un trabajo en segundo plano.

Paso 4 — Haz polling de la exportación y descarga​

GET https://openapi.felo.ai/v2/ppts/{ppt_business_id}/export
Authorization: Bearer YOUR_API_KEY

Haz polling cada 2–5 segundos. data.status pasa por NOT_STARTED, PROCESSING y COMPLETED. Solo COMPLETED trae el contenido que buscas:

{
  "status": "ok",
  "message": null,
  "data": {
    "status": "COMPLETED",
    "download_url": "https://example.com/presentation.pptx?signature=...",
    "expires_at": "2026-09-29T10:30:00Z"
  }
}

Descarga el archivo desde download_url y el proceso termina.

Flujo de exportación PPTX: POST /v2/ppts crea la presentación, GET /v2/tasks/{task_id}/historical hace polling hasta COMPLETED, POST /v2/ppts/{id}/export inicia la exportación, GET /v2/ppts/{id}/export devuelve download_url válido por 30 minutos

Cuatro detalles que debes saber antes de usarlo​

El enlace de descarga expira 30 minutos después de emitirse. Es una URL firmada, no un enlace permanente. Si expira, llama de nuevo al endpoint GET de exportación — eso genera una URL nueva sin regenerar el PPTX, así que no tiene costo.

Repetir la exportación después de completarla consume un crédito. Repetir el POST mientras una exportación sigue procesándose es seguro y no inicia un segundo trabajo. Pero llamar POST otra vez después de que la exportación terminó regenera el archivo y cobra el crédito de exportación PPT existente. Si solo necesitas un enlace nuevo, usa GET.

La clave de API debe ser dueña de la presentación. La exportación está limitada a la clave que creó el PPT. Una clave que no generó la presentación no puede exportarla, lo que mantiene las presentaciones dentro de la cuenta que las creó.

Las fallas pueden reintentarse. Una exportación FAILED puede enviarse de nuevo con el mismo POST. Créditos insuficientes devuelven HTTP 402; límites de tasa devuelven HTTP 429 y conviene reintentarlo tras una breve espera.

Por qué esto importa para los agentes​

Lo interesante no es el formato del archivo. Es lo que permite un pipeline completo de investigación a archivo.

Un agente que investiga y exporta puede ejecutar el ciclo completo sin supervisión:

  • Revisiones de negocio semanales — extrae métricas de la semana, investiga el contexto detrás de los números, genera la presentación, la exporta y coloca el .pptx en el drive compartido antes del standup del lunes.
  • Entregables para clientes — convierte un brief en una presentación con fuentes y tema, y entrega un archivo editable que el cliente puede personalizar.
  • Material de ventas — genera una presentación personalizada por prospecto a partir de investigación de cuenta, exporta cada una y la adjunta al registro CRM automáticamente.
  • Material de cursos y capacitación — investiga un tema, lo estructura como lección, exporta diapositivas que un instructor puede editar antes de clase.

En cada caso, el trabajo humano se reduce a revisar y pulir. Nadie empieza desde una diapositiva en blanco.

Si prefieres no escribir el ciclo de polling tú mismo, la Skill Felo PPT lo gestiona. Instala el paquete de agente Felo AI y tu agente obtiene la capacidad de crear, hacer polling y exportar presentaciones como una sola función — el mismo pipeline descrito arriba, envuelto para que el agente lo llame directamente.

Primeros pasos​

La exportación está activa en la API de tareas PPT, disponible para cualquier clave de Felo OpenAPI.

  1. Obtén tu clave de API desde el dashboard de Felo OpenAPI.
  2. Lee la referencia de la API de tareas PPT — la sección Export PPTX muestra las formas exactas de solicitud y respuesta.
  3. Genera una presentación, expórtala y abre el archivo en PowerPoint.

Si quieres el camino rápido, instala la Skill Felo PPT y deja que tu agente ejecute todo el flujo.

Empieza a construir con Felo OpenAPI: https://openapi.felo.ai

Preguntas frecuentes​

¿El archivo exportado se puede editar en PowerPoint? Sí. La exportación produce un archivo .pptx estándar. Texto, diseño y estructura de tema se mantienen, así que la presentación puede editarse en PowerPoint, Google Slides o Keynote.

¿Exportar cuesta extra? Enviar una exportación después de generar la presentación usa el crédito de exportación PPT existente. Créditos insuficientes devuelven HTTP 402. Obtener un enlace de descarga nuevo con GET no regenera el archivo ni suma un cargo.

¿Cuánto tiempo es válido el enlace de descarga? 30 minutos desde que se emite. Llama de nuevo al endpoint GET de exportación para obtener un enlace nuevo.

¿Puedo exportar una presentación creada con otra clave de API? No. La clave de API que hace la solicitud de exportación debe ser dueña del PPT.

¿Qué ocurre si la exportación falla? data.status devuelve FAILED. Envía de nuevo la solicitud POST de exportación para reintentarlo.

Esta publicación también está disponible en English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, বাংলা and Português.