設定電子郵件

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊

根據預設，開發人員服務入口網站會針對特定事件傳送電子郵件。舉例來說，當新的開發人員在入口網站註冊時，入口網站會自動傳送歡迎電子郵件給開發人員。或者，如果開發人員遺失自己的密碼，開發人員可以要求透過電子郵件提供臨時密碼。

API 供應商可控管入口網站所產生電子郵件的所有層面，包括：

  • 設定入口網站傳送的自動電子郵件格式
  • 指定入口網站使用的 SMTP 伺服器
  • 新增規則，針對入口網站上的事件產生回應電子郵件

從雲端式入口網站傳送電子郵件

部署於 Pantheon 或 Acquia 的雲端式入口網站預設電子郵件設定，只能在非實際工作環境中使用。如果電子郵件來自匿名雲端伺服器，可能會遭到封鎖或標示為垃圾郵件。

針對正式版入口網站，請透過下列其中一種方式傳送電子郵件：

從地端部署入口網站傳送電子郵件

在預設情況下，系統會使用 PHP mail() 函式傳送郵件。PHP 會嘗試在本機系統上使用 sendmail 傳送電子郵件 (可在 PHP 的 php.ini 檔案中設定)。

針對正式版入口網站，您可以使用下述的 SMTP 模組，透過 SMTP 伺服器或公司伺服器傳送電子郵件。

設定 SMTP 伺服器

開發人員入口網站會要求您設定 SMTP 伺服器以傳送電子郵件。如要設定 SMTP 伺服器，您必須先在開發人員入口網站啟用 Drupal SMTP 驗證支援模組。

設定 SMTP 伺服器後，開發人員入口網站傳送的所有電子郵件都會使用 SMTP 伺服器。這類電子郵件包括傳送給新開發人員的電子郵件、傳送給遺失密碼的開發人員的電子郵件，以及傳送給帳戶遭封鎖開發人員的電子郵件。

如何設定 SMTP 伺服器：

  1. 以具備管理員或內容建立權限的使用者登入入口網站。
  2. 在 Drupal 管理選單中選取「Modules」。
    「模組」頁面會隨即開啟。
  3. 啟用「SMTP 驗證支援」模組。
  4. 儲存設定。
  5. 啟用模組後，請在「模組」頁面的「 SMTP 驗證支援」項目中選取「設定」。
    系統隨即會顯示「SMTP 驗證支援」設定頁面。
  6. 在「開啟或關閉這個模組」下方，選取「開啟」。
  7. 在 SMTP 伺服器設定區域中，輸入下列資訊：
    • SMTP 伺服器位址。舉例來說，如果是 Gmail 外寄 SMTP 伺服器，請使用 smtp.gmail.com。
    • 如有需要，請輸入備用 SMTP 伺服器位址。(選用)
    • 輸入 SMTP 通訊埠。根據所選的加密通訊協定，這個通訊埠的值可以不同。以 Gmail 為例，使用 SSL 時，通訊埠為 465，傳輸層安全標準 (TLS) 的通訊埠為 587。
    • 選取加密通訊協定為「None」、「SSL」或「TLS」。
  8. 在「SMTP 驗證」區域中，指定 SMTP 驗證使用的使用者名稱和密碼。這必須是 SMTP 伺服器上的有效使用者名稱和密碼。
  9. 在「電子郵件選項」下方，輸入產生電子郵件的使用者電子郵件地址和名稱。這些值會對應到電子郵件的「寄件者」地址。
  10. 或者，您也可以在「傳送測試電子郵件訊息」下方，輸入入口網站傳送測試訊息的電子郵件地址。
  11. 儲存設定。
    儲存設定會產生測試電子郵件訊息，並顯示任何設定錯誤。查看測試郵件電子郵件地址的收件匣，確保郵件順利送達。
  12. 在 Drupal 管理選單中，依序選取「Configuration」>「System」>「Site Information」。
  13. 在「Site Details」下方，將電子郵件地址設為您在步驟 9 中指定的電子郵件地址。
    部分產生電子郵件的 Drupal 模組會使用這個欄位來決定電子郵件的「寄件者」地址，而不是「SMTP 驗證支援」頁面中的值。
  14. 儲存設定。

設定電子郵件通知的格式

您可以設定依據特定活動 (例如註冊、刪除、封鎖及解除封鎖開發人員帳戶) 傳送的各種電子郵件通知。

