2020.02.10

【法人のお客様向け】API経由のTwilio Bundle SID登録方法

みなさん、こんにちは。

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の登録には、パターンが２種類あります。

パターン１　代表者が申請作業を行うケース

会社の登記簿謄本に名前が記載されている方が申請を行うケースです。

謄本に加えて、この方の身分証明書が必要です。

パターン２　担当者が申請作業を行うケース

会社の登記簿謄本に名前が記載されていない方が申請を行うケースです。

謄本に加えて、申請者の身分証明書と会社が発行した委任状が必要です。

委任状については、こちらにひな形を用意してあるので、別途ダウンロードして記載してください。

記載の際の注意点は、以下のとおりです。

本プログラム以下の条件でのみ動作します。

法人での申請
会社証明書類として法人番号申請フォーム、または登記簿謄本（履歴または現在事項全部証明書）を用意してあること
謄本に記載のない担当者が申請をする場合には、委任状を用意すること
申請者の運転免許証を用意してあること
Node.js（バージョン8以降）がインストールされていること

準備

法人番号申請フォーム（または登記簿謄本）ならびに委任状（必要な場合のみ）をPDF形式で準備してください。複数枚に渡る場合は、5MB以内であれば１つのファイルにまとめても大丈夫です。
法人番号申請フォームをご利用の場合はこちらの「法人番号申請フォームひな型」からファイルをダウンロードし、AccountSID、法人名、法人番号をご記載のうえPDFファイルにてご用意ください。
申請者の運転免許証のコピーを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	登記簿謄本に記載されている本店住所の町村名と丁目番地を記載されている通りに（例：大手町一丁目１番地１号）
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になっていることを確認しましょう。

あとは審査を待つだけです。

しばらくすると（３営業日以内）に、Twilioからメールが届きますので、審査が通れば上記STATUSがTwilio Approvedになります。

まとめ

詳しいコードの内容は、ぜひcreateBundle.jsの中身を見ていただければと思いますが、大まかな流れは以下のようになっています。