# Newsletter — จดหมายข่าวทางอีเมล

> ปลั๊กอิน Newsletter ทางการ — ฟอร์มรับข่าวสารบนหน้าเว็บ ยืนยันอีเมล (double opt-in) ลิงก์ยกเลิกในทุกฉบับ นำเข้าและส่งออกรายชื่อ และส่งแคมเปญแบบทยอยตามโควตาอีเมล

ที่มา: https://anasaki.live/docs/store/plugin-newsletter

ปลั๊กอิน **Newsletter** (`newsletter`) เก็บรายชื่อผู้รับข่าวสารและส่งอีเมลแคมเปญจากเว็บของคุณเอง ไม่ต้องใช้บริการภายนอก

ต้องใช้ Anasaki Studio 2.2.2 ขึ้นไป และต้องตั้งค่า **ตั้งค่าเว็บไซต์ → อีเมล** ก่อน

## รับสมัคร

วางบล็อก **ฟอร์มรับข่าวสาร** ในหน้าออกแบบ (ตั้งหัวข้อ คำอธิบาย ข้อความบนปุ่ม และเลือกให้ถามชื่อได้) — หรือส่งฟอร์มของคุณเองแบบ POST ไปที่ `/newsletter/subscribe` (ช่อง `email`, `name`)

เมื่อเปิด **ยืนยันอีเมลก่อนรับข่าว** (ค่าเริ่มต้น) ผู้สมัครจะได้อีเมลพร้อมลิงก์ยืนยัน และจะได้รับข่าวหลังกดยืนยันเท่านั้น — ช่วยกันคนใส่อีเมลของคนอื่น และทำให้อีเมลของเว็บไม่ถูกมองเป็นสแปม

## ส่งแคมเปญ

1. หน้า **จดหมายข่าว** (เมนูนักพัฒนา → หน้าของปลั๊กอิน) → แท็บ **แคมเปญ** → **แคมเปญใหม่**
2. ใส่หัวเรื่องและข้อความ — เว้นบรรทัดว่างเพื่อขึ้นย่อหน้าใหม่ ลิงก์ `https://` กดได้อัตโนมัติ
3. **ส่งทดสอบถึงฉัน** เพื่อดูหน้าตาในกล่องอีเมลของคุณ
4. **ส่งถึงผู้รับข่าวทั้งหมด** — ระบบทยอยส่งเบื้องหลัง ดูความคืบหน้า (ส่งแล้ว / ไม่สำเร็จ) ในรายการแคมเปญ

ทุกฉบับมี **ท้ายอีเมล** ที่ตั้งไว้ และลิงก์ **ยกเลิกรับข่าวสาร** เสมอ

> [!WARNING]
> เว็บส่งอีเมลได้ตามโควตารวมของเว็บ (ค่าเริ่มต้น 100 ฉบับ/ชั่วโมง ปรับที่ **โค้ดของเว็บไซต์ → ตั้งค่า**) ตั้ง **ส่งไม่เกินกี่ฉบับต่อชั่วโมง** ของปลั๊กอินให้น้อยกว่าโควตา เพื่อเหลือไว้ให้อีเมลอื่นของเว็บ (รีเซ็ตรหัสผ่าน แจ้งคำสั่งซื้อ ฯลฯ) — รายชื่อใหญ่จะใช้เวลาส่งหลายชั่วโมง ถ้าส่งเป็นหมื่นฉบับขึ้นไป ควรใช้ SMTP ของบริการส่งอีเมล เช่น SendGrid หรือ Amazon SES

## จัดการรายชื่อ

แท็บ **ผู้รับข่าว** แบ่งเป็น รับข่าวอยู่ / รอยืนยัน / ยกเลิกแล้ว ค้นหาด้วยอีเมลหรือชื่อ ลบ **ส่งออก CSV** และ **เพิ่มผู้รับข่าว** โดยวางรายการ `อีเมล,ชื่อ` บรรทัดละรายการ (ถูกเพิ่มเป็น “รับข่าวอยู่” ทันที — ใช้เฉพาะคนที่ยินยอมแล้วตาม PDPA)

## ยกเลิกรับข่าวสาร

ลิงก์ในอีเมลเปิดหน้า “ยกเลิกการรับข่าวสาร” ที่ต้องกดปุ่มยืนยันอีกครั้ง (กันโปรแกรมสแกนลิงก์ของอีเมลกดยกเลิกแทนผู้รับ) ผู้ที่ยกเลิกแล้วจะไม่ได้รับแคมเปญถัดไป และถ้าสมัครใหม่จะต้องยืนยันอีเมลอีกครั้ง

## สำหรับนักพัฒนา

```ts
site.on('newsletter.subscribed', (s) => log.info('subscriber', s.email));
plugins.call('newsletter', 'subscribe', 'buyer@example.com', 'Somchai'); // เช่น จากหน้าชำระเงิน
```

เหตุการณ์ `newsletter.subscribed` `newsletter.unsubscribed` `newsletter.sent` ตาราง `p_newsletter_subscribers` `p_newsletter_campaigns`
