みなさん、こんにちは。
KDDIウェブコミュニケーションズのTwilio事業部エバンジェリストの高橋です。
Twilio側の仕様変更に伴い従来のアイデンティティがBundlesに変わりました。また、この変更に併せてドキュメントのアップロードを始めとしたAPIドキュメントも公開されています。
注意事項
過去に単独で登録したAddressSidや、AddressSidだけをAPIで登録したものは、Bundlesに紐付けがされてないため電話番号の購入時には利用できません。そのため、この記事にあるように一連の書類とともに再度AddressSidも登録し直す必要がございます。
今回は、Node.jsを使ったプログラムを使って、BundleSidを登録するサンプルを紹介します。
本記事はAPIを使って法人での利用におけるBundlesの登録方法となります。
管理コンソール上からの登録方法については、以下の記事を御覧ください。
【法人のお客様向け】TwilioでBundles(本人認証)の設定を行う
また、個人利用におけるBundlesの登録については、以下の記事を御覧ください。
【個人のお客様向け】TwilioでBundles(本人認証)の設定を行う
【個人のお客様向け】API経由でBundle SIDを登録する
このプログラムは、Twilio(KWCアカウント)におけるBundleSidの登録を自動化するものです。
法人でのBundleSidの登録には、パターンが2種類あります。
パターン1 代表者が申請作業を行うケース
会社の登記簿謄本に名前が記載されている方が申請を行うケースです。
謄本に加えて、この方の身分証明書が必要です。
パターン2 担当者が申請作業を行うケース
会社の登記簿謄本に名前が記載されていない方が申請を行うケースです。
謄本に加えて、申請者の身分証明書と会社が発行した委任状が必要です。
委任状については、こちらにひな形を用意してあるので、別途ダウンロードして記載してください。
記載の際の注意点は、以下のとおりです。
本プログラム以下の条件でのみ動作します。
- 法人での申請
- 会社証明書類として登記簿謄本(全部事項証明書)を用意してあること
- 謄本に記載のない担当者が申請をする場合には、委任状を用意すること
- 申請者の運転免許証を用意してあること
- Node.js(バージョン8以降)がインストールされていること
準備
- 謄本ならびに委任状(必要な場合のみ)をPDF形式で準備してください。複数枚に渡る場合は、5MB以内であれば1つのファイルにまとめても大丈夫です。
- 申請者の運転免許証のコピーをJPEG形式で準備してください(サイズは5MB以内)。 スマホのカメラで撮影したものでも大丈夫ですが、免許証のみが写るように周りの画像は削除してください。
インストール
適当なフォルダに移動し、GitHubリポジトリを取得します(法人用のブランチを利用します)。
$ git clone -b create-bundle-business https://github.com/twilioforkwc/create-bundle.git
$ cd bundle-create
$ npm install
$ mv .env.example .env
謄本、委任状、運転免許証の各ファイルを、imagesフォルダにコピーしておきます。
.env
ファイルをエディタで開き、以下の項目をすべて申請者の内容に置き換えます。
項目名 |
内容 |
ACCOUNT_SID |
TwilioアカウントのAccountSid(ACから始まる文字列) |
AUTH_TOKEN |
AccountSidに対応するAuthToken |
BUSINESS_NAME |
登記簿謄本に記載されいている商号を記載通りに(社名に「・」が入っている場合は、APIがエラーを出すので削除してください) |
BUSINESS_DESCRIPTION |
登記簿謄本に記載されいている会社法人等番号を記載通りに |
BUSINESS_ADDRESS |
登記簿謄本に記載されている本店住所の町村名と丁目番地を記載されている通りに(例:大手町一丁目1番地1号) |
BUSINESS_CITY |
登記簿謄本に記載されている本店住所の市区名を記載されている通りに(例:千代田区) |
BUSINESS_REGION |
登記簿謄本に記載されている都道府県名を記載されている通りに(例:東京都) |
BUSINESS_POSTAL_CODE |
会社の郵便番号をハイフンなしで(例:1000001) |
BUSINESS_ISO_COUNTRY |
会社の住所が日本の場合はJPのままで |
CORPORATE_REGISTRY_FILE |
登記簿謄本のPDFファイル名 |
POWER_OF_ATTORNEY_FILE |
委任状のPDFファイル名(なしの場合は未指定) |
FIRST_NAME |
申請者の名前(名)を免許証に記載されている通りに(日本語OK) |
LAST_NAME |
申請者の名前(姓)を免許証に記載されている通りに(日本語OK) |
BIRTH_DATE |
申請者の誕生日をYYYY-MM-DD形式で |
STREET |
住所(町丁目と建物名)を免許証に記載されている通りに |
CITY |
住所(市区町村)を免許証に記載されている通りに |
REGION |
住所(都道府県)を免許証に記載されている通りに |
POSTAL_CODE |
郵便番号をハイフンなしで |
ISO_COUNTRY |
日本の場合はJPのままで |
DRIVERS_LICENSE_FILE |
免許証の画像ファイル名 |
EMAIL |
申請者のメールアドレス(審査結果が通知されます) |
プログラムの実行
$ npm start
...最初にテストコードが走って`.env`の内容をチェックします。
...テストがすべてPASSすると申請が始まります。
>>> BusinessAddressSid:AD8b1e9d1bb77e15fc6f35cfb655822b7a created.
>>> AddressSid:AD380e6c9d32b880f61295997f57bb9290 created.
>>> BundleSid:BU654cedd57e8d1dbe883b1f6e64f79524 created.
>>> UserSid:IT64d005a291d9d525a2c815d7dd2abcb0 created.
>>> CorporateRegistrySid:RD03c8155f5cdcb714cb526d5c33811212 created.
>>> PowerOfAttorneySid:RD59ee9826f674023d99b6ce63090a4e4a created.
>>> DriverLicenseSid:RDc2cf8e42e765440bcc31ddca255d43e5 created.
>>> Corporate Registry Assign completed.
>>> Power of Attorney Assign completed.
>>> Driver's License Assign completed.
>>> End User Assign completed.
>>> Submitted.
上記のようにSubmitted.
が表示されれば成功です。
管理コンソールにログインし、電話番号 > Regulatory Complience > Bundlesを確認し、STATUSがPending Review
になっていることを確認しましょう。
あとは審査を待つだけです。
しばらくすると(3営業日以内)に、Twilioからメールが届きますので、審査が通れば上記STATUSがTwilio Approved
になります。