OpenAI Bağlayıcısı

Pazarlama otomasyonu iş akışlarınız için yapay zeka destekli içerik oluşturma, müşteri duygu analizi, akıllı segmentasyon ve öngörücü analitikten yararlanmak üzere OpenAI’yi Tajo üzerinden Brevo’ya bağlayın.

Genel Bakış

ÖzellikDeğer
PlatformOpenAI
KategoriYapay Zeka / ML (Özel)
Kurulum KarmaşıklığıOrta
Resmi EntegrasyonHayır
Senkronize Edilen Veriİçerik, Gömüler, Öngörüler, Tahminler
Kimlik Doğrulama YöntemiAPI Anahtarı (Bearer Belirteci)

Özellikler

  • Yapay zeka içerik oluşturma - GPT modelleriyle e-posta konu satırları, gövde metni ve CTA’lar oluşturun
  • Müşteri duygu analizi - Duygu puanlaması için destek biletlerini ve geri bildirimleri analiz edin
  • Akıllı segmentasyon - Müşterileri davranış kalıplarına göre kümelemek için gömüleri kullanın
  • Öngörücü analitik - Kayıp, LTV ve satın alma eğilimini tahmin edin
  • Çok dilli içerik - Desteklenen herhangi bir dilde pazarlama içeriği oluşturun
  • Görsel oluşturma - DALL-E entegrasyonuyla kampanya görselleri oluşturun

Ön Koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

  1. API erişimi olan bir OpenAI hesabı
  2. OpenAI panelinden bir API anahtarı
  3. API erişimi olan bir Brevo hesabı
  4. Bağlayıcı izinlerine sahip bir Tajo hesabı
  5. Beklenen kullanımınız için yeterli OpenAI API kredisi

Kimlik Doğrulama

API Anahtarı Kimlik Doğrulaması

OpenAI, tüm API istekleri için Bearer belirteç kimlik doğrulaması kullanır:

Terminal window
# API anahtarlarınızı ayarlayın
export OPENAI_API_KEY=sk-your-api-key
export TAJO_API_KEY=your_tajo_api_key
export BREVO_API_KEY=your_brevo_api_key
// Tüm istekler Authorization başlığını gerektirir
const headers = {
'Authorization': `Bearer ${process.env.OPENAI_API_KEY}`,
'Content-Type': 'application/json'
};
// Kuruluş kapsamlı erişim için
const orgHeaders = {
...headers,
'OpenAI-Organization': process.env.OPENAI_ORG_ID,
'OpenAI-Project': process.env.OPENAI_PROJECT_ID
};

API Anahtarı Güvenliği

OpenAI API anahtarınızı asla istemci tarafı kodda ifşa etmeyin. Her zaman ortam değişkenlerini ve sunucu tarafı isteklerini kullanın. OpenAI paneli üzerinden anahtarları periyodik olarak döndürün.

Yapılandırma

Temel Kurulum

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

İçerik Oluşturma Şablonları

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 Uç Noktaları

Uç NoktaYöntemAçıklama
https://api.openai.com/v1/responsesPOSTYapay zeka yanıtları oluştur (Responses API)
https://api.openai.com/v1/chat/completionsPOSTMetin tamamlamaları oluştur
https://api.openai.com/v1/embeddingsPOSTMetin gömüleri oluştur
https://api.openai.com/v1/images/generationsPOSTGörseller oluştur
https://api.openai.com/v1/audio/speechPOSTMetinden sese oluşturma
https://api.openai.com/v1/audio/transcriptionsPOSTKonuşmadan metne dönüştürme
https://api.openai.com/v1/moderationsPOSTİçerik denetleme
https://api.openai.com/v1/modelsGETMevcut modelleri listele

Kod Örnekleri

Bağlayıcıyı Başlatma

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-posta İçeriği Oluşturma

// Kişiselleştirilmiş e-posta konu satırları oluştur
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;

Müşteri Duygu Analizi

// Müşteri geri bildirim duygusunu analiz et
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 }
});

Gömülerle Akıllı Segmentasyon

// Müşteri kümeleme için gömüler oluştur
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();
// Benzerlik tabanlı müşteri kümelemesi için gömüleri kullan

Hız Sınırları

ModelRPM (İstek/Dk)TPM (Belirteç/Dk)RPD (İstek/Gün)
gpt-4o50030.00010.000
gpt-4o-mini500200.00010.000
text-embedding-3-small5001.000.00010.000
dall-e-35Yok200

Hız Sınırı Başlıkları

Proaktif kısıtlama uygulamak ve 429 hatalarını önlemek için API yanıtlarındaki hız sınırı başlıklarını (x-ratelimit-remaining-requests, x-ratelimit-remaining-tokens) izleyin.

Sorun Giderme

SorunNedenÇözüm
401 UnauthorizedGeçersiz API anahtarıAnahtarı OpenAI panelinde doğrulayın
429 Rate LimitedÇok fazla istekÜstel geri çekilme uygulayın
500 Server ErrorOpenAI kesintisistatus.openai.com’u kontrol edin ve yeniden deneyin
Kesilmiş yanıtmax_tokens çok düşükmax_tokens parametresini artırın
Düşük içerik kalitesiSıcaklık çok yüksekTutarlılık için sıcaklığı düşürün

Hata Ayıklama Modu

connectors:
openai:
debug: true
log_level: verbose
log_prompts: false # Üretimde komut istemlerini günlüğe kaydetmeyin
log_usage: true

En İyi Uygulamalar

  1. Yanıtları önbelleğe alın - API çağrılarını ve maliyetleri azaltmak için oluşturulan içeriği saklayın
  2. Yapılandırılmış çıktıları kullanın - Güvenilir ayrıştırma için JSON yanıtları isteyin
  3. Yeniden deneme mantığı uygulayın - Hız sınırlarını üstel geri çekilme ile yönetin
  4. Belirteç kullanımını izleyin - Maliyetleri kontrol etmek için tüketimi izleyin
  5. Uygun modelleri kullanın - Basit görevler için gpt-4o-mini, karmaşık olanlar için gpt-4o kullanın
  6. Çıktıları doğrulayın - Yapay zeka ile oluşturulan içeriği müşterilere göndermeden önce her zaman doğrulayın

Güvenlik

  • Bearer belirteç kimlik doğrulaması - API anahtarları Authorization başlığı aracılığıyla iletilir
  • Yalnızca sunucu tarafı - API anahtarlarını asla istemci tarafı kodda ifşa etmeyin
  • Anahtar rotasyonu - OpenAI paneli aracılığıyla API anahtarlarını düzenli olarak döndürün
  • Kullanım izleme - OpenAI faturalandırma ayarlarında harcama sınırları belirleyin
  • İçerik denetleme - Güvensiz içeriği filtrelemek için Moderations API’sini kullanın
  • Veri gizliliği - Kullanım durumunuz için OpenAI’nin veri kullanım politikalarını inceleyin

İlgili Kaynaklar

Subscribe to updates

developer-docs

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

auto-detect
AI Asistan

Merhaba! Belgeler hakkında her şeyi sorabilirsiniz.