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 |
|---|---|
| Platform | OpenAI |
| Kategória | AI / ML (Egyéni) |
| Telepítés bonyolultsága | Közepes |
| Hivatalos integráció | Nem |
| Szinkronizált adatok | Tartalom, Embeddingek, Insightok, Predikciók |
| Hitelesítési módszer | API 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:
- Egy OpenAI fiókkal API-hozzáféréssel
- Egy API kulccsal az OpenAI dashboardról
- Egy Brevo fiókkal API-hozzáféréssel
- Egy Tajo fiókkal konnektor engedélyekkel
- 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:
# Set your API keysexport OPENAI_API_KEY=sk-your-api-keyexport TAJO_API_KEY=your_tajo_api_keyexport BREVO_API_KEY=your_brevo_api_key// All requests require the Authorization headerconst headers = { 'Authorization': `Bearer ${process.env.OPENAI_API_KEY}`, 'Content-Type': 'application/json'};
// For organization-scoped accessconst 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.7Tartalom-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.7API végpontok
| Végpont | Módszer | Leírás |
|---|---|---|
https://api.openai.com/v1/responses | POST | AI válaszok létrehozása (Responses API) |
https://api.openai.com/v1/chat/completions | POST | Szöveg-kiegészítések generálása |
https://api.openai.com/v1/embeddings | POST | Szöveg-embeddingek létrehozása |
https://api.openai.com/v1/images/generations | POST | Képek generálása |
https://api.openai.com/v1/audio/speech | POST | Szövegből hang generálása |
https://api.openai.com/v1/audio/transcriptions | POST | Hangból szöveg átírása |
https://api.openai.com/v1/moderations | POST | Tartalom-moderáció |
https://api.openai.com/v1/models | GET | Elé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 linesconst 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 sentimentconst 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 clusteringconst 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 clusteringRáta-korlátok
| Modell | RPM (Kérés/perc) | TPM (Token/perc) | RPD (Kérés/nap) |
|---|---|---|---|
| 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 | N/A | 200 |
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éma | Ok | Megoldás |
|---|---|---|
| 401 Unauthorized | Érvénytelen API kulcs | Ellenőrizd a kulcsot az OpenAI dashboardon |
| 429 Rate Limited | Túl sok kérés | Implementálj exponenciális visszalépést |
| 500 Server Error | OpenAI kiesés | Ellenőrizd a status.openai.com oldalt és próbálkozz újra |
| Csonkított válasz | max_tokens túl alacsony | Növeld a max_tokens paramétert |
| Gyenge tartalom minőség | Hőmérséklet túl magas | Csö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: trueLegjobb gyakorlatok
- 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
- Használj strukturált kimeneteket – Kérj JSON válaszokat a megbízható elemzéshez
- Implementálj újrapróbálkozási logikát – Kezelj ráta-korlátokat exponenciális visszalépéssel
- Figyeld a token-használatot – Kövesd a fogyasztást a költségek ellenőrzéséhez
- Használj megfelelő modelleket – Egyszerű feladatokhoz a gpt-4o-mini-t, összetettekhez a gpt-4o-t
- 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