您也可以控管電子郵件的「寄件者」地址，

如何設定電子郵件通知：

  1. 以具備管理員或內容建立權限的使用者登入入口網站。
  2. 在 Drupal 管理選單中，依序選取「Configuration」>「People」>「Account settings」。「帳戶設定」頁面隨即開啟。
  3. 在「帳戶設定」頁面的「電子郵件」部分中，選取電子郵件通知類型。 舉例來說，您可以選取「歡迎 (不需核准)」，讓系統在開發人員帳戶於開發人員註冊流程中自動核准時傳送電子郵件。

  4. 編輯電子郵件通知的「主旨」和「內文」。
    將遊標放置在例如「主旨」等欄位中，然後選取表單底部的「瀏覽可用符記」連結，即可查看您在該欄位可使用的符記清單。畫面上會出現彈出式視窗，讓您選取要新增的符記，例如 [user:name]，該憑證會對應至開發人員的使用者名稱。
  5. 按一下「儲存設定」。

您也可以變更電子郵件通知中的「寄件者」名稱和地址。

如何變更「寄件者」名稱和地址：

  1. 以具備管理員或內容建立權限的使用者登入入口網站。
  2. 在 Drupal 管理選單中，依序選取「Configuration」>「System」>「SMTP Authentication Support」。系統隨即會開啟「SMTP 驗證支援」頁面。
  3. 在「電子郵件寄件者地址」欄位中指定「寄件者」電子郵件地址。
  4. 在「E-Mail From Name」欄位中指定「寄件者」名稱。
  5. 按一下「儲存設定」。
  6. 在 Drupal 管理選單中，依序選取「Configuration」>「System」>「Site information」。
  7. 請在「電子郵件地址」欄位中，指定您在步驟 3 使用的電子郵件地址。
  8. 按一下「儲存設定」。

在事件發生時產生電子郵件

規則的常見用途之一，是產生回應特定活動的電子郵件。入口網站內建支援功能，可針對預先定義事件 (例如新的開發人員註冊帳戶) 產生電子郵件。不過，您也可以自行新增規則來產生電子郵件。舉例來說，您可以在開發人員新增、移除或修改應用程式時產生電子郵件。

本節範例說明如何建立規則，以便在開發人員註冊應用程式時產生電子郵件。請視需要修改這項程序，以產生其他事件的電子郵件。

如何在開發人員建立應用程式時產生電子郵件：

  1. 以具備管理員或內容建立權限的使用者登入入口網站。
  2. 在 Drupal 管理選單中選取「Modules」。
  3. 確認已啟用「Rules UI」模組。
  4. 在 Drupal 管理選單中，依序選取「Configuration」>「Workflow」>「Rules」。系統會開啟「規則」頁面。
  5. 選取「新增規則」按鈕。
  6. 在新規則頁面中指定以下項目：
    • 將規則名稱設為名稱，例如：「傳送電子郵件規則」。
    • 視需要指定用於將搜尋規則分類的「標記」。
    • 在「React on event」下拉式選單中，依序選取「Devconnect」>「在建立開發人員應用程式時」。
  7. 儲存規則。
    儲存規則會開啟「規則」編輯表單，其中包含三個窗格：「事件」(您剛建立的事件)、「條件」和「動作」。
  8. 選取「動作」下方的「新增動作」。
  9. 在「選取要新增的動作」下拉式選單中，依序選取「系統」>「傳送電子郵件」。
    所選項目會開啟可設定電子郵件格式的頁面。請使用這份表單指定電子郵件的「收件者」、「主旨」、「訊息」和其他欄位。

    展開每個欄位下方的「替換」模式連結，即可查看可在欄位中使用的模式清單。舉例來說，如果您在「To」欄位下方展開取代模式，就會看到包含 [app:developer] 的模式清單。如果您在「收件者」欄位中指定這個模式，電子郵件就會傳送給應用程式的建立者。
  10. 設定欄位，如下所示：
  11. 選取「儲存」返回規則編輯頁面。
  12. 選取「儲存變更」。

在入口網站新增應用程式來測試規則。您應該會收到一封電子郵件中的電子郵件通知，如下所示：

Subject: App test email app created

App: test email app
API products: PremiumWeatherAPI, weatherapikey-Product
Created at: Mon, 01/27/2014 - 10:16