Skip to main content

API Felo PPT agora exporta arquivos PPTX reais

· 8 minutos de leitura
Felo Search Tips Buddy
Felo Search Tips Buddy
Committed to answers at your fingertips

A API de Tarefas PPT do Felo OpenAPI agora exporta apresentações geradas como arquivos .pptx editáveis. Uma chave de API, um fluxo assíncrono em quatro etapas e um link de download.

Seu agente pode pesquisar um tema, construir um roteiro e gerar uma apresentação finalizada sem precisar abrir uma ferramenta de design. O único ponto que faltava era entregar um arquivo que sua equipe pudesse abrir no PowerPoint.

Essa lacuna foi preenchida. O Felo OpenAPI agora exporta apresentações geradas como arquivos .pptx reais. A API de Tarefas PPT já produzia slides editáveis dentro do Felo; os novos endpoints de exportação transformam esses slides em um arquivo PowerPoint para baixar, editar e compartilhar. Mesma chave de API, mesmo padrão assíncrono, uma chamada extra.

Experimente agora: https://openapi.felo.ai/docs/api-reference/ppt-tasks

API de Tarefas PPT do Felo agora exporta arquivos .pptx reais: pesquisa até apresentação em um fluxo, POST /v2/ppts/{id}/export, download_url válido por 30 minutos

O que mudou de fato​

Antes desta atualização, a API de Tarefas PPT terminava em uma URL de slides do Felo. Você recebia a apresentação, mas o processo parava ali: para mostrar ao cliente, à turma ou ao conselho, alguém precisava reconstruir tudo no PowerPoint manualmente.

Agora o fluxo se completa. Quando uma tarefa de geração de PPT chega a COMPLETED, você chama um endpoint de exportação e faz polling em outro. A API retorna um download_url assinado apontando para um arquivo .pptx genuíno — a mesma apresentação, no formato que todos já usam.

Dois pontos tornam isso mais que uma simples conversão de formato:

  • A apresentação é editável. Não é PDF, nem conjunto de imagens planas. Texto, layouts e estrutura de tema permanecem no PowerPoint, permitindo que um colega ajuste um número ou reorganize uma seção sem precisar gerar tudo de novo.
  • A pesquisa já está feita. A geração de PPT do Felo não apenas coloca seu prompt nos slides. Ela pesquisa o tema, reúne fontes, estrutura o argumento e aplica um tema. Você recebe uma apresentação pronta para apresentar, não um rascunho que precisa de revisão.

Essa combinação define o diferencial. A maioria das ferramentas pesquisa bem e entrega texto, ou formata bem e entrega estrutura vazia. O Felo faz ambos e agora entrega o resultado como arquivo.

Como funciona a exportação​

A exportação é assíncrona, igual ao restante da API de Tarefas PPT. Você envia um job, faz polling até finalizar e baixa o resultado.

Passo 1 — Gere a apresentação​

Crie uma tarefa PPT com um prompt. Se quiser um visual específico, liste os temas disponíveis primeiro e passe o ID do 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"
  }
}

A resposta retorna um task_id e um ppt_business_id. Guarde ambos — você precisa do task ID para fazer polling da geração e do business ID para exportar.

Passo 2 — Faça polling até a apresentação ficar pronta​

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

Faça polling a cada 2–5 segundos. Quando task_status mostrar COMPLETED, a apresentação existe e pode ser exportada. Um ppt_url também retorna caso queira visualizar os slides no Felo antes.

Passo 3 — Envie a exportação​

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

{}

Esse é todo o corpo da requisição: {}. A exportação roda como job em segundo plano.

Passo 4 — Faça polling da exportação e baixe o arquivo​

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

Faça polling a cada 2–5 segundos. data.status passa por NOT_STARTED, PROCESSING e COMPLETED. Só COMPLETED traz o payload desejado:

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

Baixe o arquivo do download_url e o processo termina.

