Configuração

Dotz GPT → TradeFlow Gateway

Gateway Online

Para a equipa Dotz: Esta página contém tudo o que precisam para configurar o Custom GPT no ChatGPT (versão web). A API Key é fornecida separadamente pela TradeFlow via canal seguro.

Modos Disponíveis

discover

Lista entidades autorizadas

structured

Query estruturada (filters + fields)

Pergunta em linguagem natural

Dados de Ligação

Endpoint

https://tradeflowstart.base44.app/functions/aiGateway

empresa_id

6abd7cd37d6876dfeb9f0607

Promasidor Angola

API Key

Fornecida pela TradeFlow · Header: X-API-Key

4 Passos no ChatGPT Web

Criar GPT

Aceda a chat.openai.com/gpts/editor (web, não mobile) e clique em Create a GPT

Importar Action

Configure → Actions → Create new action → Import from OpenAPI → cole o YAML abaixo

Configurar Auth

Authentication → API Key → cole a chave → Custom header: X-API-Key

Testar e Publicar

Teste com "Que dados posso consultar?" → Publish → partilhar link com a equipa

OpenAPI 3.1

openapi: 3.1.0
info:
  title: TradeFlow AI Gateway
  version: 1.1.0
  description: Gateway somente leitura para consultar dados autorizados do TradeFlow.
servers:
  - url: https://tradeflowstart.base44.app/functions
security:
  - ApiKeyAuth: []
paths:
  /aiGateway:
    post:
      summary: Consultar dados (somente leitura)
      operationId: queryTradeFlow
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QueryRequest'
      responses:
        "200":
          description: Sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryResponse'
        "401":
          description: API key invalida
        "403":
          description: Empresa ou entidade nao autorizada
components:
  schemas:
    QueryRequest:
      type: object
      required:
        - empresa_id
        - mode
      properties:
        empresa_id:
          type: string
          example: "6abd7cd37d6876dfeb9f0607"
        mode:
          type: string
          enum:
            - discover
            - structured
            - ai
        entity:
          type: string
        filters:
          type: object
        fields:
          type: array
          items:
            type: string
        limit:
          type: number
          default: 50
        sort:
          type: string
          default: "-created_date"
        question:
          type: string
          maxLength: 1000
    QueryResponse:
      type: object
      properties:
        ok:
          type: boolean
        data:
          description: Dados retornados (entidades, registos ou mensagem)
        meta:
          type: object
          description: Metadados da consulta (mode, entity, count)
        error:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

Entidades Autorizadas (somente leitura)

VisitaPromotora

Visitas, vendas, kits, stock

Produto

Catálogo (EAN, nome, preço)

Loja

PDVs (nome, localização, status)

AcaoTrade

Ações promocionais, metas

Reabastecimento

Reposiciones de campo

PrecoSugerido

Preços sugeridos/concorrentes

Supervisor

Supervisores (região, lojas)

Teste Rápido (curl)

curl -X POST https://tradeflowstart.base44.app/functions/aiGateway \
  -H "X-API-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"empresa_id":"6abd7cd37d6876dfeb9f0607","mode":"discover"}'

Teste ao Vivo

Cola a API Key e testa o Gateway diretamente aqui — confirma que o Dotz consegue consultar a Promasidor Angola externamente.