Google Cloud Functions × JavaScript でメールを送信する

技術情報 Google Cloud Functions JavaScript

Google Cloud FunctionsはGoogle Cloud PlatformのFaaS（Function As a Service）で、サーバレスでスクリプトを実行できます。今回はこのGoogle Cloud Functionsを使って、Customers Mail Cloudでメール送信を行う方法を紹介します。

Customers Mail Cloudの設定

まずはCustomers Mail Cloudにて送信サーバの設定を行います。

ユーザ登録

ユーザ登録はまず、メールアドレスとパスワードを入力するところからはじまります。

f:id:moongift:20190510151017p:plain
ユーザ登録

入力したメールアドレス宛にメールアドレスの確認メール（仮登録受付メール）が届きますので、URLをクリックします。その後、名前や住所といった必要な情報を入力します。ユーザ登録が完了すると、無料トライアル開始のための審査が入ります。時間は長くとも30分程度です。「Customers Mail Cloud 無料トライアル利用開始のご案内」というメールが届いたら利用できます。

ログイン後に行うこと

ログインしたら、2つの作業を行う必要があります。

f:id:moongift:20190510150911p:plain
ダッシュボード

DKIMキーを設定する

DKIMキーはメールのなりすましを防止するための技術になります。メール配信を行うドメインのTXTレコードに対して設定します。管理コンソールでドメインを追加しようとすると、専用のキーが表示されます。

f:id:moongift:20190510150735p:plain
DKIMキーの取得

ドメインは s999999999999._domainkey.example.com のような形式になります。設定する値は v=DKIM1; p=MIG...QAB のように指定されるはずです。この設定はシステム管理者などに依頼して行ってもらってください。

DNS設定はすぐに反映されませんので、数分後にDNSを確認ボタンを押します。正しく設定されていれば、ドメインが追加登録できます。

ユーザを追加する

次にメール配信を行うユーザを追加します。これはAPI設定にて行います。ユーザ名（メールアドレス形式）、パスワードを設定します。また、利用できる機能を制限できます。例えばSMTPのみ、APIのみといった指定も可能です。

f:id:moongift:20190510150841p:plain
ユーザの追加

サーバに設定を反映する

設定を行ったら、それをサーバに反映します。サーバ構成機能にて行います。この反映を行わないと、DKIMやユーザ追加設定が反映されませんので注意してください。ここまでで以下の情報が入手できているはずです。

  • APIユーザ
  • APIキー

さらにAPIサーバのエンドポイントURLが必要です。これは契約しているプランによって異なりますのでご注意ください。

プラン名 エンドポイントURL
無料トライアル https://sandbox.smtps.jp/api/v2/emails/send.json
Standardプラン https://te.smtps.jp/api/v2/emails/send.json
Proプラン https://SUBDOMAIN.smtps.jp/api/v2/emails/send.json

これらの情報はメール送信時に設定しますので覚えておいてください。

Google Cloudでプロジェクトを作成する

Google Cloudにログインしてプロジェクトを作成します。プロジェクトを作成した後、左のメニューからCloud Functionsへアクセスします。

f:id:moongift:20190807155258p:plain
プロジェクトの作成

今回、Cloud Functionsで使うのはNode.jsになります。β版ですがバージョン10を選んでいます。

コードについて

適当なディレクトリを作成し、それをNode.jsプロジェクトとして使っています。そのコードにあたる index.js について解説します。開発はローカルで行っています。まず、HTTPリクエストを行うので superagent をインストールします。

$ npm i superagent -S

まず superagent を読み込みます。

import request from 'superagent';

後はCloud Functionsがリクエストされた時の処理を記述します。具体的には下記の関数の中に記述します。

exports.helloWorld = async (req, res) => {
  // ここに処理を記述
});

処理内容

今回はPOSTメソッドだけを対象にします。

if (req.method !== 'POST') {
  res.status(405).send('Invalid http method.');
} else {
  // 処理を記述
}

次に送信先、送信元を定義します。送信先はリクエストボディで指定できるようにします。

const to = [{
  name: req.body.name,
  address: req.body.email
}];
const from = {
  name: 'Customer Cloud Mail Admin',
  address: 'info@dxlabo.com'
};

件名と本文です。リクエストボディで指定できるようにしても良いですが、今回は固定にしました。

const subject = 'テストメール';
const text = `このメールはテストメールです。
改行を入れます。

----
フッターです
`;

Customers Mail Cloudにリクエストする内容を作ります。環境変数を使います（指定法は後ほど紹介します）。

const params = {
  api_user: process.env.API_USER,
  api_key: process.env.API_KEY,
  to: to,
  from: from,
  subject: subject,
  text: text
};

そしてメール送信APIを呼び出します。この処理は Node.jsでメールを送信する で書いている通りです。

try {
  // 送信処理
  const result = await request
    .post(process.env.ENDPOINT)
    .send(params);
  res.send(result.body);
} catch (e) {
  // エラーの場合
  res.status(503).send(e);
}

デプロイする

Cloud FunctionsへのデプロイはWebブラウザで行います。CLIで行うこともできます。index.jsやpackage.json、node_modulesをまとめて圧縮してアップロードします。

f:id:moongift:20190807155441p:plain
コードのアップロード

環境変数を指定するのを忘れないでください。今回は次の通りです。

環境変数名 値
API_USER APIユーザ名
API_KEY APIキー
ENDPOINT APIのエンドポイントURL

いずれもCustomers Mail Cloudで取得されるものです。

メール送信を試す

では実際にメールを送信してみます。

curl -X POST -H "Content-Type: application/json" \
  -d '{"name":"テストカスタマー", "email":"user@stmpd.jp"}' \
  https://us-central1-example.cloudfunctions.net/mail

問題なければ以下のように結果が返ってきます。

{"id":"<2106857532.1251.1565150810829@mta02.sandbox.smtps.jp>"}

まとめ

Cloud Functionsは手軽に連携できます。Customers Mail Cloudと組み合わせることで、サーバレスでのメール送信が簡単にできます。ぜひお試しください！

クラウドからのメール送信を簡単に。確実に。| Customers Mail Cloud