Fluxo de exportação PPTX: POST /v2/ppts cria a apresentação, GET /v2/tasks/{task_id}/historical faz polling até COMPLETED, POST /v2/ppts/{id}/export inicia a exportação, GET /v2/ppts/{id}/export retorna download_url válido por 30 minutos

Quatro detalhes importantes antes de enviar​

O link de download expira 30 minutos após ser gerado. Trata-se de uma URL assinada, não um link permanente. Se expirar, chame o endpoint GET de exportação novamente — isso gera uma nova URL sem regenerar o PPTX, sem custo.

Reexecutar a exportação após concluir consome um crédito. Repetir o POST enquanto uma exportação está em processamento não inicia outro job. Mas chamar o POST novamente após a exportação terminar regenera o arquivo e consome o crédito de exportação PPT existente. Se só precisar de um novo link, use o GET.

A chave de API precisa ser dona da apresentação. A exportação fica restrita à chave que criou o PPT. Uma chave que não gerou a apresentação não pode exportá-la, mantendo os arquivos dentro da conta que os criou.

Falhas podem ser reprocessadas. Uma exportação FAILED pode ser enviada novamente com o mesmo POST. Créditos insuficientes retornam HTTP 402; limites de taxa retornam HTTP 429 e vale tentar novamente após breve espera.

Por que isso importa para agentes​

O ponto interessante não está no formato do arquivo. Está no que um pipeline completo de pesquisa até arquivo permite.

Um agente capaz de pesquisar e exportar pode agora rodar o ciclo inteiro sem supervisão:

  • Revisões semanais de negócios — coleta métricas da semana, pesquisa o contexto dos números, gera a apresentação, exporta e coloca o .pptx na pasta compartilhada antes da reunião de segunda.
  • Entregáveis para clientes — transforma um briefing em uma apresentação com fontes e tema, entregando um arquivo editável que o cliente pode personalizar.
  • Material de vendas — gera uma apresentação personalizada por prospect a partir de pesquisa de conta, exporta cada uma e anexa ao registro no CRM automaticamente.
  • Material de curso e treinamento — pesquisa um tema, estrutura como aula, exporta slides que o instrutor pode editar antes da aula.

Em cada caso, o trabalho humano se resume a revisar e aprimorar. Ninguém começa de um slide em branco.

Se preferir não escrever o loop de polling, o Felo PPT Skill faz isso. Instale o pacote do agente Felo AI e seu agente ganha a capacidade de criar, fazer polling e exportar apresentações como uma única habilidade — o mesmo pipeline descrito acima, encapsulado para o agente chamar diretamente.

Comece agora​

A exportação está ativa na API de Tarefas PPT, disponível para toda chave Felo OpenAPI.

  1. Pegue sua chave de API no dashboard do Felo OpenAPI.
  2. Leia a referência da API de Tarefas PPT — a seção Export PPTX traz os formatos exatos de requisição e resposta.
  3. Gere uma apresentação, exporte e abra o arquivo no PowerPoint.

Se quiser o caminho rápido, instale o Felo PPT Skill e deixe seu agente rodar todo o fluxo.

Comece a construir com Felo OpenAPI: https://openapi.felo.ai

Perguntas frequentes​

O arquivo exportado é realmente editável no PowerPoint? Sim. A exportação gera um arquivo .pptx padrão. Texto, layout e estrutura de tema permanecem, permitindo editar no PowerPoint, Google Slides ou Keynote.

Exportar custa mais? Enviar uma exportação após gerar a apresentação usa o crédito de exportação PPT existente. Créditos insuficientes retornam HTTP 402. Buscar um novo link de download com GET não regenera o arquivo e não gera cobrança adicional.

Quanto tempo o link de download fica válido? 30 minutos após ser gerado. Chame o endpoint GET de exportação novamente para um novo link.

Posso exportar uma apresentação criada com outra chave de API? Não. A chave de API que faz a requisição de exportação precisa ser dona do PPT.

O que acontece se a exportação falhar? data.status retorna FAILED. Envie a requisição POST de exportação novamente para tentar de novo.

Este post também está disponível em English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, Español and বাংলা.