Σύνδεσμος OpenAI
Συνδέστε το OpenAI με το Brevo μέσω Tajo για αξιοποίηση δημιουργίας περιεχομένου βάσει AI, ανάλυσης συναισθημάτων πελατών, ευφυούς τμηματοποίησης και προβλεπτικών αναλυτικών για τις ροές εργασίας αυτοματοποίησης marketing σας.
Επισκόπηση
| Ιδιότητα | Τιμή |
|---|---|
| Πλατφόρμα | OpenAI |
| Κατηγορία | AI / ML (Προσαρμοσμένο) |
| Πολυπλοκότητα Ρύθμισης | Μεσαία |
| Επίσημη Ενσωμάτωση | Όχι |
| Δεδομένα που Συγχρονίζονται | Περιεχόμενο, Embeddings, Πληροφορίες, Προβλέψεις |
| Μέθοδος Πιστοποίησης | API Key (Bearer Token) |
Χαρακτηριστικά
- Δημιουργία περιεχομένου AI - Δημιουργία θεματικών γραμμών email, σώματος κειμένου και CTAs με μοντέλα GPT
- Ανάλυση συναισθημάτων πελατών - Ανάλυση αιτημάτων υποστήριξης και ανατροφοδότησης για βαθμολόγηση συναισθημάτων
- Ευφυής τμηματοποίηση - Χρήση embeddings για ομαδοποίηση πελατών βάσει μοτίβων συμπεριφοράς
- Προβλεπτικά αναλυτικά - Πρόβλεψη αποχώρησης, LTV και τάσης αγοράς
- Περιεχόμενο πολλαπλών γλωσσών - Δημιουργία marketing περιεχομένου σε οποιαδήποτε υποστηριζόμενη γλώσσα
- Δημιουργία εικόνων - Δημιουργία οπτικών στοιχείων καμπάνιας με ενσωμάτωση DALL-E
Προαπαιτούμενα
Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:
- Λογαριασμό OpenAI με πρόσβαση API
- API key από τον πίνακα OpenAI
- Λογαριασμό Brevo με πρόσβαση API
- Λογαριασμό Tajo με δικαιώματα συνδέσμου
- Επαρκείς πιστώσεις OpenAI API για την αναμενόμενη χρήση σας
Πιστοποίηση
Πιστοποίηση με API Key
Το OpenAI χρησιμοποιεί πιστοποίηση Bearer token για όλα τα αιτήματα API:
# 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
Μην εκθέτετε ποτέ το κλειδί API OpenAI σε κώδικα πλευράς client. Χρησιμοποιείτε πάντα μεταβλητές περιβάλλοντος και αιτήματα πλευράς server. Εναλλάσσετε κλειδιά περιοδικά μέσω του πίνακα OpenAI.
Διαμόρφωση
Βασική Ρύθμιση
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Πρότυπα Δημιουργίας Περιεχομένου
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.7Endpoints API
| Endpoint | Μέθοδος | Περιγραφή |
|---|---|---|
https://api.openai.com/v1/responses | POST | Δημιουργία αποκρίσεων AI (Responses API) |
https://api.openai.com/v1/chat/completions | POST | Δημιουργία κειμενικών συμπληρώσεων |
https://api.openai.com/v1/embeddings | POST | Δημιουργία embeddings κειμένου |
https://api.openai.com/v1/images/generations | POST | Δημιουργία εικόνων |
https://api.openai.com/v1/audio/speech | POST | Δημιουργία ομιλίας από κείμενο |
https://api.openai.com/v1/audio/transcriptions | POST | Μεταγραφή ομιλίας σε κείμενο |
https://api.openai.com/v1/moderations | POST | Έλεγχος περιεχομένου |
https://api.openai.com/v1/models | GET | Λίστα διαθέσιμων μοντέλων |
Παραδείγματα Κώδικα
Αρχικοποίηση Συνδέσμου
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'});Δημιουργία Περιεχομένου Email
// 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;Ανάλυση Συναισθημάτων Πελατών
// 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 }});Ευφυής Τμηματοποίηση με Embeddings
// 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 clusteringΌρια Ρυθμού
| Μοντέλο | RPM (Αιτήματα/Λεπτό) | TPM (Tokens/Λεπτό) | RPD (Αιτήματα/Ημέρα) |
|---|---|---|---|
| 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 | Δ/Ε | 200 |
Headers Ορίου Ρυθμού
Παρακολουθήστε headers ορίου ρυθμού (x-ratelimit-remaining-requests, x-ratelimit-remaining-tokens) στις αποκρίσεις API για προληπτικό περιορισμό ρυθμού και αποφυγή σφαλμάτων 429.
Αντιμετώπιση Προβλημάτων
| Πρόβλημα | Αιτία | Λύση |
|---|---|---|
| 401 Unauthorized | Μη έγκυρο API key | Επαληθεύστε κλειδί στον πίνακα OpenAI |
| 429 Rate Limited | Υπερβολικά πολλά αιτήματα | Εφαρμόστε εκθετική καθυστέρηση |
| 500 Server Error | Βλάβη OpenAI | Ελέγξτε status.openai.com και επαναλάβετε |
| Περικοπή απόκρισης | Πολύ χαμηλό max_tokens | Αυξήστε την παράμετρο max_tokens |
| Κακή ποιότητα περιεχομένου | Υπερβολικά υψηλή θερμοκρασία | Μειώστε τη θερμοκρασία για συνέπεια |
Λειτουργία Εντοπισμού Σφαλμάτων
connectors: openai: debug: true log_level: verbose log_prompts: false # Don't log prompts in production log_usage: trueΒέλτιστες Πρακτικές
- Αποθηκεύστε αποκρίσεις στη cache - Αποθηκεύστε παραγόμενο περιεχόμενο για μείωση κλήσεων API και κόστους
- Χρησιμοποιήστε δομημένες εξόδους - Ζητήστε αποκρίσεις JSON για αξιόπιστη ανάλυση
- Εφαρμόστε λογική επανάληψης - Χειριστείτε όρια ρυθμού με εκθετική καθυστέρηση
- Παρακολουθήστε χρήση tokens - Παρακολουθήστε κατανάλωση για έλεγχο κόστους
- Χρησιμοποιήστε κατάλληλα μοντέλα - Χρησιμοποιήστε gpt-4o-mini για απλές εργασίες, gpt-4o για σύνθετες
- Επικυρώστε εξόδους - Επικυρώνετε πάντα περιεχόμενο παραγόμενο από AI πριν την αποστολή σε πελάτες
Ασφάλεια
- Πιστοποίηση Bearer token - Τα API keys μεταδίδονται μέσω header Authorization
- Μόνο πλευρά server - Μην εκθέτετε ποτέ API keys σε κώδικα πλευράς client
- Εναλλαγή κλειδιών - Εναλλάσσετε API keys τακτικά μέσω πίνακα OpenAI
- Παρακολούθηση χρήσης - Ορίστε όρια δαπανών στις ρυθμίσεις χρέωσης OpenAI
- Έλεγχος περιεχομένου - Χρησιμοποιήστε Moderations API για φιλτράρισμα μη ασφαλούς περιεχομένου
- Απόρρητο δεδομένων - Ανατρέξτε στις πολιτικές χρήσης δεδομένων OpenAI για την περίπτωση χρήσης σας