※ 筆者はCustomers Mail CloudのDevRel(開発者向けマーケティング)をサポートしています
Customers Mail Cloudはメール送信サービスを提供しています。SMTPまたはWeb APIによるメール送信が可能で、送信自体の実装は難しくありません。今回はNode.jsを使ってNCMBのスクリプト機能からメール送信を行ってみます。
コードに関する解説
Customers Mail CloudでドメインおよびAPIユーザの設定を行うと、次の3つの情報が入手できます。
- APIユーザ名
- APIキー
- APIエンドポイントURL
APIエンドポイントURLは契約によって異なります。
実装の流れ
まずはメール送信に関する変数を設定します。メールの送信元は固定値で設定して問題ないでしょう。
const url = 'https://sandbox.smtps.jp/api/v2/emails/send.json'; const api_user = 'api@ncmb.jp'; const api_key = 'PASSWORD'; const from = { name: 'Customer Cloud Mail Admin', address: 'info@ncmb.jp' };
Web APIを呼び出すライブラリはスクリプト機能で標準として用意されているSuperagentを使います。
const request = require('superagent');
そしてスクリプトで呼び出される下記メソッド内に実装していきます。
module.exports = async (req, res) => { // この中に実装していきます }
送信先はPOSTメソッドのパラメータ(ボディ)で指定できるようにします。
const to = [{ name: req.body.name, address: req.body.to }];
件名、本文は変数化してもいいですが、今回は固定値にしています。
const subject = 'テストメール'; const text = `このメールはテストメールです。 改行を入れます。 ---- フッターです `;
そしてパラメータをまとめます。
const params = { api_user, api_key, to, from, subject, text };
後はHTTP POSTリクエストするだけです。
try { // 送信処理 const result = await request .post(url) .set('Content-Type', 'application/json') .send(params); res.send(result.body); } catch (e) { // エラーの場合 console.error(JSON.stringify(e)); }
これで問題なければ、次のようなレスポンスが返ってきます。
{ "id":"\u003C1867844705.17288.1575893073288@mta01.sandbox.smtps.jp\u003E" }
まとめ
const url = 'https://sandbox.smtps.jp/api/v2/emails/send.json'; const api_user = 'api@ncmb.jp'; const api_key = 'PASSWORD'; const from = { name: 'Customer Cloud Mail Admin', address: 'info@ncmb.jp' }; const request = require('superagent'); module.exports = async (req, res) => { // この中に実装していきます const to = [{ name: req.body.name, address: req.body.to }]; const subject = 'テストメール'; const text = `このメールはテストメールです。 改行を入れます。 ---- フッターです `; const params = { api_user, api_key, to, from, subject, text }; try { // 送信処理 const result = await request .post(url) .set('Content-Type', 'application/json') .send(params); res.send(result.body); } catch (e) { // エラーの場合 console.error(JSON.stringify(e)); } }
スマートフォンアプリであってもメール送信したいというニーズはよく出てきます。Customers Mail Cloudは実装も簡単なので、お勧めです。ぜひ試してみてください。