---
title: Integração com ChatGPT
description: Conecte o OpenAI ChatGPT e GPTs personalizados aos workspaces, arquivos e planilhas da Siglata.
sidebar:
  label: ChatGPT
  order: 4
---

O ChatGPT pode inspecionar e atualizar planilhas e arquivos da Siglata através de Custom Actions OpenAPI e do Model Context Protocol.

## Configurando Custom Actions no ChatGPT

1. Abra o editor de GPTs personalizados em [chatgpt.com/gpts/editor](https://chatgpt.com/gpts/editor).
2. Em **Actions**, clique em **Create new action**.
3. Importe a especificação oficial OpenAPI da Siglata:
   `https://www.siglata.com/schema/spreadsheet/1`
4. Defina **Authentication** como `API Key` (Bearer) e forneça seu token da organização Siglata.

## Como Funciona o Trânsito de Arquivos

Quando um usuário envia um arquivo Excel, CSV ou documento no ChatGPT:

1. O cliente conectado envia os bytes ao endpoint autenticado `POST /mcp/files/stage` da Siglata,
   com o tipo de mídia e o nome do arquivo aceitos.
2. A Siglata guarda e verifica os bytes como um Arquivo pertencente ao servidor na Organização do
   chamador.
3. O ChatGPT passa o `file_id` retornado e o `revision_id` opcional na referência do anexo para a
   próxima operação.

> **Warning**
>
> As referências de anexos aceitam somente IDs de arquivos pertencentes ao servidor. A Siglata
> recusa `download_url`, URLs arbitrárias e metadados de arquivo fornecidos pelo host.

## Comandos Interativos

Você pode perguntar ao ChatGPT:

- _"Liste todas as planilhas na minha organização Siglata."_
- _"Analise a taxa de cancelamento (churn) da planilha de clientes ativos e atualize a célula D15."_
- _"Valide se o modelo financeiro enviado corresponde ao schema da nossa organização."_