twilioのbundle登録をtwilio-php APIで実装【株式会社ライトコード】

※弊社エンジニアの記事になります。

はじめに

twilioで電話番号を購入する際に「Regulatory Bundle」というものが必要になってきますが、それをtwilioが提供しているAPIで登録したので備忘録的にまとめていきます。

twilioの「Regulatory Bundle」とは

twilioの「Regulatory Bundle」とは電話番号を購入する際に必要な書類や個人または法人の情報をまとめたものです。twilioに限らず電話番号を購入する際はこういった情報が必要なのですが、twilioで電話番号を購入する際は、twilioに「Regulatory Bundle」を提出し承認を得て電話番号を購入する流れとなります。

コンソール画面からポチポチやって登録することもできますが、自動化する方が効率が良くなる場面もあるので今回はtwilioが提供しているライブラリを用いてAPIで登録していきます。

twilioのライブラリを用いて Regulatory Bundle を登録

これからライブラリを用いてRegulatory Bundleを登録していきますがその前に、Regulatory Bundleに含まれている情報の整理とAPIで登録する流れのイメージを共有していきたいと思います。このイメージができていないとコードを見ても何やってるかわからなくなる可能性があります。（体験談）

Regulatory Bundleに含まれている情報

以下の情報が含まれています。

エンドユーザー（登録する個人及び法人の情報）
ドキュメント（上記のエンドユーザーの証明書類）
- 登記簿謄本
- 委任状
- 免許証
- Regulatory Bundle 申請書
- マイナンバーカード

ドキュメントの中身は上記に限らないとは思いますが私が登録する際はこの内容で登録を行ったので今回はこれで行っていきます。

APIで登録する流れのイメージ

以下のイメージで登録していきます。

Regulatory Bundleを作成する
情報を保存するための箱を作るようなイメージでRegulatory Bundleを作成します。
エンドユーザーを作成
Regulatory Bundleに入れるエンドユーザーという情報を作成します。
今回は法人として登録していくので、法人及びその代表者情報をここに入れます。
ドキュメントを作成
Regulatory Bundleに入れるドキュメントを作成します。
先ほどの項目で記載した5つの証明書類を今回は作成します。
2と3で作成したエンドユーザーとドキュメントを１で作成したRegulatory Bundleにアサインする
1で作った箱に2と３で作った情報を入れるようなイメージです。これでRegulatory Bundleの作成が完了します。
4までの流れで作ったRegulatory Bundleのステータスを「レビュー待ち」状態にする。
ステータスを「レビュー待ち」にすることで申請したのと同じ状態になります。
twilioが承認するまで待つ
あとは待つだけです。ここまでの流れで正しい情報で申請できていれば承認してくれます。承認されれば登録完了です。

上記の1~6の流れのイメージで実装していきます。

実際にライブラリを使って実装していく

それではいよいよ実装していきましょう。さっきの流れをコードで書いていくだけです。

まずはtwilioのphpライブラリをインストールしましょう。

$ composer require twilio/sdk

これでインストールが完了したのでコードを書いていきます。
まずは下準備でtwilio Clientインスタンスを作成します。
このインスタンスをこれから使っていきます。

use Twilio\Rest\Client;
 
$accountSid = 'ACxxxxxxxxxxxxxx'; // twilioのAccount SID
$authToken = 'xxxxxxxxxxxxxxxxx';　// twilioのAuth Token
 
$twilio = new Client($accountSid, $authToken);

準備も終わったので1のRegulatory Bundle作成からやっていきましょう。

$bundle = $twilio->numbers->v2->regulatoryCompliance
                        ->bundles
                        ->create(
                            'friendlyName', // Regulatory Bundleに適当に名前をつけます。
                            'email@example', // 自身のメールアドレス
                            [
                                'endUserType' => 'business',
                                'isoCountry' => 'JP',
                                'numberType' => 'national',
                            ]
                        )
                    ;