---
title: "OpenAI Connector"
description: "Popoln vodnik za integracijo OpenAI za ustvarjanje vsebine z umetno inteligenco, vpoglede v stranke in inteligentno marketinško avtomatizacijo z Brevo prek Tajo."
url: https://tajo.io/sl/docs/connectors/custom/openai/
markdown: https://tajo.io/sl/docs/connectors/custom/openai.md
lang: sl-SI
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# OpenAI Connector

Stanje konektorja: Načrtovano Še ni izdelano. Tajo danes ne poganja tega konektorja.

| Izvorno polje | Ciljno polje | Vzorčna vrednost |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Poveži OpenAI z Brevo prek Tajo za ustvarjanje vsebine z umetno inteligenco, analizo sentimenta strank, inteligentno segmentacijo in napovedno analitiko za delovne tokove marketinške avtomatizacije.

## Pregled

| Lastnost | Vrednost |
| --- | --- |
| **Platforma** | OpenAI |
| **Kategorija** | UI / ML (po meri) |
| **Zahtevnost nastavitve** | Srednja |
| **Uradna integracija** | Ne |
| **Sinhronizirani podatki** | Vsebina, vdelava, vpogledi, napovedi |
| **Metoda avtentikacije** | API ključ (žeton prinosnika) |

## Funkcionalnosti

- **Ustvarjanje vsebine z UI** – ustvari zadeve e-mailov, besedilo in CTA z modeli GPT
- **Analiza sentimenta strank** – analiziraj zahtevke za podporo in povratne informacije za ocenjevanje sentimenta
- **Pametna segmentacija** – s pomočjo vdelav grupiraj stranke glede na vedenjske vzorce
- **Napovedna analitika** – napovej odliv, LTV in nagnjenost k nakupu
- **Večjezična vsebina** – ustvari marketinško vsebino v katerem koli podprtem jeziku
- **Ustvarjanje slik** – ustvari vizuale kampanj z integracijo DALL-E

## Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun OpenAI z dostopom do API
2. API ključ iz [nadzorne plošče OpenAI](https://platform.openai.com/api-keys)
3. Brevo račun z dostopom do API
4. Tajo račun z dovoljenji za konektorje
5. Zadostne kredite OpenAI API za pričakovano porabo

## Avtentikacija

### Avtentikacija z API ključem

OpenAI za vse zahtevke API uporablja avtentikacijo z žetonom prinosnika:

```bash
# Set your API keys
export OPENAI_API_KEY=sk-your-api-key
export TAJO_API_KEY=your_tajo_api_key
export BREVO_API_KEY=your_brevo_api_key
```

```javascript
// All requests require the Authorization header
const headers = {
  'Authorization': `Bearer ${process.env.OPENAI_API_KEY}`,
  'Content-Type': 'application/json'
};

// For organization-scoped access
const orgHeaders = {
  ...headers,
  'OpenAI-Organization': process.env.OPENAI_ORG_ID,
  'OpenAI-Project': process.env.OPENAI_PROJECT_ID
};
```

Varnost API ključa

Nikoli ne izpostavljaj API ključa OpenAI v kodi na strani odjemalca. Vedno uporabi spremenljivke okolja in zahtevke na strani strežnika. Periodično menjaj ključe prek nadzorne plošče OpenAI.

## Konfiguracija

### Osnovna nastavitev

```yaml
connectors:
  openai:
    enabled: true
    model: "gpt-4o"
    embedding_model: "text-embedding-3-small"
    image_model: "dall-e-3"

    features:
      content_generation: true
      sentiment_analysis: true
      smart_segmentation: true
      predictive_analytics: true

    limits:
      max_tokens_per_request: 4096
      max_requests_per_minute: 60
      temperature: 0.7
```

### Predloge za ustvarjanje vsebine

```yaml
templates:
  email_subject:
    model: "gpt-4o"
    system_prompt: |
      You are an expert email marketer. Generate compelling
      subject lines that drive open rates.
    max_tokens: 100
    temperature: 0.8

  email_body:
    model: "gpt-4o"
    system_prompt: |
      Generate personalized email content based on customer
      data and campaign objectives.
    max_tokens: 2048
    temperature: 0.7
```

## Končne točke API

| Končna točka | Metoda | Opis |
| --- | --- | --- |
| `https://api.openai.com/v1/responses` | POST | Ustvari odgovore UI (Responses API) |
| `https://api.openai.com/v1/chat/completions` | POST | Ustvari besedilne dopolnitve |
| `https://api.openai.com/v1/embeddings` | POST | Ustvari besedilne vdelave |
| `https://api.openai.com/v1/images/generations` | POST | Ustvari slike |
| `https://api.openai.com/v1/audio/speech` | POST | Pretvorba besedila v govor |
| `https://api.openai.com/v1/audio/transcriptions` | POST | Prepis govora v besedilo |
| `https://api.openai.com/v1/moderations` | POST | Moderacija vsebine |
| `https://api.openai.com/v1/models` | GET | Seznam razpoložljivih modelov |

## Primeri kode

### Inicializacija konektorja

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

await tajo.connectors.connect('openai', {
  apiKey: process.env.OPENAI_API_KEY,
  defaultModel: 'gpt-4o'
});
```

### Ustvarjanje vsebine e-maila

```javascript
// Generate personalized email subject lines
const response = await fetch('https://api.openai.com/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.OPENAI_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-4o',
    messages: [
      {
        role: 'system',
        content: 'Generate 5 compelling email subject lines for a product launch.'
      },
      {
        role: 'user',
        content: `Product: ${product.name}. Target: ${segment.description}.`
      }
    ],
    max_tokens: 200,
    temperature: 0.8
  })
});

