---
name: email-composer
description: Draft professional emails for Mawidi including customer communications, support responses, billing notifications, onboarding sequences, and internal team messages. Use when composing emails, creating email templates, or writing bilingual Arabic/English communications for medical clinic customers in the GCC market.
---

# Email Composer

## Quick Start

Provide context and purpose, and I'll draft an appropriate email.

**What I need:**

- Purpose of email (onboarding, support, billing, announcement, etc.)
- Recipient type (clinic owner, staff, prospect, internal team)
- Key points to include
- Language preference (English, Arabic, or bilingual)
- Desired tone (formal, professional, friendly, urgent)

## Email Structure

Standard professional email format:

```
Subject: [Clear, specific subject line]

[Greeting],

[Opening - context/purpose]

[Body - main points]

[Closing - call to action]

[Sign-off]

[Your name]
[Title]
Mawidi | مواعيدي
```

---

## Mawidi-Specific Templates

### Welcome / Onboarding Email

**English:**

```
Subject: Welcome to Mawidi - Let's Get Your Clinic Set Up! 🎉

Hi [Name],

Welcome to Mawidi! We're thrilled to have [Clinic Name] on board.

Your account is now active, and you're just a few steps away from automating your appointment booking with WhatsApp.

Here's how to get started:

1. Complete your clinic profile - Add your services and working hours
2. Connect WhatsApp Business - Link your clinic's WhatsApp number
3. Create your first service - Set up bookable appointments
4. Share your booking link - Start accepting appointments

Log in to your dashboard: [Dashboard Link]

Need help? Our team is here for you:
- Email: support@mawidi.com
- WhatsApp: +974 XXXX XXXX
- Help Center: help.mawidi.com

We're excited to help you grow your practice!

Best regards,

[Your name]
Customer Success Team
Mawidi | مواعيدي
```

**Arabic:**

```
Subject: مرحباً بك في مواعيدي - لنبدأ بإعداد عيادتك! 🎉

مرحباً [الاسم]،

أهلاً بك في مواعيدي! يسعدنا انضمام [اسم العيادة] إلينا.

حسابك الآن نشط، وأنت على بعد خطوات قليلة من أتمتة حجز المواعيد عبر الواتساب.

إليك كيفية البدء:

١. أكمل ملف عيادتك - أضف خدماتك وساعات العمل
٢. اربط واتساب للأعمال - اربط رقم واتساب عيادتك
٣. أنشئ خدمتك الأولى - أعد المواعيد القابلة للحجز
٤. شارك رابط الحجز - ابدأ باستقبال الحجوزات

سجل الدخول إلى لوحة التحكم: [رابط لوحة التحكم]

تحتاج مساعدة؟ فريقنا هنا من أجلك:
- البريد الإلكتروني: support@mawidi.com
- واتساب: +974 XXXX XXXX
- مركز المساعدة: help.mawidi.com

نتطلع لمساعدتك في تنمية عيادتك!

مع أطيب التحيات،

[اسمك]
فريق نجاح العملاء
مواعيدي | Mawidi
```

---

### Appointment Confirmation (To Patient)

**English:**

```
Subject: Appointment Confirmed - [Service] at [Clinic Name]

Hi [Patient Name],

Your appointment has been confirmed!

📅 Details:
- Service: [Service Name]
- Date: [Day, Month Date, Year]
- Time: [Time]
- Location: [Clinic Address]
- Doctor: [Doctor Name]

What to bring:
- Valid ID
- Insurance card (if applicable)
- Previous medical records (if first visit)

Need to reschedule or cancel?
Reply to this email or click here: [Reschedule Link]

Please arrive 10 minutes early to complete any paperwork.

See you soon!

[Clinic Name]
[Phone Number]
[Address]

---
Powered by Mawidi | مواعيدي
```

**Arabic:**

```
Subject: تأكيد الموعد - [الخدمة] في [اسم العيادة]

مرحباً [اسم المريض]،

تم تأكيد موعدك!

📅 التفاصيل:
- الخدمة: [اسم الخدمة]
- التاريخ: [اليوم، التاريخ]
- الوقت: [الوقت]
- الموقع: [عنوان العيادة]
- الطبيب: [اسم الطبيب]

ما يجب إحضاره:
- هوية سارية المفعول
- بطاقة التأمين (إن وجدت)
- السجلات الطبية السابقة (إذا كانت الزيارة الأولى)

تحتاج لإعادة الجدولة أو الإلغاء؟
رد على هذا البريد أو انقر هنا: [رابط إعادة الجدولة]

يرجى الحضور قبل 10 دقائق لإكمال أي أوراق.

نراك قريباً!

[اسم العيادة]
[رقم الهاتف]
[العنوان]

---
مدعوم من مواعيدي | Mawidi
```

