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

البريد والقوالب

تم التحديث يوليو 2026·1 min

أرسل بريدًا معاملاتيًا بالقوالب بأي لغة مفعّلة، وأرسل دفعات، واطّلع على قوالب مساحة العمل.

منطقة البريد بالقوالب والحملات.منطقة البريد بالقوالب والحملات.

مثال سريع

مُدقّق الأنواع مقابل ‎@medalsocial/sdk v1.3.0 (2026-07-20). أي إصدار يغيّر توقيعًا يوقف بناء هذه الصفحة.

ts
import { Medal } from '@medalsocial/sdk';

const medal = new Medal(process.env.MEDAL_API_KEY as string);

// Send a templated email (locale falls back automatically)
const { data: send } = await medal.emails.send({
  template_slug: 'welcome',
  to: 'nora@solsticecoffee.no',
  name: 'Nora',
  locale: 'nb',
  variables: { first_name: 'Nora' },
});

// Check delivery status
const { data: status } = await medal.emails.get(send.id);
console.log(status.status);

// List available templates
const { data: templates } = await medal.emails.templates.list();
console.log(templates.map((t) => t.slug));

medal.emails.send()

Send a transactional email using a template. Returns a queued job ID (HTTP 202).

ts
send(input: SendEmailInput): Promise<ApiResponse<EmailSendResult>>
أُضيف في v1.0.0

medal.emails.get()

Get the delivery status of a sent email.

ts
get(id: string): Promise<ApiResponse<EmailSend>>
أُضيف في v1.0.0

medal.emails.batch()

Send the same template to multiple recipients (max 100). Returns HTTP 202.

ts
batch(input: BatchSendInput): Promise<ApiResponse<BatchSendSummary>>
أُضيف في v1.0.0

medal.emails.templates.list()

List all active email templates in the workspace.

ts
list(): Promise<ApiResponse<EmailTemplate[]>>
أُضيف في v1.0.0

medal.emails.templates.get()

Get a specific email template by slug, optionally with locale resolution.

ts
get(slug: string, options?: GetTemplateOptions): Promise<ApiResponse<EmailTemplateDetail>>
أُضيف في v1.0.0