Twilio Flexの始め方（国内番号購入編）

:::note alert
2023年5月1日を持ちまして、株式会社KDDIウェブコミュニケーションズのTwilioリセール事業が終了したため、本記事に記載されている内容は正確ではないことを予めご了承ください。
:::

# はじめに

<font color='blue'>2022-02-24 法人番号に対応</font>

みなさん、こんにちは。
KDDIウェブコミュニケーションズの Twilio事業部エバンジェリストの高橋です。

[Twilio Flex Advent Calendar 2021](https://qiita.com/advent-calendar/2021/twilio-flex) 5日目の記事となります。
[前回](https://qiita.com/mobilebiz/items/d06a29214b437339d226)は、Twilio Flexのセットアップについて解説しました。セットアップ直後は、US番号が自動的に購入された状態になっているため、この記事ではこのあとの作業や実際の運用で必要となる日本の番号を取得する方法について説明します。
なお本記事は、TwilioアカウントをKDDIウェブコミュニケーションズ（以下、KWC）経由で開設したときのもので、Twilio Japan経由で開設した場合とは手順が異なります。
<font color='red'>2022年1月現在の内容となりますので、実際のオペレーションとは異なる可能性があります。</font>

# 日本の番号を購入するための条件

現在、日本で電話番号を購入するためにはいくつか条件が必要になります。

- 法人契約であること（現在、個人契約では日本の番号は購入できません）。
- KWCとの取引時確認が済んでいること（このあと説明します）。
- ~~会社情報の確認に必要な以下のいずれかの書類が準備できること。~~
    - ~~登記簿謄本（履歴事項証明書）※1~~
    - ~~登記簿謄本（現在事項証明書）※1~~
    - [法人番号](https://www.houjin-bangou.nta.go.jp/)での申請が可能になりました
- 本人確認に必要な以下のいずれかの書類が準備できること。
    - 運転免許証
    - パスポート※2
    - 個人番号カード（マイナンバーカード）表面
    - 住民基本台帳カード（顔写真あり）
    - 在留カード
    - 運転履歴証明書
    - 特別永住者証明書
- 契約担当者が会社の代表取締役や代表社員出ない場合は、委任状※3が準備できること。
- Twilioの管理コンソール上でBundlesの登録がされていること（このあと説明します）。

※1 発行日が６ヶ月以内のもの
※2 所持人記入欄（住所欄）があるもの（2020年2月4日より前に発行されているもの）
※3 委任状の雛形は[こちら](https://skillful-pancake-7200.twil.io/assets/PowerOfAttorneyTemplate.docx)

# 取引時確認

取引時確認とは、Twilioアカウントを開設するにあたって、取引契約主体となるTwilio契約者とKWCの間で発生する作業となります。

## 取引時確認を行う理由

電話番号が特殊詐欺等の犯罪に使われることを防ぐ「犯罪収益移転防止法」に準拠するため、Twilio をご利用いただく際に法人のお客様の本人確認書類のご提出が必要となっています。

## どのタイミングで行うのか

[こちらのサイト](https://cloudapi.kddi-web.com/signup)からTwilioアカウントを開設すると、数日中に「【Twilio:本人確認】犯罪収益移転防止法に基づく取引時確認書類ご提出のお願い」という件名のメールが届きます。詳しい手続方法は、そちらのメールにも記載がありますが、アカウント開設後であればメールが届かなくても手続きは始めることが可能です。

## 手続きをしないとどうなるのか

メールに記載の期限内に手続きを行わない場合、<font color='red'>アカウントはサスペンドされます。</font>

## 手続方法

先程紹介した資料が手元にあることを確認してください。
今回は、契約担当者が代表者である場合として、運転免許証が手元にあるものとして説明します。

### 手続きサイトへの接続

以下のURLをブラウザで開きます。
https://cloudapi.kddi-web.com/identification/

### 申し込み種別の選択

![スクリーンショット 2021-12-14 16.48.04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/ae4a0bbb-ff8e-35d1-cfec-6738d4a4cd01.png)

- **法人として申し込み**を選択します。

### Twilioログイン情報の入力

![スクリーンショット 2021-12-14 16.50.46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/b3a59aab-0dd5-9200-e33a-1a0a329271c2.png)

- **AccountSID**はACから始まる文字列で、KWCから届いたメールに記載があります。Twilio管理コンソールのダッシュボードでも確認することができます。
- **Twilioコンソールログイン用メールアドレス**には、Twilioのアカウントを作成したときのメールアドレスを入力します。KWCからのメールにも記載があります。

### 申請者情報の登録

![スクリーンショット 2021-12-14 16.58.02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/dbd1476f-8155-39e6-6917-12053704884b.png)

- **申請者名**には、契約担当者（代表者の場合は代表者）の名前を入力します。契約担当者が代表者でない場合は、契約担当者の情報になりますので、ご注意ください。
- **申請者 生年月日**には、契約担当者の生年月日を入力してください。公的証明書と一致している必要がありますので注意してください。
- **申請者 ご住所**には、契約担当者の情報を入力してください。<font color='red'>特に住所の表記が公的証明書と一致</font>している必要があります。運転免許証で住所の書き換えをしている場合は、最新の住所を記載してください（後ほど免許証の裏面が確認されます）。

### 内容・目的の登録

![スクリーンショット 2021-12-14 17.06.09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/99cefb51-7f73-de82-0ef2-7a7a066f050f.png)

- **Twilioの利用目的**には、今回Twilioをどのように利用したいのかを記載します。たとえば「Twilio Flexを自社のコールセンターで利用するため」のように記載します。
- **ハイリスク取引への非該当**に記載されている内容を確認しチェックをしていきます。チェックができない項目があった場合は、追加資料の提出が必要になります。具体的な資料等については追って連絡が届きます。
- **取引内容**は、Twilioを使用した取引で200万円以上の財産の移転を伴う場合にチェックします。これはTwilioの利用ではなく、Twilioを使った取引（たとえば、TwilioのSMSを送信することで200万円以上の取引が成立するようなケース）に関するものです。

### 組織情報の登録

![スクリーンショット 2022-01-24 8.10.32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/81322dca-4aa6-9b41-952a-01515d2f4965.png)

- **会社情報**の会社名には、会社名を記載します。
- **部署名**は、契約担当者の部署を記載します（代表者の場合は不要です）。
- **申請者 役職**は、契約担当者の役職を記載します。
- **代表者取締役名**には、代表者取締役の名前を記載します。
- **所在地**は、[法人番号サイト](https://www.houjin-bangou.nta.go.jp/)で検索した結果と同じ住所を記載します。

### 実質的支配者の登録

![スクリーンショット 2021-12-14 17.40.12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/5a6b79da-240a-bf6d-faa0-d175ff80a012.png)

- 契約企業が、国、地方公共団体、独立行政法人、国立大学法人、上場企業、上場企業子会社のいずれかに該当するかどうかで選択を切り替えてください。
- これらに該当しない企業の場合は、代表者の情報が必要です。

- **確認画面へ**のボタンを押します。
![スクリーンショット 2021-12-14 17.49.16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/34599ec3-7099-b790-2dfb-0b875697a463.png)

引き続き、本人確認書類をアップロードしていきます。書類が手元にない場合は一旦下書き保存をしておき、後日アップロードすることもできます。なお、<font color='red'>下書き保存は２週間しかできません</font>ので、ご注意ください。

### 申請者本人情報のアップロード

![スクリーンショット 2021-12-14 17.51.50.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/e9b21fd8-a46f-3573-cdf1-bec396228a6c.png)

- **申請者 身元確認プランの提出を行う**ボタンを押します。

![スクリーンショット 2021-12-14 17.53.34.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/0e0206e0-41d0-b82a-f324-a9813655e36b.png)

本人情報のアップロードには、「TRUSTDOCKアプリで提出する」か、「WEBカメラで撮影する」の二種類が選択できます。TRUSTDOCKアプリとはスマートフォン用の専用アプリケーションで、スマートフォンにインストールしておく必要があります。WEBカメラはPCなどに接続しているカメラを使ってアップロードができるものです。
WEBカメラのほうが手軽でよさそうに見えますが、解像度の低いカメラだと申請ができないこともあるので、スマートフォンをお持ちの方はTRUSTDOCKアプリを利用したほうがよいかと思います。

今回はTRUSTDOCKアプリを使った提出を選択します。

![スクリーンショット 2021-12-14 17.54.07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/ea185894-dc33-f1d8-f6d2-5f2ef73633c7.png)

- 画面に表示されたQRコードをスマートフォンで読み取ります。
- アプリがインストールされていない場合はアプリストアに移動するので、アプリのインストールから行います。すでにアプリがインストールされている場合は以下のような画面が表示されます。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/55be6ad5-e460-915c-9eed-da29034ee284.png" width="300px">

- **OPEN**ボタンを押すとアプリが開きます。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/2c59bcf1-6e89-a65b-03fa-8ed5ecd0e784.png" width="300px">

- **認証する**ボタンを押します。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/b05fce77-addc-144f-b90b-e0975f887b93.png" width="300px">

- **手続きを始める**ボタンを押します。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/54d8c0a6-e14b-2238-f7b3-49cccde4a94c.png" width="300px">

- 今回は**運転免許証**を選択します。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/1c8b6734-988a-53b5-313f-a08251bb551d.png" width="300px">

この後は記載されている指示通りに撮影をしていきます。
書類を指で持ってしまうと、その部分が欠落してしまって認証に失敗しますので注意が必要です。図にあるように、手のひらに載せて撮影するようにしてください。

以下のような画面が表示されれば書類の提出は完了です。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/4487ae0b-a555-836b-709d-b260df222895.png" width="300px">

ここまでの処理が完了すると、PC側のブラウザが自動的に以下のように遷移します。

![スクリーンショット 2021-12-14 18.00.07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/4ab9fbf5-44f0-3569-6b6f-031fd1a652b8.png)

- **閉じる**ボタンを押します。

### 法人身元確認資料の提出

次に法人の身元確認を行います。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/cca393d7-f6fa-c126-3309-0d123f47847a.png)

- **法人番号を入力する**をチェックします。

![スクリーンショット 2022-02-07 14.04.26.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/efabc22a-c28e-4a28-a23a-1de26fcc9bd4.png)

- **法人番号を入力する**ボタンを押します。

![スクリーンショット 2022-02-07 14.05.35.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/20fb5dea-f4bc-1b43-6407-7d713e6d30a5.png)

- 法人番号（13桁）を入力します。
- **法人番号を送信する**ボタンを押します。
- **閉じる**ボタンを押します。

- **次へ**ボタンを押します。
- 以下の画面が表示されたら、申請作業は一旦終了です。

![スクリーンショット 2022-02-07 14.06.36.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/cb85d7c6-9381-2182-4e76-7f9948b76b0d.png)


![スクリーンショット 2021-12-14 18.04.08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/a7121db2-b69f-a500-b875-fbb3a662b03e.png)

## 申請完了メールの確認

資料の申請がすべて完了すると、以下の２通のメールが届きます。

- 【Twilio/KDDI-Web】取引時確認_申請者身元確認書類(公的身分証、セルフィー) 受付ました
- 【Twilio/KDDI-Web】取引時確認_法人番号 受付ました

先程の個人情報の認証が完了すると、次に法人確認書類の発送が行われます。これは法人の住所が存在するかを確認するためで、簡易書留が転送不可で送られてきますから、必ず現地もしくは郵便局で受け取る必要があります。
ただし、法人の代表者が申請した場合は郵送による確認は不要となりますので、郵送はされません。

以上のように、取引時確認が完了するまでには、少なくとも3〜5営業日程度かかります。

# Bundles

今まで設定してきた「取引時確認」は、KWCと皆さんの間でかわされる契約に関するものです。
これとは別に、日本国内の番号をTwilio上で購入するためには、Twilioとの間でも個人情報の確認処理が必要になります。これは「Bundles」と呼ばれています。

Bundlesの申請方法については、[こちら](https://f.hubspotusercontent00.net/hubfs/6881002/%E3%81%8A%E7%9F%A5%E3%82%89%E3%81%9B%E9%96%A2%E9%80%A3/20210805_%E6%96%B0%E8%A6%8FBundle%E3%81%8C%E4%BD%9C%E6%88%90%E3%81%A7%E3%81%8D%E3%81%AA%E3%81%84%E4%BA%8B%E8%B1%A1%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6/Bundles%E7%94%B3%E8%AB%8B%E6%89%8B%E9%A0%86_20210826.pdf)に詳しい手順が書かれていますので、参考にしてください。

Bundlesの承認が完了すると、Twilio管理コンソール上には以下のように「Twilio Approved」と表示されます。
![スクリーンショット 2021-12-19 8.03.11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/696b240e-cdff-d991-34f4-fe5e6791acd1.png)

# 電話番号の購入

Bundlesが承認されると、始めて国内番号が購入できるようになります。

- Twilio管理コンソールの左側のスライドメニューから、**Phone Numbers**を選択します。
- **番号を購入**を選択し、**Country**のプルダウンから「(+81)Japan - JP」を選択します。

![スクリーンショット 2021-12-19 9.15.15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/bac73c47-4f66-f298-a5bf-9e2a731be452.png)

- 購入できる番号のリストが表示されるので、+8150 から始まる番号の**Buy**ボタンを押します。

![スクリーンショット 2021-12-19 9.17.50.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/ed3139e8-cc06-a92e-8e12-77ffe94ced44.png)

- **Next**ボタンを押します。

![スクリーンショット 2021-12-19 9.19.19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/ce6cd45c-db21-a11b-9e4e-eb1b70398192.png)

- **Business**を選択します（現在、日本の番号は法人でないと購入できません）。
- **Next**ボタンを押します。

![スクリーンショット 2021-12-19 9.21.55.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/d88b62ef-1b64-ac9d-7ce8-b3b1c6047b8e.png)

Bundlesの承認がされていないとこのページから先には進めません。
- **Assign approved Bundle**のプルダウンから承認されたBundlesを選択します。
- **Assign Address**のプルダウンでは法人の住所を選択します。
- **Buy +8150xxxxxxxx**ボタンを押します。

![スクリーンショット 2021-12-19 9.26.37.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/9c149997-5f05-2d45-fffd-6eceea96eba9.png)

- 購入が完了しましたので、**Configure +8150xxxxxxxx**ボタンを押します。

![スクリーンショット 2021-12-19 9.29.03.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/be64081a-c3df-89a6-6496-53ab0763b786.png)

- **A CALL COMES IN**を「Studio Flow」にして、右側のプルダウンから「Voice IVR」を選択します（すでに他のIVRフローを作っている場合はそちらでの構いません）。
- **Save**ボタンを押します。

では最後に、購入した番号に電話をかけて、正しくFlexに接続できることを確認してください。

# まとめ

2021年現在、世界的に電話を使った犯罪が多発しており、ほとんどの国で番号の購入には厳しい本人確認が義務付けられています。
日本国内でも、通信事業者に対しては取引時確認の徹底が法令で定められており、どうしても煩雑な手続きが必要となります。書類の準備などに時間がかかることもあるので、番号を購入する際には時間的な余裕をもって対応していただくようにお願いいたします。

★次の記事
[Twilio Flexの始め方（IVR編）](https://qiita.com/mobilebiz/items/4906a2d37607e1082808)

---
### Twilio（トゥイリオ）とは

https://cloudapi.kddi-web.com
Twilio は音声通話、メッセージング（SMS /チャット）、ビデオなどの 様々なコミュニケーション手段をアプリケーションやビジネスへ容易に組み込むことのできるクラウド API サービスです。初期費用不要な従量課金制で、各種開発言語に対応しているため、多くのハッカソンイベントやスタートアップなどにも、ご利用いただいております。

自己紹介|　
:--|:--
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/86046/b51a8b88-abd5-ce5e-195a-de3564ba2ae6.png" height='200' width='150'/>|高橋克己（Katsumi Takahashi） 自称「<font color='red'>赤い芸人</font>」<br />グローバル・インターネット・ジャパン株式会社　代表取締役<br />株式会社KDDIウェブコミュニケーションズ　Twilio事業部エバンジェリスト<br /><br />2001年より大手通信事業者の法人サービスの教育に携わり、企業における電話のしくみや重要性を研究。2016年よりTwilio事業部にジョインし、Twilioを使ったスマートコミュニケーションの普及活動を精力的に行っている。<br />2015 Hall of Doers<br />2019 Twilio Champions