Webhook APIを使って添付ファイル付きメールを処理する（PHP編）

Customers Mail Cloudではプログラム側からデータを取得したり、メールを送信するWeb APIの他に、Customers Mail Cloudでメールを受信した時にイベントを伝えてくれるWebhook APIが用意されています。

Webhook APIを使うことで、自前でメールサーバを立てずにメール受信のタイミングでシステムを起動させられるようになります。メールサーバを安定して動作させ続けるのはメンテナンスコストが大きいですが、Customers Mail Cloudを使うことで簡単にメールと連携したシステムが作れるようになるでしょう。

今回はPHPを使ってメールを処理する流れを紹介します。

フォーマットはJSONとマルチパートフォームデータ

Webhookの形式として、JSONとマルチパートフォームデータ（multipart/form-data）が選択できます。この二つの違いは、添付ファイルがあるかどうかです。JSONの場合、添付ファイルは送られてきません。メールに添付ファイルがついてくる可能性がある場合は、後者を選択してください。

f:id:moongift:20200227212807p:plain — Webhook設定ダイアログ

今回は添付ファイル付きのメールを処理してみます。

サーバ側のコード

PHPで作ったサーバ側のコードは次のようになります。今回は送られてくるデータをそのままダンプしています。添付ファイルはテンポラリファイルとして送られてきますので、任意の場所にコピーすればOKです。

<?php
$fp = fopen('php://stdout', 'w');
fprintf($fp, print_r($_POST, true));
fprintf($fp, print_r($_FILES, true));

具体的なデータ構造は次のようになっています。

Array
(
    [server_composition] => sandbox
    [filter] => filter@smtps.jp
    [headers] => [{"name":"Return-Path","value":"\u003Cadmin@smtps.jp\u003E"},...]
    [subject] => 添付ファイルテスト
    [envelope-from] => admin@smtps.jp
    [envelope-to] => attach@smtps.jp
    [text] => メッセージの本文です。
    [html] => <div dir="ltr">...</div>
    [attachments] => 2
)

添付ファイルはattachmensに添付ファイルの数、attachment1、attachment2にそれぞれ添付ファイルの内容が入ってきます。$_FILEの構造は次のようになります。

Array
(
    [attachment1] => Array
        (
            [name] => package.json
            [type] => application/json
            [tmp_name] => /private/.../phpmXzCIX
            [error] => 0
            [size] => 266
        )

    [attachment2] => Array
        (
            [name] => LICENSE
            [type] => application/octet-stream
            [tmp_name] => /private/.../phpp0PXrl
            [error] => 0
            [size] => 1092
        )

)