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

はじめに

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

今回はTwilio Syncを使って、Twilio上で簡易的なDB機能を実現するためのライブラリをご紹介します。

TwilioSyncLibrary for TwilioCLI

Twilio CLI Serverless で Twilio Sync を簡単に扱うためのライブラリです。
Assets 内のプライベートファイルとして利用します。

Twilio Sync とは？

Twilio Sync
複数のデバイス間で情報を同期させるためのサービス
WebSocketやSocket.ioのようなリアルタイム通信プラットフォーム
Syncは、受け取ったデータをTwilio上に保存してから配信する
Sync上のデータは、TTLオプションにより生存時間を設定できる
Document / List / Map / Message Stream の4種類のデータを扱うことが可能（本ライブラリではMessage Streamには非対応）

扱えるオブジェクトタイプの種類

Documentオブジェクト
単一のJSON形式オブジェクト
オブジェクト名は最大320文字
1データのサイズは最大16KB
単純な値のPUB/SUBに向いている
履歴を取るような使い方には向いていない
利用例：コールセンターでオペレータの稼働確認など
Listオブジェクト
格納順が保証されたJSONリスト
オブジェクト名は最大320文字
1データのサイズは最大16KB
最大格納レコード数は1,000,000
時系列で確認したい履歴を取るような使い方に向いている
利用例：ログの保存など
Mapオブジェクト
格納順が保証されないKey/Value形式のJSONデータ
オブジェクト名は最大320文字
1データのサイズは最大16KB
最大格納レコード数は1,000,000
Keyで検索して、内容を記録するような使い方に向いている
利用例：オペレータの内線番号やスキルなどの登録など

その他の制限事項については、こちらをご確認ください。

Libraryを使って実現できる機能

Twilio Functions から簡単にTwilio Sync のオブジェクトを生成したり、データを書き込んだり、更新・削除が可能です。これにより、Twilio内部でデータベースのような機能を実現することができます。
なお、本ライブラリでは、Message Streamオブジェクトについて対応していません。

必要要件

package.jsonより抜粋

"devDependencies": {
    "assert": "^2.0.0",
    "dotenv": "^8.2.0",
    "jest": "^25.4.0",
    "twilio-run": "^2.7.0"
},
"dependencies": {
  "twilio": "^3.46.0"
}

これ以外に、twilio CLI 2.1.0以降が必要です。

インストール

適当な作業ディレクトリにライブラリをCloneします。

% git clone https://github.com/mobilebiz/twiliosync-library.git
（省略）
Unpacking objects: 100% (35/35), done.
% cd twiliosync-library
% tree
.
├── README.md
├── __tests__
│   ├── TwilioSyncDoc.js
│   ├── TwilioSyncList.js
│   └── TwilioSyncMap.js
├── assets
│   └── twilioSync.private.js
├── functions
│   ├── twilioSyncDoc.js
│   ├── twilioSyncList.js
│   └── twilioSyncMap.js
├── package-lock.json
└── package.json

3 directories, 10 files

次に、別の作業ディレクトリに移動してから、Twilio CLIを使って Twilio Sync サービスを作成します。

% twilio api:sync:v1:services:create --friendly-name [サービス名]

SID                                 Unique Name  Friendly Name
ISe530cd01d9fa91a6b6e21d8e1b18e4ad  null         サービス名

作成した際に表示される SID　（ISから始まる文字列）を控えておきましょう。

つぎに、 Serverless プロジェクトを作成してください。

% twilio serverless:init --template blank [プロジェクト名]
（以下略）
% cd [プロジェクト名]
% cp .env.sample .env

次に、先程cloneしたプロジェクト内にある.env.sampleを参考に、ご自分の作業ディレクトリにある.envの内容をご自分の環境に合わせて変更します（ACCOUNT_SIDとAUTH_TOKENは自動で設定されています）。

変数名	説明
ACCOUNT_SID	Twilio CLIで生成された値（SKから始まる文字列）
AUTH_TOKEN	Twilio CLIで生成された値
MASTER_ACCOUNT_SID	TwilioのAccountSid（ACから始まる文字列）←新設
SYNC_SERVICE_SID	先程作成した Twilio Sync の SID（ISから始まる文字列）←新設

次に、NPMパッケージをインストールします。

% npm install

最後に、先程cloneしたプロジェクトの assets フォルダ内にあるtwilioSync.private.jsをご自分の Twilio CLI Serverless 作業ディレクトリ内の assets にコピーしてください。

Usage

Documentオブジェクト

createDocument(docName, data, ttl)：Documentオブジェクトの生成
getDocument(docName)：Documentオブジェクトの取得
removeDocument(docName)：Documentオブジェクトの削除
removeDocumentById(documentId)：Documentオブジェクトの削除（ID）
searchDocument(docName)：Documentオブジェクトの検索
updateDocument(docName, data, ttl)：Documentオブジェクトの更新

Listオブジェクト

createList(listName, ttl)：Listオブジェクトの生成
getList(listName)：Listオブジェクトの取得
searchList(listName)：Listオブジェクトの検索
removeList(listName)：Listオブジェクトの削除
removeListById(listId)：Listオブジェクトの削除（ID）
addListItem(listName, data, ttl)：Listアイテムの追加
getListItem(listName, key)：Listアイテムの取得（keyを指定しないと全アイテム）
removeListItem(listName, key)：Listアイテムの削除

Mapオブジェクト

createMap(mapName, ttl)：Mapオブジェクトの生成
getMap(mapName)：Mapオブジェクトの取得
searchMap(mapName)：Mapオブジェクトの検索
removeMap(mapName)：Mapオブジェクトの削除
removeMapById(mapId)：Mapオブジェクトの削除（ID）
setMapItem(mapName, key, data, ttl)：Mapアイテムの更新（なければ追加）
getMapItems(mapName)：すべてのMapアイテムを取得
getMapItem(mapName, key)：keyが一致するMapアイテムの取得
removeMapItem(mapName, key)：Mapアイテムの削除

使い方のサンプルは、本プロジェクトの functions フォルダ内にある twilioSyncDoc.js twilioSyncList.js twilioSyncMap.js をご覧ください。

Note

たとえば、電話番号をドキュメント名として作成し、電話番号に付随する情報をデータとして格納していくことで、簡易的な電話帳として使うなどの応用が可能かとおもいます。

※現在のバージョンでは、排他制御は考慮していません。

まとめ

Twilioには FaaSのFunctionsや、StorageのAssetsなどがありますが、データベース機能がないのが難点でした。
Twilio Syncを使えば、外部のDBを使わなくても簡易的なDB機能が実現できるので、ぜひ使ってみてください。

Twilio（トゥイリオ）とは

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

自己紹介

高橋克己（Katsumi Takahashi）
グローバル・インターネット・ジャパン株式会社　代表取締役
株式会社KDDIウェブコミュニケーションズ　Twilio事業部エバンジェリスト

2001年より大手通信事業者の法人サービスの教育に携わり、企業における電話のしくみや重要性を研究。2016年よりTwilio事業部にジョインし、Twilioを使ったスマートコミュニケーションの普及活動を精力的に行っている。