---

### Appointment Reminder

**English:**

```
Subject: Reminder: Your appointment is tomorrow - [Clinic Name]

Hi [Patient Name],

This is a friendly reminder about your upcoming appointment:

📅 Tomorrow, [Date] at [Time]
📍 [Clinic Name], [Address]
👨‍⚕️ [Service] with [Doctor Name]

Can't make it?
Please let us know at least 4 hours in advance:
- Reply to this email
- Call: [Phone]
- WhatsApp: [Number]

See you tomorrow!

[Clinic Name]
```

**Arabic:**

```
Subject: تذكير: موعدك غداً - [اسم العيادة]

مرحباً [اسم المريض]،

هذا تذكير بموعدك القادم:

📅 غداً، [التاريخ] الساعة [الوقت]
📍 [اسم العيادة]، [العنوان]
👨‍⚕️ [الخدمة] مع [اسم الطبيب]

لا تستطيع الحضور؟
يرجى إبلاغنا قبل 4 ساعات على الأقل:
- رد على هذا البريد
- اتصل: [الهاتف]
- واتساب: [الرقم]

نراك غداً!

[اسم العيادة]
```

---

### Subscription / Billing Email

**English:**

```
Subject: Invoice #[Number] - Your Mawidi subscription

Hi [Name],

Thank you for your continued trust in Mawidi. Please find your invoice details below.

Invoice Details:
- Invoice Number: #[Number]
- Date: [Date]
- Amount: [Currency] [Amount]
- Plan: [Plan Name] ([Monthly/Yearly])
- Billing Period: [Start Date] - [End Date]

Payment Status: [Paid/Pending]

View full invoice: [Invoice Link]
Manage subscription: [Dashboard Link]

Questions about your bill?
Contact us at billing@mawidi.com

Thank you for choosing Mawidi!

Best regards,

Billing Team
Mawidi | مواعيدي
```

---

### Support Response

**English:**

```
Subject: Re: [Original Subject] - Ticket #[Number]

Hi [Name],

Thank you for reaching out to Mawidi Support. I understand you're experiencing [brief issue summary].

I've looked into this and here's what I found:
[Explanation of the issue]

To resolve this:
1. [Step 1]
2. [Step 2]
3. [Step 3]

[If applicable: I've also made the following changes to your account: ...]

If you're still experiencing issues after trying these steps, please let me know and I'll be happy to schedule a call to help you directly.

Is there anything else I can help you with?

Best regards,

[Your name]
Customer Support
Mawidi | مواعيدي

Support Hours: Sunday-Thursday, 9 AM - 6 PM (Qatar Time)
```

**Arabic:**

```
Subject: رد: [الموضوع الأصلي] - تذكرة #[الرقم]

مرحباً [الاسم]،

شكراً لتواصلك مع دعم مواعيدي. أتفهم أنك تواجه [ملخص المشكلة].

قمت بالتحقق من الأمر وإليك ما وجدته:
[شرح المشكلة]

لحل هذا الأمر:
١. [الخطوة الأولى]
٢. [الخطوة الثانية]
٣. [الخطوة الثالثة]

[إن أمكن: قمت أيضاً بإجراء التغييرات التالية على حسابك: ...]

إذا كنت لا تزال تواجه مشاكل بعد تجربة هذه الخطوات، أخبرني وسأكون سعيداً بترتيب مكالمة لمساعدتك مباشرة.

هل هناك شيء آخر يمكنني مساعدتك به؟

مع أطيب التحيات،

[اسمك]
دعم العملاء
مواعيدي | Mawidi

ساعات الدعم: الأحد-الخميس، 9 صباحاً - 6 مساءً (توقيت قطر)
```

---

### Feature Announcement

**English:**

