TwilioでFAX送信 #C#

※追記：2021年12月でFAX機能は終了するようです。
https://support.twilio.com/hc/en-us/articles/1260800821230-Programmable-Fax-Migration-Guide-for-Documo-mFax

日本ではまだまだFAXの利用率が高いと聞きますが，私が社内SEとして勤める業界でもFAXはメール以上に利用されている状態です。それで弊社では業務システムから直接FAXを送信できるような仕組みを構築しています。現状としては社内でFAXサーバーを運用しているものの，APIが充実している気が利いた外部のサービスはないものかと時々情報収集していました。そして最近見つけたのが以下の記事です。

ついに発表！ FAX 機能リリース（twilioブログ）
https://twilio.kddi-web.com/blog/developer/entry000307.html

料金（暫定）

料金については暫定ということで以下のように記載されています。以前にAPIが使える国内のFAXサービスをいくつか調べてみたことがありますが，だいたい1通あたり20円くらいはしました。この暫定料金であれば（送信するファイルにもよりますが）1通あたり6.9円ということになるので，業務で使えるレベルのコストではないかと思いました。

完全従量課金
￥1.5／ページ + 通信料（エラスティックSIP トランキングの料金に準ずる。日本では固定電話宛5.4円／分）
月あたり100ページまで無料（通信料はかかります）

番号取得

FAX用に番号を購入します。日本の番号でもFAXは使えるようです。

APIを使ってみる

最近愛用しているInsomniaを使ってREST APIを試してみます。仕様はこちら。
URLはベーシック認証をURLに組み込んだものを使います。

URL
https://{ACCOUNT SID}:{AUTH TOKEN}@fax.twilio.com/v1/Faxes

Header
Conetent-Type: multipart/form-data

twilioからアクセス可能な場所にPDFファイルを置いておき，そのURLを MediaUrl として設定します。PDFファイルのアップロードはできないようなので，実際に業務で利用する場合にはベーシック認証を設定した場所に置くことになりそうです。

Body
To: {送信先FAX番号}
From: {さっき取得した番号}
MediaUrl: {インターネット上に置いておいたPDFファイルのURL}

これで送信すると，あっさりFAXが送信でき，レスポンスが返ってきました。

{
    "media_sid": null,
    "status": "queued",
    "direction": "outbound",
    "from": "+8150********",
    "date_updated": "2017-12-24T09:54:37Z",
    "price": null,
    "account_sid": "***",
    "to": "+81***",
    "date_created": "2017-12-24T09:54:37Z",
    "url": "https://fax.twilio.com/v1/Faxes/FXae********************",
    "sid": "FXae********************",
    "duration": null,
    "num_pages": null,
    "quality": "fine",
    "price_unit": null,
    "api_version": "v1",
    "media_url": null,
    "links": {
        "media": "https://fax.twilio.com/v1/Faxes/FXae********************/Media"
    }
}

送信したFAXの情報は以下のURLを使ってGETで取得できます。FaxSidは送信時に返ってきたレスポンスに含まれています。

URL
https://{ACCOUNT SID}:{AUTH TOKEN}@fax.twilio.com/v1/Faxes/{FaxSid}

先程送信したFAXの情報を試しに取得してみます。無事送信できているようです。コストも取得できますし，送信したPDFを取得できるURLも記載されています。ちなみに，まだ100ページ以内なので通信費のみになっていますね。

{
    "media_sid": "ME**************************",
    "status": "delivered",
    "direction": "outbound",
    "from": "+8150*******",
    "date_updated": "2017-12-07T09:55:17Z",
    "price": "-5.4",
    "account_sid": "AC*************************",
    "to": "+81********",
    "date_created": "2017-12-07T09:54:37Z",
    "url": "https://fax.twilio.com/v1/Faxes/FXae********************",
    "sid": "FXae********************",
    "duration": 24,
    "num_pages": 1,
    "quality": "fine",
    "price_unit": "JPY",
    "api_version": "v1",
    "media_url": "https://media.twiliocdn.com/fax/...........",
    "links": {
        "media": "https://fax.twilio.com/v1/Faxes/FXae********************/Media"
    }
}

C#で送信する

まずnugetでTwilioライブラリをインストールします。

公式ドキュメントにサンプルコードが記載されているのでアカウント情報，FAX番号，PDFのURLを設定すれば動きます。

// 公式ドキュメントから引用
// https://jp.twilio.com/docs/api/fax/rest/faxes#list-post
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Fax.V1;
using Twilio.Types;
using System.Collections.Generic;

class Example
{
    static void Main(string[] args)
    {
        // Find your Account Sid and Auth Token at twilio.com/console
        const string accountSid = "AC*************************";
        const string authToken = "your_auth_token";
        TwilioClient.Init(accountSid, authToken);

        var to = "+81***";
        var mediaUrl = new Uri(
            "https://www.twilio.com/docs/documents/25/justthefaxmaam.pdf");

        var fax = FaxResource.Create(to, mediaUrl, from: "+8150********");

        Console.WriteLine(fax.Sid);
    }
}

デバッグで返り値の中を確認してみます。Sidを取得できました。

感想

APIやライブラリが活用できるのでFAX機能を実装するのがとても楽です。処理も速く，料金も安いので魅力的なサービスだと思います。PDFファイルをローカルから直接アップロードできないので，そこは一仕事しないといけないかなと思います。もう少し試してみて，FAXサーバーに代わる選択肢として考えてみたいところです。