1. HOME
  2. ブログ
  3. IT技術
  4. twilioのbundle登録をtwilio-php APIで実装

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で登録する流れのイメージ

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

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

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

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

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

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

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

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

それぞれのパラメータには自身のtwilio登録情報や購入したい電話番号の種類等を入れます。

次に2のエンドユーザーを作成をします。

次にドキュメントの作成ですがその前にまた下準備をします。
各ドキュメントには法人の住所か代表者の住所及びその両方を入れる必要があるので、
この2つの住所をこれまたtwilioのライブラリで作成します。

下準備も終わったのでいよいよ3のドキュメント作成していきます。
実はここではライブラリを使わずに直接APIを叩きます。
ドキュメントのファイルデータを送信する必要があり、この作業だけはtwilioのライブラリでは提供されていないためです。
私はLravelを使って開発していたので今回LaravelのHttpファサードを使ってAPIを叩きます。
本来は5つのドキュメントを作成しますが同じようなコードになるので、今回は登記簿謄本の作成のみコードを載せます。

次は4です。作成したエンドユーザーとドキュメントをRegulatory Bundleにアサインします。

それでは最後に5のRegulatory Bundleのステータスを「レビュー待ち」状態にします。

これで作業は完了です。後はtwilioが承認するのを待つのみです。
今回使ったtwilio-php のライブラリのgithubのURLも添付しておきます。
https://github.com/twilio/twilio-php
お疲れ様でした!!

関連記事

採用情報

\ あの有名サービスに参画!? /

バックエンドエンジニア

\ クリエイティブの最前線 /

フロントエンドエンジニア

\ 世界を変える…! /

Androidエンジニア

\ みんなが使うアプリを創る /

iOSエンジニア