موصل OpenAI

اربط OpenAI بـ Brevo من خلال Tajo للاستفادة من توليد المحتوى بالذكاء الاصطناعي، وتحليل مشاعر العملاء، والتقسيم الذكي، والتحليلات التنبؤية لسير عمل أتمتة التسويق الخاص بك.

نظرة عامة

الخاصيةالقيمة
المنصةOpenAI
الفئةالذكاء الاصطناعي / التعلم الآلي (مخصص)
تعقيد الإعدادمتوسط
تكامل رسميلا
البيانات المُزامَنةمحتوى، تضمينات، رؤى، تنبؤات
طريقة المصادقةمفتاح API (Bearer Token)

الميزات

  • توليد المحتوى بالذكاء الاصطناعي - توليد عناوين الرسائل، ونصوص الجسم، وأزرار الحث على الإجراء باستخدام نماذج GPT
  • تحليل مشاعر العملاء - تحليل تذاكر الدعم والتعليقات لتقييم المشاعر
  • التقسيم الذكي - استخدام التضمينات لتجميع العملاء حسب أنماط السلوك
  • التحليلات التنبؤية - التنبؤ بمعدل الفقد، والقيمة الدائمة، واحتمال الشراء
  • محتوى متعدد اللغات - توليد محتوى تسويقي بأي لغة مدعومة
  • توليد الصور - إنشاء مرئيات الحملات عبر تكامل DALL-E

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

  1. حساب OpenAI مع وصول إلى API
  2. مفتاح API من لوحة تحكم OpenAI
  3. حساب Brevo مع وصول إلى API
  4. حساب Tajo مع صلاحيات الموصلات
  5. رصيد كافٍ في OpenAI API لاستخدامك المتوقع

المصادقة

مصادقة مفتاح API

يستخدم OpenAI مصادقة Bearer token لجميع طلبات 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
};

أمان مفتاح API

لا تكشف أبدًا عن مفتاح OpenAI API الخاص بك في الكود من جانب العميل. استخدم دائمًا متغيرات البيئة والطلبات من جانب الخادم. قم بتدوير المفاتيح دوريًا عبر لوحة تحكم 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.7

نقاط نهاية واجهة البرمجة

نقطة النهايةالطريقةالوصف
https://api.openai.com/v1/responsesPOSTإنشاء استجابات الذكاء الاصطناعي (Responses API)
https://api.openai.com/v1/chat/completionsPOSTتوليد إكمالات النصوص
https://api.openai.com/v1/embeddingsPOSTإنشاء تضمينات النصوص
https://api.openai.com/v1/images/generationsPOSTتوليد الصور
https://api.openai.com/v1/audio/speechPOSTتوليد النص إلى كلام
https://api.openai.com/v1/audio/transcriptionsPOSTتحويل الكلام إلى نص
https://api.openai.com/v1/moderationsPOSTالإشراف على المحتوى
https://api.openai.com/v1/modelsGETقائمة النماذج المتاحة

أمثلة على الكود

تهيئة الموصل

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

توليد محتوى البريد الإلكتروني

// توليد عناوين بريد إلكتروني مخصصة
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;

تحليل مشاعر العملاء

// تحليل مشاعر تعليقات العملاء
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 }
});

التقسيم الذكي بالتضمينات

// توليد التضمينات لتجميع العملاء
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();
// استخدام التضمينات لتجميع العملاء القائم على التشابه

حدود المعدل

النموذجRPM (طلبات/دقيقة)TPM (رموز/دقيقة)RPD (طلبات/يوم)
gpt-4o50030,00010,000
gpt-4o-mini500200,00010,000
text-embedding-3-small5001,000,00010,000
dall-e-35لا ينطبق200

ترويسات حدود المعدل

راقب ترويسات حدود المعدل (x-ratelimit-remaining-requests، x-ratelimit-remaining-tokens) في استجابات API لتطبيق التقييد الاستباقي وتجنب أخطاء 429.

استكشاف الأخطاء وإصلاحها

المشكلةالسببالحل
401 Unauthorizedمفتاح API غير صالحتحقق من المفتاح في لوحة تحكم OpenAI
429 Rate Limitedطلبات كثيرة جدًاطبّق التراجع الأُسّي
500 Server Errorانقطاع خدمة OpenAIراجع status.openai.com وأعد المحاولة
استجابة مقطوعةmax_tokens منخفض جدًازد معامل max_tokens
جودة محتوى ضعيفةtemperature مرتفعة جدًااخفض temperature للاتساق

وضع التصحيح

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

أفضل الممارسات

  1. تخزين الاستجابات مؤقتًا - خزّن المحتوى المولَّد لتقليل استدعاءات API والتكاليف
  2. استخدام المخرجات المُنظَّمة - اطلب استجابات JSON للتحليل الموثوق
  3. تطبيق منطق إعادة المحاولة - تعامل مع حدود المعدل عبر التراجع الأُسّي
  4. مراقبة استخدام الرموز - تتبع الاستهلاك للتحكم في التكاليف
  5. استخدام النماذج المناسبة - استخدم gpt-4o-mini للمهام البسيطة، وgpt-4o للمعقدة
  6. التحقق من المخرجات - تحقق دائمًا من المحتوى المولَّد قبل إرساله للعملاء

الأمان

  • مصادقة Bearer token - مفاتيح API تُرسل عبر ترويسة Authorization
  • من جانب الخادم فقط - لا تكشف أبدًا عن مفاتيح API في الكود من جانب العميل
  • تدوير المفاتيح - دوّر مفاتيح API بانتظام عبر لوحة تحكم OpenAI
  • مراقبة الاستخدام - حدد حدود الإنفاق في إعدادات فوترة OpenAI
  • الإشراف على المحتوى - استخدم واجهة Moderations API لتصفية المحتوى غير الآمن
  • خصوصية البيانات - راجع سياسات استخدام البيانات الخاصة بـ OpenAI لحالة استخدامك

موارد ذات صلة

Subscribe to updates

developer-docs

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

auto-detect
مساعد AI

مرحباً! اسألني أي شيء عن الوثائق.