> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insforge.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 訊息傳遞

> 從您的專案傳送交易性訊息。今天傳送電子郵件，SMS 和推送在路線圖上。

InsForge Messaging 從您的專案傳送交易性通知：收據、摘要、密碼重設代碼、通知匯總、任何您本來會為其接入 SendGrid、Postmark 或 Twilio 的東西。電子郵件是第一個通道；SMS 和推送在路線圖上，將共享相同的 API 表面。

<Note>
  **只是傳送驗證電子郵件？** 魔法連結、驗證代碼和密碼重設已內建在 [Authentication](/core-concepts/authentication/overview) 中。您只需要這個產品用於驗證之外的交易性訊息。
</Note>

```mermaid theme={null}
graph TB
    Client[Client Application] --> SDK[InsForge SDK]
    SDK --> API[Email API]
    API --> Service[EmailService]
    Service --> Decision{SMTP enabled?}
    Decision -->|No| Cloud[InsForge Cloud]
    Cloud --> SES[AWS SES]
    Decision -->|Yes| SMTP[Your SMTP server]
    SES --> Inbox[Recipient Inbox]
    SMTP --> Inbox

    style Client fill:#1e293b,stroke:#475569,color:#e2e8f0
    style SDK fill:#1e40af,stroke:#3b82f6,color:#dbeafe
    style API fill:#166534,stroke:#22c55e,color:#dcfce7
    style Service fill:#166534,stroke:#22c55e,color:#dcfce7
    style Decision fill:#7c3aed,stroke:#a78bfa,color:#ede9fe
    style Cloud fill:#7c3aed,stroke:#a78bfa,color:#ede9fe
    style SES fill:#ea580c,stroke:#f97316,color:#fed7aa
    style SMTP fill:#0e7490,stroke:#06b6d4,color:#cffafe
    style Inbox fill:#0e7490,stroke:#06b6d4,color:#cffafe
```

## 通道

<CardGroup cols={3}>
  <Card title="Email" icon="envelope" href="/core-concepts/messaging/custom-smtp">
    託管 SMTP 或使用您自己的提供商。範本、交付追蹤和 webhook 事件。
  </Card>

  <Card title="SMS" icon="message">
    即將推出。相同的 API，後端使用 Twilio 或 Sinch。
  </Card>

  <Card title="Push" icon="bell">
    即將推出。透過單個端點的 APNs 和 FCM。
  </Card>
</CardGroup>

## 功能

### 一個 API，每個通道

今天電子郵件的相同 `emails.send()` 形狀，當它們著陸時 SMS 和推送跟隨。切換通道是欄位變更，而不是重寫。

### 託管交付或使用您自己的

透過 InsForge Cloud（今天用於電子郵件的 AWS SES）傳送以獲得零設定，或在您需要控制交付能力和寄件人聲譽時插入您自己的提供商。請參閱 [Custom SMTP](/core-concepts/messaging/custom-smtp)。

### 範本

按名稱選擇範本，傳遞變數，InsForge 呈現並傳送。範本可編輯每個專案；四個驗證範本 (`email-verification-*`、`reset-password-*`) 帶有合理的預設值。

### 交付追蹤

傳送事件 (`accepted`、`delivered`、`bounced`、`complained`) 按訊息記錄。在 Postgres 中查詢稽核資料表、透過 webhook 訂閱或觀察儀表板。

### 速率限制

按專案和按計畫的限制可以防止流氓迴圈融化交付能力。從儀表板配置，在閘道處強制執行。

## 概念

<CardGroup cols={2}>
  <Card title="Custom SMTP" icon="envelope" href="/core-concepts/messaging/custom-smtp">
    使用您自己的 SMTP 提供商（SendGrid、Postmark、AWS SES 等）。
  </Card>
</CardGroup>

## 使用它進行建置

<CardGroup cols={2}>
  <Card title="TypeScript SDK" icon="js" href="/sdks/typescript/email">
    從 Node、瀏覽器和邊緣執行時傳送郵件。
  </Card>

  <Card title="REST API" icon="code" href="/sdks/rest/overview">
    普通 HTTP 訊息端點，可從任何語言呼叫。
  </Card>
</CardGroup>

## 下一步

* 設定 [CLI](/quickstart) 以連結您的專案（建議的路徑）。
* 瀏覽 [TypeScript SDK 參考](/sdks/typescript/email) 以瞭解傳送模式。