```
Subject: New Feature: [Feature Name] is now available! 🚀

Hi [Name],

We're excited to announce a new feature that will help you [benefit]:

✨ Introducing [Feature Name]

[Brief description of what it does]

Key benefits:
• [Benefit 1]
• [Benefit 2]
• [Benefit 3]

How to get started:
1. Log in to your dashboard
2. Navigate to [Location]
3. [Action to enable/use]

Watch a quick tutorial: [Video Link]
Read the full guide: [Help Article Link]

We'd love to hear your feedback! Reply to this email or reach out on WhatsApp.

Happy scheduling!

The Mawidi Team
مواعيدي | Mawidi
```

---

### Trial Expiration Warning

**English:**

```
Subject: Your Mawidi trial ends in [X] days - Don't lose your data!

Hi [Name],

Your 14-day free trial of Mawidi is ending on [Date].

During your trial, you've:
• Booked [X] appointments
• Saved approximately [X] hours
• Connected with [X] patients via WhatsApp

Don't lose your progress! Upgrade to a paid plan to:
✓ Keep all your data and settings
✓ Continue accepting bookings
✓ Access premium features
✓ Get priority support

Choose your plan: [Pricing Link]

Questions? Reply to this email or schedule a call with our team.

Best regards,

[Your name]
Customer Success
Mawidi | مواعيدي
```

---

### Cancellation Confirmation

**English:**

```
Subject: Your appointment has been cancelled - [Clinic Name]

Hi [Patient Name],

Your appointment has been cancelled as requested.

Cancelled appointment details:
- Service: [Service Name]
- Original Date: [Date]
- Original Time: [Time]
- Clinic: [Clinic Name]

Would you like to reschedule?
Book a new appointment: [Booking Link]

We hope to see you soon!

[Clinic Name]
[Contact Info]

---
Powered by Mawidi | مواعيدي
```

---

## General Email Templates

### Request for Information

```
Subject: Question about [Topic]

Hi [Name],

I hope this email finds you well. I'm reaching out regarding [context].

Could you please provide:
- [Question 1]
- [Question 2]
- [Question 3]

This will help us [reason/benefit].

Thanks in advance for your help!

Best regards,
[Your name]
```

### Follow-Up Email

```
Subject: Following up: [Original Topic]

Hi [Name],

I wanted to follow up on [previous communication] from [timeframe].

To recap:
- [Key point 1]
- [Key point 2]
- [Key point 3]

Could you provide an update when you have a moment?

I'm happy to schedule a quick call if that would be easier.

Best,
[Your name]
```

### Meeting Request

```
Subject: Meeting request: [Topic]

Hi [Name],

I'd like to schedule a meeting to discuss [topic].

Agenda:
- [Item 1]
- [Item 2]
- [Item 3]

Estimated duration: [X] minutes

I'm available:
- [Option 1]
- [Option 2]
- [Option 3]

Please let me know what works best for you.

Best,
[Your name]
```

### Apologize for Issue

```
Subject: Our apologies: [Issue]

Hi [Name],

I'm writing to apologize for [specific issue]. I understand this [impact on them].

What happened:
[Brief explanation]

What we've done:
- [Action 1]
- [Action 2]

What we're doing to prevent this:
- [Preventive measure]

[If applicable: As a gesture of goodwill, we've ...]

We value your business and appreciate your patience.

Sincerely,
[Your name]
```

### Share Good News

```
Subject: Great news: [Achievement] 🎉

Hi [Name/Team],

I'm excited to share that [accomplishment]!

Highlights:
- [Achievement 1]
- [Achievement 2]
- [Achievement 3]

This is thanks to [recognition].

Next steps:
- [What's coming]

Thank you for your [contribution/support]!

Cheers,
[Your name]
```

---

## Tone Guidelines

### Formal Tone (Use for: New clients, official communications, escalations)

- Use complete sentences
- Avoid contractions
- Professional language
- Proper titles (Dr., Mr., Ms.)
- "Thank you for your patience"

### Professional Tone (Use for: Day-to-day client communication)

- Warm but businesslike
- Contractions acceptable
- Clear and direct
- First names okay
- "Thanks for reaching out"

### Friendly Tone (Use for: Onboarding, announcements, established relationships)

- Conversational
- Use emojis sparingly 🎉
- Enthusiastic language
- Personal touches
- "We're excited to..."

### Urgent Tone (Use for: Critical issues, time-sensitive matters)

