OpenEmail لـ Windsurf
أرسل البريدباستخدام Windsurf.
الصق التعليمات، فيثبّت Windsurf حزمة SDK، ويُبقي مفتاحك على الخادم، ويكتب كود الإرسال.
أضف البريد المعاملاتي إلى هذا التطبيق باستخدام OpenEmail. 1. ثبّت TypeScript SDK باستخدام npm install @openemail/sdk. 2. اقرأ مفتاح API من متغير البيئة OPENEMAIL_API_KEY، على الخادم فقط. لا ترسله إلى المتصفح أبدًا، ولا تُودِعه في المستودع أبدًا. 3. اكتب دالة مساعدة باسم sendEmail تستدعي init مرة واحدة، ثم openemail.emails.send. وأرسل من عنوان على نطاق مُتحقَّق منه في OpenEmail. 4. أبقِ الإرسال في كود الخادم، بجوار الكود الذي ينشئ المستخدمين. 5. مرّر idempotencyKey مبنيًّا على الحدث، مثل welcome:<userId>، كي لا ترسل إعادة المحاولة مرتين أبدًا. 6. أرسل رسالة ترحيب حين ينشئ أحدهم حسابًا، ودوّن في السجل المعرّف الذي يُعاد. مرجع SDK: https://openemail.uk/docs/sdk
غيّر المرسِل والحدث المُطلِق ليناسبا تطبيقك. والباقي هو الطريقة التي يتوقع OpenEmail أن يُستدعى بها.
ثلاث خطوات،
ثم يبدأ الإرسال.
- 01
أنشئ مفتاحًا
أنشئ في الإعدادات مفتاحًا يستطيع الإرسال. يظهر السر مرة واحدة فقط.
- 02
أبقِه سرًّا
ضعه في .env باسم OPENEMAIL_API_KEY، وأبقِ .env خارج git.
- 03
الصق التعليمات
يثبّت Windsurf حزمة SDK ويكتب كود الإرسال. راجع التغيير، ثم شغّله.
ما يكتبه.
مسار واحد، واستدعاء واحد.
نتيجة نموذجية. قد يسمّي Windsurf الملفات بأسماء أخرى.
lib/email.ts
import { init, openemail } from '@openemail/sdk'init({ apiKey: process.env.OPENEMAIL_API_KEY })export async function sendWelcome(user: User) {const sent = await openemail.emails.send({from: 'Acme <[email protected]>',to: user.email,subject: `Welcome, ${user.name}`,html: `<p>Thanks for signing up, ${user.name}.</p>`,}, {idempotencyKey: `welcome:${user.id}`,})console.log(sent.id)}
أتريد أن يقرأ Windsurf بريدك أيضًا؟
اربطه عبر MCP ليبحث في المحادثات ويقرأها ويردّ عليها، ضمن الصلاحيات التي توافق عليها.
أدوات أخرى
التعليمات نفسها، وصندوق البريد نفسه.
أنشئ مفتاحاً.
أرسل شيئاً.
وصول كامل إلى API وMCP وSDK في كل خطة، بما فيها المجانية.