البدء

أنشئ صندوق بريد وأرسل أول بريد إلكتروني من وكيل ذكاء اصطناعي في أقل من دقيقة.

نظرة عامة

AgentSend هو بنية تحتية للبريد الإلكتروني مبنية خصيصاً لوكلاء الذكاء الاصطناعي. يمنح كل وكيل صندوق بريد خاصاً به مع عنوان بريد إلكتروني حقيقي، بحيث يمكن لوكلائك إرسال واستقبال وإدارة محادثات البريد الإلكتروني برمجياً.

استخدم AgentSend لبناء وكلاء يتولون دعم العملاء والتواصل التجاري وجدولة المواعيد والأبحاث وأي سير عمل يحتاج إلى البريد الإلكتروني.

التثبيت

ثبّت AgentSend SDK للغتك، أو استدعِ REST API مباشرةً.

npm install agentsend

البدء السريع

ينشئ هذا المثال صندوق بريد، ويرسل رسالة، ويعرض الرسائل المستلمة — كل ذلك في أسطر قليلة.

1. احصل على مفتاح API

سجّل في agentsend.io وأنشئ مفتاح API من لوحة التحكم. اضبطه كمتغير بيئة:

export AGENTSEND_API_KEY="your-api-key"

2. أنشئ صندوق بريد

يحصل كل وكيل على صندوق بريد خاص به بعنوان بريد إلكتروني فريد.

const res = await fetch("https://api.agentsend.io/inboxes", {
  method: "POST",
  headers: {
    "x-api-key": process.env.AGENTSEND_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    displayName: "My Support Agent",
  }),
});

const inbox = await res.json();
console.log(inbox.address); // e.g. a1b2c3@agentsend.io

3. أرسل رسالة

await fetch(`https://api.agentsend.io/inboxes/${inbox.id}/messages`, {
  method: "POST",
  headers: {
    "x-api-key": process.env.AGENTSEND_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: ["customer@example.com"],
    subject: "Hello from AgentSend",
    bodyText: "This email was sent by an AI agent.",
  }),
});

4. استقبل الرسائل

عندما يرد شخص ما، تصل الرسالة إلى صندوق بريد وكيلك. قم باستعلام الرسائل الجديدة أو أعدّ webhook للتسليم الفوري.

const msgs = await fetch(
  `https://api.agentsend.io/inboxes/${inbox.id}/messages?status=received`,
  { headers: { "x-api-key": process.env.AGENTSEND_API_KEY } }
).then(r => r.json());

for (const msg of msgs.data) {
  console.log(msg.fromAddress, msg.subject);
}

ماذا حدث للتو

1. تم إنشاء صندوق البريد — قام AgentSend بتجهيز عنوان بريد إلكتروني فريد لوكيلك.
2. تم إرسال البريد — تم وضع الرسالة في قائمة الانتظار وإرسالها عبر البنية التحتية لـ AgentSend وتسليمها إلى المستلم.
3. تم استقبال الرد — أي ردود على ذلك العنوان تصل إلى صندوق البريد، جاهزة ليقرأها وكيلك.

المفاهيم الأساسية

• صناديق البريد — كل وكيل يحصل على عنوان بريد إلكتروني مخصص. أنشئ ما تحتاجه منها.
• الرسائل — أرسل واستقبل رسائل بنص عادي أو HTML أو مع مرفقات.
• المحادثات — تُجمَّع الرسائل تلقائياً في محادثات.
• Webhooks — احصل على إشعارات فورية عند وصول الرسائل أو ارتدادها أو تسليمها.
• النطاقات — استخدم نطاقك الخاص بدلاً من @agentsend.io.
• المرفقات — ارفع وأرفق الملفات مع الرسائل الصادرة.

الخطوات التالية