- [URGENT] or [ACTION REQUIRED] in subject
- Bold key points
- Explicit deadline
- Direct call to action
- "Please respond by..."

---

## Subject Line Best Practices

**Good Subject Lines:**

- "Your appointment is confirmed - March 15 at 2 PM"
- "Action required: Complete your clinic setup by Friday"
- "New feature: WhatsApp templates are now available"
- "Quick question about your account"
- "Your invoice #1234 is ready"

**Bad Subject Lines:**

- "Update"
- "Hello"
- "Important"
- "Question"
- "Following up"

---

## Arabic Email Best Practices

### RTL Formatting

- Ensure email client supports RTL
- Use Arabic punctuation (، instead of ,)
- Right-align text
- Use Arabic numerals or Eastern Arabic numerals (١٢٣)

### Greetings

- مرحباً [Name] - Hello (general)
- السلام عليكم - Peace be upon you (formal/religious)
- صباح الخير - Good morning
- مساء الخير - Good evening

### Closings

- مع أطيب التحيات - Best regards
- مع خالص الشكر - With sincere thanks
- تحياتي - Regards
- شكراً - Thank you

### Professional Arabic Phrases

- نتطلع للتعاون معكم - We look forward to working with you
- نقدر تفهمكم - We appreciate your understanding
- لا تتردد في التواصل - Don't hesitate to reach out
- نحن هنا للمساعدة - We're here to help

---

## Email Etiquette

### DO:

- ✓ Respond within 24 hours (even if just to acknowledge)
- ✓ Use clear, specific subject lines
- ✓ Keep it concise
- ✓ Proofread before sending
- ✓ Include relevant context
- ✓ Use bullet points for multiple items
- ✓ End with clear call to action
- ✓ Include proper signature
- ✓ Consider timezone differences (GCC)

### DON'T:

- ✗ Use ALL CAPS
- ✗ Over-use exclamation marks!!!
- ✗ Mark everything as urgent
- ✗ Reply all unless necessary
- ✗ Send when emotional
- ✗ Forget attachments mentioned
- ✗ Use slang or overly casual language
- ✗ Assume recipient speaks your language

---

## Email Composition Checklist

- [ ] Clear, specific subject line
- [ ] Appropriate greeting for audience
- [ ] Purpose stated in first paragraph
- [ ] Key points organized with bullets/numbers
- [ ] Clear call to action or next steps
- [ ] Appropriate tone for recipient
- [ ] Proofread for typos/grammar
- [ ] Attachments included (if mentioned)
- [ ] Recipients correct (To, CC, BCC)
- [ ] Professional signature with contact info
- [ ] Language matches recipient preference
- [ ] RTL formatting for Arabic (if applicable)

---

## Mawidi Email Signature

### With Logo (HTML Email)

```html
<table>
  <tr>
    <td style="padding-right: 16px;">
      <img
        src="https://mawidi.com/brand/logo-icon.jpg"
        alt="Mawidi"
        width="48"
        height="48"
      />
    </td>
    <td>
      <strong>[Full Name]</strong><br />
      [Title]<br />
      <span style="color: #25D366;">Mawidi</span> |
      <span style="color: #25D366;">موعدي</span><br />
      <a href="mailto:email@mawidi.com">email@mawidi.com</a> |
      <a href="https://mawidi.com">mawidi.com</a>
    </td>
  </tr>
</table>
```

### Text-Only Signature

**English:**

```
Best regards,

[Full Name]
[Title]
Mawidi | مواعيدي

📧 [email]
📱 [phone]
🌐 mawidi.com
```

**Arabic:**

```
مع أطيب التحيات،

[الاسم الكامل]
[المسمى الوظيفي]
مواعيدي | Mawidi

📧 [البريد الإلكتروني]
📱 [الهاتف]
🌐 mawidi.com
```

### Logo Assets for Emails

Use the logo files from `/public/brand/`:

- **logo-horizontal.jpeg** - Full logo for email headers
- **logo-icon.jpg** - Icon for signatures (48x48px recommended)
- **logo-stacked.jpg** - Square format for marketing emails

---

## See Also

- [send-bilingual-email.ts](../send-bilingual-email.ts) - Programmatic email sending
- [i18n-management](../i18n-management/SKILL.md) - Translation patterns
- [brand-guidelines](../brand-guidelines/SKILL.md) - Mawidi visual identity