const result = await response.json();
const subjectLines = result.choices[0].message.content;
```

### Analiza sentimenta strank

```javascript
// Analyze customer feedback sentiment
const sentimentAnalysis = await fetch(
  'https://api.openai.com/v1/chat/completions',
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.OPENAI_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model: 'gpt-4o',
      messages: [
        {
          role: 'system',
          content: 'Analyze sentiment. Return JSON: {score: -1 to 1, label: string, topics: string[]}'
        },
        { role: 'user', content: customerFeedback }
      ],
      response_format: { type: 'json_object' },
      max_tokens: 150
    })
  }
);

const sentiment = await sentimentAnalysis.json();
await tajo.contacts.update(email, {
  attributes: { SENTIMENT_SCORE: JSON.parse(sentiment.choices[0].message.content).score }
});
```

### Pametna segmentacija z vdelavami

```javascript
// Generate embeddings for customer clustering
const embeddingResponse = await fetch(
  'https://api.openai.com/v1/embeddings',
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.OPENAI_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model: 'text-embedding-3-small',
      input: customerDescriptions,
      dimensions: 256
    })
  }
);

const embeddings = await embeddingResponse.json();
// Use embeddings for similarity-based customer clustering
```

## Omejitve hitrosti

| Model | RPM (zahtevki/min) | TPM (žetoni/min) | RPD (zahtevki/dan) |
| --- | --- | --- | --- |
| gpt-4o | 500 | 30.000 | 10.000 |
| gpt-4o-mini | 500 | 200.000 | 10.000 |
| text-embedding-3-small | 500 | 1.000.000 | 10.000 |
| dall-e-3 | 5 | Ni ustrezno | 200 |

Glave omejitev hitrosti

V odgovorih API spremljaj glave omejitev hitrosti (`x-ratelimit-remaining-requests`, `x-ratelimit-remaining-tokens`) za implementacijo proaktivnega omejevanja in izogibanje napakam 429.

## Odpravljanje težav

| Težava | Vzrok | Rešitev |
| --- | --- | --- |
| 401 Unauthorized | Neveljaven API ključ | Potrdi ključ v nadzorni plošči OpenAI |
| 429 Rate Limited | Preveč zahtevkov | Implementiraj eksponentni odlog |
| 500 Server Error | Izpad OpenAI | Preveri status.openai.com in ponovi |
| Okrnjen odgovor | max\_tokens prenizek | Povečaj parameter max\_tokens |
| Slaba kakovost vsebine | Temperatura previsoka | Znižaj temperaturo za doslednost |

### Način odpravljanja napak

```yaml
connectors:
  openai:
    debug: true
    log_level: verbose
    log_prompts: false  # Don't log prompts in production
    log_usage: true
```

## Najboljše prakse

1. **Predpomni odgovore** – shrani ustvarjeno vsebino za zmanjšanje klicev API in stroškov
2. **Uporabi strukturirane izhode** – zahtevaj odgovore JSON za zanesljivo razčlenjevanje
3. **Implementiraj logiko ponovnih poskusov** – obravnavaj omejitve hitrosti z eksponentnim odlogom
4. **Spremljaj porabo žetonov** – sledi porabi za nadzor stroškov
5. **Uporabi ustrezne modele** – za enostavne naloge gpt-4o-mini, za kompleksne gpt-4o
6. **Potrdi izhode** – vedno potrdi vsebino, ustvarjeno z UI, preden jo pošlješ strankam

## Varnost

- **Avtentikacija z žetonom prinosnika** – API ključi se prenašajo prek glave Authorization
- **Samo na strani strežnika** – nikoli ne izpostavljaj API ključev v kodi na strani odjemalca
- **Rotacija ključev** – API ključe redno menjaj prek nadzorne plošče OpenAI
- **Spremljanje porabe** – nastavi omejitve porabe v nastavitvah zaračunavanja OpenAI
- **Moderacija vsebine** – za filtriranje nevarne vsebine uporabi Moderations API
- **Zasebnost podatkov** – preglej pravilnike o uporabi podatkov OpenAI za svojo uporabo

## Povezani viri

- [Brevo Connector](https://tajo.io/sl/docs/connectors/marketing/brevo)
- [Customer Sync Skill](https://tajo.io/sl/docs/skills/data-sync/customer-sync)
- [Email Marketing Skills](https://tajo.io/sl/docs/skills/email-marketing)
- [OpenAI API referenca](https://platform.openai.com/docs/api-reference)