Conector OpenAI

Conectați OpenAI la Brevo prin Tajo pentru a valorifica generarea de conținut cu ajutorul AI, analiza sentimentelor clienților, segmentarea inteligentă și analiza predictivă pentru fluxurile de automatizare de marketing.

Prezentare generală

ProprietateValoare
PlatformăOpenAI
CategorieAI / ML (Personalizat)
Complexitate configurareMedie
Integrare oficialăNu
Date sincronizateConținut, Embedding-uri, Informații, Predicții
Metodă de autentificareCheie API (Token Bearer)

Funcționalități

  • Generare conținut AI - Generați linii de subiect pentru e-mail, text și CTA-uri cu modelele GPT
  • Analiza sentimentelor clienților - Analizați tichetele de suport și feedback-ul pentru scorarea sentimentelor
  • Segmentare inteligentă - Utilizați embedding-uri pentru a grupa clienții după tipare de comportament
  • Analitica predictivă - Previzionați churn-ul, LTV și propensitatea de achiziție
  • Conținut în mai multe limbi - Generați conținut de marketing în orice limbă suportată
  • Generare imagini - Creați imagini pentru campanii cu integrarea DALL-E

Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

  1. Un cont OpenAI cu acces API
  2. O cheie API din tabloul de bord OpenAI
  3. Un cont Brevo cu acces API
  4. Un cont Tajo cu permisiuni de conector
  5. Credite API OpenAI suficiente pentru utilizarea preconizată

Autentificare

Autentificare cu cheie API

OpenAI utilizează autentificarea cu token Bearer pentru toate cererile API:

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

Securitate cheie API

Nu expuneți niciodată cheia API OpenAI în codul client. Utilizați întotdeauna variabile de mediu și cereri pe server. Rotiți cheile periodic prin tabloul de bord OpenAI.

Configurare

Configurare de bază

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

Șabloane de generare conținut

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

Puncte finale API

Punct finalMetodăDescriere
https://api.openai.com/v1/responsesPOSTCreează răspunsuri AI (Responses API)
https://api.openai.com/v1/chat/completionsPOSTGenerează completări de text
https://api.openai.com/v1/embeddingsPOSTCreează embedding-uri de text
https://api.openai.com/v1/images/generationsPOSTGenerează imagini
https://api.openai.com/v1/audio/speechPOSTGenerare text-to-speech
https://api.openai.com/v1/audio/transcriptionsPOSTTranscriere speech-to-text
https://api.openai.com/v1/moderationsPOSTModerare conținut
https://api.openai.com/v1/modelsGETListează modelele disponibile

Exemple de cod

Inițializare conector

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

Generare conținut e-mail

// 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 sentimentelor clienților

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

Segmentare inteligentă cu embedding-uri

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

Limite de rată

ModelRPM (Cereri/Min)TPM (Token-uri/Min)RPD (Cereri/Zi)
gpt-4o50030.00010.000
gpt-4o-mini500200.00010.000
text-embedding-3-small5001.000.00010.000
dall-e-35N/A200

Anteturi limite de rată

Monitorizați anteturile limitelor de rată (x-ratelimit-remaining-requests, x-ratelimit-remaining-tokens) în răspunsurile API pentru a implementa limitarea proactivă și a evita erorile 429.

Depanare

ProblemăCauzăSoluție
401 NeautorizatCheie API invalidăVerificați cheia în tabloul de bord OpenAI
429 Limită de ratăPrea multe cereriImplementați backoff exponențial
500 Eroare serverÎntrerupere OpenAIVerificați status.openai.com și reîncercați
Răspuns trunchiatmax_tokens prea micCreșteți parametrul max_tokens
Calitate conținut slabăTemperatură prea mareReduceți temperatura pentru consistență

Modul de depanare

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

Bune practici

  1. Stocați în cache răspunsurile - Salvați conținutul generat pentru a reduce apelurile API și costurile
  2. Utilizați ieșiri structurate - Solicitați răspunsuri JSON pentru parsare fiabilă
  3. Implementați logica de reîncercare - Gestionați limitele de rată cu backoff exponențial
  4. Monitorizați utilizarea token-urilor - Urmăriți consumul pentru a controla costurile
  5. Utilizați modelele potrivite - Utilizați gpt-4o-mini pentru sarcini simple, gpt-4o pentru cele complexe
  6. Validați ieșirile - Validați întotdeauna conținutul generat de AI înainte de a-l trimite clienților

Securitate

  • Autentificare cu token Bearer - Chei API transmise prin antetul Authorization
  • Numai pe server - Nu expuneți niciodată cheile API în codul client
  • Rotație chei - Rotiți cheile API regulat prin tabloul de bord OpenAI
  • Monitorizare utilizare - Setați limite de cheltuieli în setările de facturare OpenAI
  • Moderare conținut - Utilizați Moderations API pentru a filtra conținut nesigur
  • Confidențialitate date - Revizuiți politicile de utilizare a datelor OpenAI pentru cazul dvs.

Resurse conexe

Subscribe to updates

developer-docs

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

auto-detect
Asistent AI

Bună! Întreabă-mă orice despre documentație.