OpenAI konnektor

Csatlakoztasd az OpenAI-t a Brevóhoz a Tajo segítségével, hogy AI alapú tartalom-generálást, ügyfél hangulatelemzést, intelligens szegmentálást és prediktív analitikát használj a marketingautomatizálási munkafolyamataidhoz.

Áttekintés

TulajdonságÉrték
PlatformOpenAI
KategóriaAI / ML (Egyéni)
Telepítés bonyolultságaKözepes
Hivatalos integrációNem
Szinkronizált adatokTartalom, Embeddingek, Insightok, Predikciók
Hitelesítési módszerAPI kulcs (Bearer Token)

Funkciók

  • AI tartalom-generálás – E-mail tárgysorok, törzsszöveg és CTA-k generálása GPT modellekkel
  • Ügyfél hangulatelemzés – Support jegyek és visszajelzések elemzése hangulatpontozáshoz
  • Intelligens szegmentálás – Embeddingek használata ügyfelek viselkedési minták szerinti klaszterezéséhez
  • Prediktív analitika – Lemorzsolódás, LTV és vásárlási hajlandóság előrejelzése
  • Többnyelvű tartalom – Marketing tartalom generálása bármely támogatott nyelven
  • Képgenerálás – Kampányvizuálok létrehozása DALL-E integrációval

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

  1. Egy OpenAI fiókkal API-hozzáféréssel
  2. Egy API kulccsal az OpenAI dashboardról
  3. Egy Brevo fiókkal API-hozzáféréssel
  4. Egy Tajo fiókkal konnektor engedélyekkel
  5. Elegendő OpenAI API kredittel a várható használathoz

Hitelesítés

API kulcs hitelesítés

Az OpenAI Bearer token hitelesítést használ minden API kéréshez:

Terminal window
# 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
// 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
};

API kulcs biztonság

Soha ne tedd ki az OpenAI API kulcsodat kliens oldali kódban. Mindig használj környezeti változókat és szerver oldali kéréseket. Forgasd a kulcsokat rendszeresen az OpenAI dashboardon keresztül.

Konfiguráció

Alapbeállítás

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

Tartalom-generálási sablonok

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

API végpontok

VégpontMódszerLeírás
https://api.openai.com/v1/responsesPOSTAI válaszok létrehozása (Responses API)
https://api.openai.com/v1/chat/completionsPOSTSzöveg-kiegészítések generálása
https://api.openai.com/v1/embeddingsPOSTSzöveg-embeddingek létrehozása
https://api.openai.com/v1/images/generationsPOSTKépek generálása
https://api.openai.com/v1/audio/speechPOSTSzövegből hang generálása
https://api.openai.com/v1/audio/transcriptionsPOSTHangból szöveg átírása
https://api.openai.com/v1/moderationsPOSTTartalom-moderáció
https://api.openai.com/v1/modelsGETElérhető modellek listázása

Kódpéldák

A konnektor inicializálása

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'
});

E-mail tartalom generálása

// 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;

Ügyfél hangulatelemzés

// 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 }
});

Intelligens szegmentálás embeddingekkel

// 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

Ráta-korlátok

ModellRPM (Kérés/perc)TPM (Token/perc)RPD (Kérés/nap)
gpt-4o50030 00010 000
gpt-4o-mini500200 00010 000
text-embedding-3-small5001 000 00010 000
dall-e-35N/A200

Ráta-korlát fejlécek

Figyeld a ráta-korlát fejléceket (x-ratelimit-remaining-requests, x-ratelimit-remaining-tokens) az API válaszokban, hogy proaktív korlátozást implementálj és elkerüld a 429 hibákat.

Hibaelhárítás

ProblémaOkMegoldás
401 UnauthorizedÉrvénytelen API kulcsEllenőrizd a kulcsot az OpenAI dashboardon
429 Rate LimitedTúl sok kérésImplementálj exponenciális visszalépést
500 Server ErrorOpenAI kiesésEllenőrizd a status.openai.com oldalt és próbálkozz újra
Csonkított válaszmax_tokens túl alacsonyNöveld a max_tokens paramétert
Gyenge tartalom minőségHőmérséklet túl magasCsökkentsd a hőmérsékletet a konzisztenciáért

Hibakeresési mód

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

Legjobb gyakorlatok

  1. Gyorsítótárazz válaszokat – Tárold a generált tartalmat az API hívások és költségek csökkentéséhez
  2. Használj strukturált kimeneteket – Kérj JSON válaszokat a megbízható elemzéshez
  3. Implementálj újrapróbálkozási logikát – Kezelj ráta-korlátokat exponenciális visszalépéssel
  4. Figyeld a token-használatot – Kövesd a fogyasztást a költségek ellenőrzéséhez
  5. Használj megfelelő modelleket – Egyszerű feladatokhoz a gpt-4o-mini-t, összetettekhez a gpt-4o-t
  6. Validáld a kimeneteket – Mindig ellenőrizd az AI által generált tartalmat, mielőtt az ügyfelekhez küldöd

Biztonság

  • Bearer token hitelesítés – Az API kulcsok az Authorization fejlécen keresztül kerülnek átvitelre
  • Csak szerver oldali – Soha ne tedd ki az API kulcsokat kliens oldali kódban
  • Kulcs rotáció – Forgasd rendszeresen az API kulcsokat az OpenAI dashboardon
  • Használat figyelése – Állíts be költségkorlátokat az OpenAI számlázási beállításokban
  • Tartalom-moderáció – Használd a Moderations API-t a nem biztonságos tartalom szűréséhez
  • Adatvédelem – Tekintsd át az OpenAI adathasználati irányelveit az adott felhasználási esetre

Kapcsolódó források

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
AI asszisztens

Szia! Kérdezz bármit a dokumentációról.