Neri78の投稿 - Crieit

TwilioQuestオペレーター養成キャンペーン開催

2021-07-07T10:35:50+09:00

Twilio Developer Evangelistの池原です。昨日、TwilioQuest 3 日本語プレビュー版のリリースをアナウンスしましたが、このリリースを記念し、 「TwilioQuestオペレーター養成キャンペーン」 を実施します!

このキャンペーンではTwilioQuest 3日本語プレビュー版をインストールし、特定のミッションをクリアしたプレイヤーを対象として毎週2名の方にApple AirPods Proを進呈します。また、最終週には「TwilioQuestグランドチャンピオンシップ 2021 Summer」を開催します。この、「TwilioQuestグランドチャンピオンシップ 2021 Summer」では制限時間内に獲得した経験値を競うハイスコアチャレンジを実施し、優勝者にはApple M1 Macbook Pro(13インチ)を進呈します!

イベントスケジュールおよび賞品について

各ラウンドのスケジュール、ならびに賞品については下記の通りとなります。

日程 (日本時間)	賞品
ラウンド1: 2021年07月12日(月) - 2021年07月18日(日)抽選日: 2021年07月19日(月)12:00	AirPods Pro x 2名様
ラウンド2: 2021年07月19日(月) - 2021年07月25日(日)抽選日: 2021年07月26日(月)12:00	AirPods Pro x 2名様
ラウンド3: 2021年07月26日(月) - 2021年08月01日(日)抽選日: 2021年08月02日(月)12:00	AirPods Pro x 2名様
TwilioQuestグランドチャンピオンシップ 2021 Summer開催日: 2021年08月06日(金)15:00 - 18:00	M1 macbook pro x 1名様

キャンペーン・イベントへの参加方法

次の手順に従い、キャンペーンにご参加ください。

下記ページからキャンペーン・イベントに登録
TwilioQuestオペレーター養成キャンペーン参加申し込みページ
TwilioQuest日本語プレビュー版をダウンロードし、インストール
TwilioQuest日本語版ページ
TwilioQuestを起動し、登録後にメールアドレスあてに送られるラウンド1-3共通の 「Operation」コード を手順に沿って適用
1. TwilioQuestを起動し、3キーでSettings画面を表示。その後、画面左のナビゲーションからOperationsを選択
2. Join Codeラベル下のテキストフィールドにOperationコードを入力し、Join ボタンをクリック。
Voice: マラカイト鉱山 ミッション を最後までクリア

応募にあたっての注意点

Email欄には必ず TwilioQuestで使用するTwilioアカウントのメールアドレス を入力してください。情報が異なっている場合、キャンペーン条件の達成を確認できないため、抽選の対象外となります。
キャンペーンは日本時間2021年7月12日(月) 00:00:00 から2021年8月1日(日) 23:59:59までの期間となります。この期間外にクリアした場合は 抽選の対象外 となります。
「TwilioQuestグランドチャンピオンシップ 2021 Summer」は2021年8月6日(金)15:00 - 18:00に実施される限定イベントです。登録後にお送りさせていただくURLに当日参加し、オープニングでアナウンスされる グランドチャンピオンシップ専用の「Operationコード」を別途利用いただくことになります。

その他の留意点やよくある質問についてはイベントページをご確認ください。

キャンペーンやTwilioQuestについての質問

キャンペーンやTwilioQuestについて質問がある場合はぜひ、こちらのTwitchチャンネルに登録ください。

Twitch - Neri78

このチャンネルでは下記の日程でTwilioQuest Q&Aストリーミングを開催します。

期間: 7月12日(月) - 8月2日(月)
月曜日(抽選結果発表含む)12:00 - 13:00
水曜日 12:00 - 13:00

あるいはTwilioQuest Discordサーバーでも質問いただけます。

さあ、TwilioQuestプログラムのオペレーターとなってクラウドの平和を守りましょう!

Let’s Hack!

TwilioQuest 3 日本語プレビュー版リリース!

2021-07-06T16:22:21+09:00

Twilio Developer Evangelistの池原です。ゲームを遊びながらTwilio製品の利用方法に加えGitHubやPythonを学習できるTwilioQuest 3の日本語プレビュー版をリリースしました。

TwilioQuestとは?

TwilioQuestはゲームをプレイするようにさまざまな開発スキルを向上できるチュートリアルです。2019年に最新バージョンである「TwilioQuest 3」がリリースされました。Twilio製品の利用方法だけでなく、Pythonのようなプログラミング言語や、GitHubの使い方などを学習できます。

より詳しい説明やミッションの進め方については以前こちらの記事で取り上げていますので、こちらもぜひご覧ください。

全編英語で作成されていますが、ゲーム好きな開発者には非常に人気のコンテンツです。日本でも多くのみなさんにプレイいただいていますが、「日本語版が欲しい」という要望を多くいただいたため今回、日本語版を開発しました。

日本語プレビュー版について

今回のリリースでは下記4つのミッションコンテンツと一部のUIを日本語化しています。

基本トレーニング - TwilioQuestのプレイ方法、ならびにTwilio製品の基本を学べるミッション
Voice: マラカイト鉱山 - Twilio Programmable Voice入門ミッション
Pythonic Templeの謎 - Python入門ミッション
オープンソースの炎 - Git、GitHub入門ミッション

基本的なプレイ方法については英語版と同じですが、ミッション内容については単純な翻訳だけではなく日本の皆さんに向けて加筆・修正を加えています。

ダウンロードおよびインストール方法

TwilioQuestは下記よりダウンロードいただけます。英語版をすでにお持ちの方は改めてダウンロードいただく必要はありません。過去にプレイされた記録はそのまま保持されます。

TwilioQuest - ダウンロード

日本語プレビュー版の起動方法についてはこちらをご覧ください。

Let’s Hack!

ぜひ、日本語版をプレイしてみてください!今後も日本語ミッションの追加、アップデートを予定しています。

日本語版の不具合や質問については下記までお問い合わせください。

Twitter: @neri78
Email: dikehara [@] twilio.com

TwilioQuest 24時間チャレンジ開催のおしらせ

2020-08-18T11:11:49+09:00

こんにちは！猛暑が続いていますが、お元気でしょうか？私は夏の暑さとCOVID-19感染者数の増加により、すっかり引きこもっている毎日です。

さて、先日7月4日にTwilioJP-UG岡山さん主催によるTwilioQuest Nightがオンラインで開催されました。

takeshi.furusato.blog - TwilioJP-UG Okayama #4 TwilioQuest Night を開催しました。

今回はこのイベントをもとにTwilio Japanとして2020年8月28日（金）〜 29日（土）にかけて獲得経験値を競う「TwilioQuest 24時間チャレンジ」を開催します。

TwilioQuestとは

TwilioQuestは、Twilioが提供する製品の利用方法やJavaScript、PHP、Python、GitHubについてゲームをプレイするように学べるチュートリアルです。最新バージョンではMac/Windows/Linuxそれぞれにインストールでき、自分自身のペースでミッションに挑戦できます。

参考記事 - Game + Tutorial = TwilioQuest3のはじめかた

24時間チャレンジについて

今回のTwilioQuest 24時間チャレンジは制限時間内にどれだけ経験値を獲得できるかを競うイベントとなります。ご自身が興味のあるミッションを好きな時間にプレイできるため、これまで使ったことのないプロダクトや言語などに挑戦することができます。

参加者および高得点者には豪華賞品をご用意しています！例えば...

TwilioQuest Tシャツ（参加者全員に進呈）
TwilioQuest DevBox（上位2名に進呈）
さらに豪華賞品を追加予定（後日アナウンス）

参加条件

こちらは至ってシンプルです。イベントに登録いただくこと、TwilioQuest 3をダウンロードし、インストール、プレイできる環境をご用意いただくことと、賞品を受け取る場合は弊社の登録フォームにも別途登録いただくことが条件となります。

イベント期間中のサポートについて

イベント期間中は、次の予定（日本標準時）でTechnical Assistantによるサポートを提供します。Twilio社員やTwilio ChampionsがTwilioQuestのプレイ方法やミッションについての質問などを日本語でお答えします。

2020/08/28 16:30 - 18:00
Ask the TA (オープニングイベント内)
2020/08/28 18:00 - 20:00
Slackチャンネル内での非同期Q&A
2020/08/28 20:00 - 22:00
Twitch配信: 途中経過発表ならびにリアルタイムQ&A
2020/08/28 22:00 - 08/29 05:00
Slackチャンネル内での非同期Q&A
2020/08/29 05:00 - 07:00
Twitch配信: 途中経過発表ならびにリアルタイムQ&A
2020/08/29 07:00 - 12:00
Slackチャンネル内での非同期Q&A
2020/08/29 12:00 - 14:00
Twitch配信: 途中経過発表ならびにリアルタイムQ&A
2020/08/29 14:00 - 17:00
Slackチャンネル内での非同期Q&A

*ストリーミングについては予定が変更になる可能性があります。

参加方法

下記イベントページよりご登録ください。

TwilioQuest 24時間チャレンジイベントページ

この記事についての問い合わせ

イベントについての質問がありましたらぜひお問い合わせください。みなさんの参加をお待ちしています！

Googleスプレッドシートのシフト表を使ってTwilio Studioフローの転送先をNode.jsから更新する方法

2020-05-27T15:21:26+09:00

以前の記事で、在宅勤務に伴う電話問い合わせの一時休止を解決する方法として、Twilio Studioを利用し個人電話に転送する方法を紹介しました。

今回は別の記事で紹介したGoogleスプレッドシートのシフトデータをもとに転送先となる個人をNode.jsで変更する方法を紹介します。

前提条件

Twilioアカウントを持っていること（無料トライアルのサインアップ方法）
期間限定の問い合わせ番号となる電話番号を購入していること
（日本の番号を取得する場合）
こちらの記事に則りフローを作成、公開済みであること
こちらの記事に則りGoogleスプレッドシートからデータを取得するNode.jsアプリケーションを作成済みであること

Node.jsプロジェクトの作成とパッケージのインストール

以前の記事に沿って作成したNode.jsアプリケーションのフォルダーに移動し、twilio-nodeパッケージをインストールします。

npm i twilio

次に.envファイルにTwilioへの接続情報やStudioフローのIDを保存する環境変数を追加します。

SPREADSHEET_ID=
STAFF_WORKSHEET_ID=
SHIFT_WORKSHEET_ID=
TWILIO_ACCOUNT_SID=
TWILIO_AUTH_TOKEN=
TWILIO_STUDIO_FLOW_SID=

Twilio Studio REST API v2を使ったフローの取得と更新

今回利用するTwilio Studio REST API v2は4月末にパブリックベータとしてアナウンスされたばかりの機能です。この新しいAPIを使って定義済みのフロー設定を外部から更新できます。

Twilioコンソールを開きACCOUNT SIDと、AUTH TOKENをそれぞれ.envファイルの TWILIO_ACCOUNT_SIDならびに TWILIO_STUDIO_FLOW_SID の値として設定します。

次に、Studioコンソールを開き、call forwardingフローのSIDを TWILIO_STUDIO_FLOW_SID の値として設定します。

index.jsを開き、前回の記事でテストに使用したコードを変更します。このコードでは、シフト担当者の電話番号を取得した状態で、Twilio Nodeクライアントを利用しStudioフローを取得します。

loadShiftPhoneNumbers().then (
    numbers => {
        // twilio client
        const client = require('twilio')
           (process.env.TWILIO_ACCOUNTSID,
            process.env.TWILIO_AUTH_TOKEN);

        // Studioのフローを取得
        client.studio.flows(process.env.TWILIO_STUDIO_FLOW_SID)
            .fetch()
            .then(flow => {})
            .catch(error => console.error(error))
    ;})
    .catch( error => console.error(error));

フローの定義情報は、definitionというプロパティに保持されているため、そちらを取得します。また、各ウィジェットについては、statesというプロパティに配列として定義されています。このstates配列からウィジェットの名前をキーとして着信を転送するウィジェットを取得し、更に転送先番号を更新します。

loadShiftPhoneNumbers().then (
    numbers => {
        // twilio client
        const client = require('twilio')
           (process.env.TWILIO_ACCOUNTSID,
            process.env.TWILIO_AUTH_TOKEN);

        // Studioのフローを取得
        client.studio.flows(process.env.TWILIO_STUDIO_FLOW_SID)
            .fetch()
            .then(flow => {
                // フローの定義を取得
                let definition = flow.definition;
                // forward_callウィジェットを取得
                let callForwardWidget = definition.states.find(
                    item => item.name == 'forward\_call');
                // 転送先番号をシフトの電話番号で更新
                callForwardWidget.properties.to = numbers;
            })
            .catch(error => console.error(error));
    })
    .catch( error => console.error(error));

後は更新した定義をStudio REST API v2を使い、反映させます。この際、statusプロパティで反映したフローを下書き状態（draft）にしておくことも、即座に公開（published）にすることもできます。

loadShiftPhoneNumbers().then (
    numbers => {
        // twilio client
        const client = require('twilio')
           (process.env.TWILIO_ACCOUNTSID,
            process.env.TWILIO_AUTH_TOKEN);

        // Studioのフローを取得
        client.studio.flows(process.env.TWILIO_STUDIO_FLOW_SID)
            .fetch()
            .then(flow => {
                // フローの定義を取得
                let definition = flow.definition;
                // forward_callウィジェットを取得
                let callForwardWidget = definition.states.find(
                    item => item.name == 'forward\_call');
                // 転送先番号をシフトの電話番号で更新
                callForwardWidget.properties.to = numbers;

                // 更新した定義を反映し、即座に公開
                client.studio.flows(process.env.TWILIO_STUDIO_FLOW_SID)
                    .update({
                        definition: definition,
                        commitMessage: 'シフトの更新 - 2020/05/15',
                        status: 'published'})
                    .then(res => console.log(res))
                    .catch(error => console.error(error));
            })
            .catch(error => console.error(error));
    })
    .catch( error => console.error(error));

index.jsを実行し、ログにエラーが含まれていないこと、Studioのフローが実際に変更されていることを確認しましょう。

node index.js

まとめ

ご覧いただいたように、パブリックベータとして公開されたREST API v2を活用することで、外部のデータやシステムと連携した上でTwilio Studioのフローを更新することができるようになりました。非常に強力なAPIなので、ぜひご活用ください。

今回のサンプルはこちらのGitHubリポジトリからクローンし、環境変数にそれぞれ値を設定することで確認することも可能です。

新型コロナウイルス感染症への支援策について

Twilioでは新型コロナウィルス感染症により引き起こされるさまざまな社会問題を解決する会社、団体、開発者グループに向けて無料クレジットの進呈など支援を行なっています。詳しくはこちらの記事をご覧ください。

また、Twilioを自社のシステム、ソリューションやパッケージに組み込みたいとお考えの場合は、営業部までお問い合わせください。

このエントリについての問い合わせ

不明点があればぜひ、お問い合わせください。オンライン登壇のご依頼等もこちらまで！

GoogleスプレッドシートからNode.jsでシフトデータを読み出す方法

2020-05-20T16:34:57+09:00

Google Cloud Platform（GCP）にはGoogle Sheets APIが提供されており、このAPIを利用してGoogleスプレッドシートのデータにアクセスすることができます。今回はGoogleスプレッドシートのスタッフ、シフトデータをNode.jsで読み込む方法を紹介します。

前提条件

Google Cloud Platform （GCP）のアカウントの作成、ならびに有効な支払い方法が登録されていること
Googleスプレッドシートを利用できること

シフトを管理するGoogleスプレッドシート

こちらにスプレッドシートのサンプルを用意しました。ファイルメニューからこのスプレッドシートを自分のGoogleアカウントで利用できるようにコピーします。スプレッドシートの中身をみてみましょう。Shiftシートには日ごとの担当者を4名まで設定しています。

また、Staffシートには担当者ごとの連絡先電話番号がE.164フォーマットで登録されています。

GCPでSheets APIを有効化

はじめてGCPを利用する場合は、コンソールからプロジェクトを作成します。

例ではプロジェクト名を google-sheet-studio としましたが、任意のプロジェクト名で構いません。

作成ボタンをクリックするとリソースの管理画面に戻り、プロジェクトの作成が開始されます。数十秒〜数分程度で作成が完了します。

次にAPI ライブラリを開きます。

先ほど作成したプロジェクトが選択されていることを確認します。

Google Sheets APIを検索し、プロジェクトに追加します。

詳細画面から 有効にする ボタンをクリックするとGoogle Sheets APIが有効になります。

APIが有効化されると、概要画面に遷移します。次に 認証情報を作成 ボタンをクリックし、このAPIを使用するための認証情報を作成します。

認証情報の追加画面において次の設定を行い、必要な認証情報 ボタンをクリックします。

使用する API - Google Sheets API
API を呼び出す場所 - ウェブサーバー（node.js、Tomcat など）
アクセスするデータの種類 - アプリケーションデータ
App Engine または Compute Engine でこの API を使用する予定はありますか？ - いいえ、使用していません

続けてサービスアカウント名とロールを設定します。例では、test およびロールを Project の 閲覧者 とし、キーのタイプを JSON としました。

次へ ボタンをクリックすると認証情報を含んだJSONファイルが作成されダウンロードされます。このファイルはGoogle Sheets APIを利用するために必要になります。作成されたJSONファイルを開くと client_email という名前のキーの値に先ほど作成したサービスアカウント IDが記載されています。Googleスプレッドシートを共有する際にこの情報が必要になります。

Googleスプレッドシートの共有とURLや情報の確認

次に、Google Sheets APIからアクセスをできるようにGoogleスプレッドシートをサービスアカウントに共有します。先ほど複製したGoogleスプレッドシートを開き、右上の 共有 ボタンをクリックします。表示された共有ダイアログに先ほどのサービスアカウント IDを入力します。

Enterキーを押すと、権限の設定を行えます。書き込み権限は必要ないため閲覧者としました。共有 ボタンをクリックし、共有を完了します。

更に、このGoogleスプレッドシートから次の情報を控えておきます。

スプレッドシートID（https://docs.google.com/spreadsheets/d/ の後に表示されている英数文字列のうち、次の’/’ の前の値。例: https://docs.google.com/spreadsheets/d/ 12312321xxx21232131212 /edit#gid=0 の太字部分）
Shift、StaffそれぞれのワークシートのID（URLが #gid=0 の場合は、 0 となる）

これでシートから情報を取得する前準備が整いました。

Node.jsプロジェクトの作成とパッケージのインストール

Google Sheets APIを利用することでGoogleスプレッドシートのデータにアクセスすることができます。このAPIに対応するNode.jsクライアントライブラリも用意されており、クイックスタートのようにセルの値を取得することもできるのですが、取得するセルの範囲を指定する必要があり、使いにくいと感じるかもしれません。そのため、今回はGoogle Sheets APIを使いやすくラップしたgoogle-spreadsheetパッケージを利用します。このパッケージを利用すると、セルの範囲を指定することなく、ワークシートから行オブジェクトとしてデータを読み込むことができます。

Node.jsアプリケーションを作成し、google-spreadsheetと環境変数を.envファイルからロードできるdotenvパッケージをインストールします。

npm i google-spreadsheet dotenv

次にGoogleスプレッドシートやシートのIDを記録しておく.envファイルを作成します。

touch .env

.envファイルには次の環境変数を追加しておきます。

SPREADSHEET_ID=
SHIFT_WORKSHEET_ID=
STAFF_WORKSHEET_ID=

SPREADSHEET_ID、STAFF_WORKSHEET_ID、SHIFT_WORKSHEET_ID には先ほど控えておいたGoogleスプレッドシートのIDやそれぞれのシートのIDを追加します。

最後にGCPからダウンロードしたJSONファイルをプロジェクトフォルダーにコピーし、わかりやすいように名前を credentials.json と変更します。これで準備完了です。

Googleスプレッドシートからシフト表を取得

ここからはGoogleスプレッドシートからシフト表を取得するコードを実装します。Node.jsアプリケーションに新しくjsファイルを追加します。index.js という名前で作成しました。

touch index.js

index.jsをエディタで開き、環境変数の読み込みや必要なパッケージをインポートします。

'use strict';
require('dotenv').config();
const { GoogleSpreadsheet } = require('google-spreadsheet');

次にGoogleスプレッドシートからシフトデータを読み取り、担当者の電話番号を返す非同期関数を実装します。

// Googleスプレッドシートからシフト情報をロードし、担当者の電話番号を取得
async function loadShiftPhoneNumbers() {
    // 処理を実装
}

この loadShiftPhoneNumbers 関数でGoogleスプレッドシートをロードします。ここでGCPへの接続に必要になるのが先ほどコピーし、名前を変更した credentials.json です。

// Googleスプレッドシートからシフト情報をロードし、担当者の電話番号を取得
async function loadShiftPhoneNumbers() {
    // スプレッドシートIDと資格情報を用いてGoogleスプレッドシートをロード
    const doc = new GoogleSpreadsheet(process.env.SPREADSHEET\_ID);
    const credentials = require('./credentials.json');
    await doc.useServiceAccountAuth(credentials);
    await doc.loadInfo();
}

ワークシートを取得する場合は、GoogleSpreadsheet.sheetsById、またはGoogleSpreadsheet.sheetsbyIndexを利用できます。さらに、GoogleSpreadsheetWorksheet.getRowsメソッドを使用し、ワークシートの行を取得できます。残念ながら特定の列の値をキーにフィルタリングはできないようなので全ての行を取得します。

// Googleスプレッドシートからシフト情報をロードし、担当者の電話番号を取得
async function loadShiftPhoneNumbers() {
    // スプレッドシートIDと資格情報を用いてGoogleスプレッドシートをロード
    const doc = new GoogleSpreadsheet(process.env.SPREADSHEET\_ID);
    const credentials = require('./credentials.json');
    await doc.useServiceAccountAuth(credentials);
    await doc.loadInfo();

    //シフト情報を取得
    const shiftSheet = await doc.sheetsById[process.env.SHIFT_WORKSHEET_ID];
    const shiftRows = await shiftSheet.getRows();
    // 従業員情報を取得
    const staffSheet = await doc.sheetsById[process.env.STAFF_WORKSHEET_ID];
    const staffRows = await staffSheet.getRows();
}

GoogleSpreadsheetWorksheet.getRowsメソッドはGoogleSpreadsheetRowの配列を返します。また、このGoogleSpreadsheetRowオブジェクトは最初の行をプロパティのキーとしてアクセスできるため、Array.prototype.find()メソッドを利用し、Date列をキーとして特定の日付のデータを抜き出すことができます。この記事では、2020年5月15日を例として取得します。実際のアプリケーションでは new Date() などを利用し、当日のデータを取得することになるでしょう。

// Googleスプレッドシートからシフト情報をロードし、担当者の電話番号を取得
async function loadShiftPhoneNumbers() {
    // スプレッドシートIDと資格情報を用いてGoogleスプレッドシートをロード
    const doc = new GoogleSpreadsheet(process.env.SPREADSHEET\_ID);
    const credentials = require('./credentials.json');
    await doc.useServiceAccountAuth(credentials);
    await doc.loadInfo();

    //シフト情報を取得
    const shiftSheet = await doc.sheetsById[process.env.SHIFT_WORKSHEET_ID];
    const shiftRows = await shiftSheet.getRows();
    // 従業員情報を取得
    const staffSheet = await doc.sheetsById[process.env.STAFF_WORKSHEET_ID];
    const staffRows = await staffSheet.getRows();

    // シフト情報からDate列の値と指定した日付をロケール情報に基づいて取得
    let shiftRow = shiftRows.find(row =>
        new Date(row.Date).toLocaleDateString() ===
        new Date('2020/5/15').toLocaleDateString());
}

あとは、取得した行から必要なデータを読み取り、アプリケーションで使用できます。

データの活用例として、このシフトデータから担当者の電話番号をカンマ区切りの文字列で取得する方法も実装します。

shiftRow.Employee1のように各列のキーを指定してデータを取得することもできますが、shiftRow._rawData shiftRow には、行のデータが配列として保持されています。2020年5月15日のデータは、['5/15/2020', 'Mitsuharu', 'Yoshihiro'] となります。この配列をArray.prototype.slice()メソッドで最初の日付データを除外した配列とし、さらに、Array.prototype.map()メソッドでシフト担当の従業員の電話番号の配列へと変換します。そして、最後に、Array.prototype.join()メソッドで文字列として返すという処理を実装しました。

// Googleスプレッドシートからシフト情報をロードし、担当者の電話番号を取得
async function loadShiftPhoneNumbers() {
    // スプレッドシートIDと資格情報を用いてGoogleスプレッドシートをロード
    const doc = new GoogleSpreadsheet(process.env.SPREADSHEET\_ID);
    const credentials = require('./credentials.json');
    await doc.useServiceAccountAuth(credentials);
    await doc.loadInfo();

    //シフト情報を取得
    const shiftSheet = await doc.sheetsById[process.env.SHIFT_WORKSHEET_ID];
    const shiftRows = await shiftSheet.getRows();
    // 従業員情報を取得
    const staffSheet = await doc.sheetsById[process.env.STAFF_WORKSHEET_ID];
    const staffRows = await staffSheet.getRows();

    // シフト情報からDate列の値と指定した日付をロケール情報に基づいて取得
    let shiftRow = shiftRows.find(row =>
        new Date(row.Date).toLocaleDateString() ===
        new Date('2020/5/15').toLocaleDateString());

        // 元データ['5/15/2020', 'Mitsuharu', 'Yoshihiro']
        // Date列(最初の列)を取り除き、シフト担当の従業員を含む配列を取得する
        let employeesOnDuty = shiftRow._rawData.slice(1); 
        // ['Mitsuharu', 'Yoshihiro']
        // 名前から電話番号の配列に置換
        employeesOnDuty = employeesOnDuty.map(m => 
            staffRows.find(row => row.Name === m).PhoneNumber); 
        // ['+815012341235', '+815012341237']

        return employeesOnDuty.join(',');}

ここまで実装を終えた段階で、きちんとデータを読み込めるかどうかを確認しましょう。
loadShiftNumbers関数のスコープ外に次のコードを追加します。

// 実装した関数が正しく動作するかテスト
loadShiftPhoneNumbers()
    .then (numbers => console.log(numbers))
    .catch(error => console.error(error));

index.jsを実行し、次のような結果がコンソールに出力されていれば成功です。

node index.js

実行結果

+815012341235,+815012341237

想定した結果が得られない場合は、出力されたエラーを参考にGCPの設定や、JSONファイルの読み込みなどを確認してください。

まとめ

ご覧いただいたように、Google Sheets APIを使うことでGoogleスプレッドシートをデータソースとしたアプリケーションを構築することができます。ぜひご活用ください。

このエントリについての問い合わせ

不明点があればぜひ、お問い合わせください。オンライン登壇のご依頼等もこちらまで！

Twilio Studioを使って問い合わせ番号への着信を複数の番号に転送する方法

2020-04-30T11:08:39+09:00

在宅勤務と電話応対の難しさ

新型コロナウイルス感染症（COVID-19）の拡大に伴う緊急事態宣言が東京、大阪、福岡を含む7都道府県を対象として発出されました。（2020年4月14日現在）この宣言を受けて在宅勤務の開始とそれに伴う電話対応の一時休止が多くの企業からアナウンスされています。チャットやSMSを活用することでこれまでの顧客対応を一部担うことはできるものの、利用できるコミュニケーションチャネルが電話のみという場合、お客様への対応に頭を悩ます場合も多いのではないでしょうか。

もちろん、各事業者が提供する電話転送サービスなどを利用することで、代表番号からの転送を設定することは可能です。しかし、担当者の欠勤や休暇への対応など、転送設定を柔軟に運用するためには課題が残ります。また、リモートで設定ができない場合は、リスクを取って事業所まで外出し、設定を行うということも考えられます。特に中小規模の組織にとっては頭の痛い問題ではないでしょうか。

今回は、電話番号をTwilioから取得し、Twilio Studioを使って期間限定の問い合わせ窓口を開設し、着信を複数の担当者の電話回線に転送する方法を紹介します。ポイントは手軽さと設定の柔軟性です。

前提条件

Twilioアカウントを持っていること（無料トライアルのサインアップ方法）
期間限定の問い合わせ番号となる電話番号を購入していること
（日本の番号を取得する場合）

Twilio Studioを使った電話転送

Twilio Studioは電話やSMSなどの着信応答を設定することができるノンコーディーングツールです。今回のような転送設定を行う場合はプログラミングの知識を必要としません。

TwilioコンソールからStudioダッシュボードを開き、赤色のCreate a flowボタンをクリックし、新しいFlowの作成を開始します。

Flowの名前はCall Forwardingとしました。

Studioにはいくつかテンプレートが用意されているため、目的に合えば最小限の項目設定で運用を開始できます。少しスクロールすると表示されるCall Forwardingテンプレートを選択し、Nextボタンをクリックします。

あらかじめ、Connect Call Toというウィジェットが配置されたデザイン画面が表示されます。このデザイン画面では右側のWIDGET LIBRARYからウィジェットをドラッグ&ドロップし、複雑なコールフローを設定できます。

今回の記事では特にウィジェットを追加しないまま進めます。

次にforward_callと名前がつけられているウィジェットをクリックしましょう。WIDGET LIBRARYが表示されていたパネルが、選択したウィジェットの設定項目表示パネルに切り替わります。

このウィジェットは現在の通話を別の番号（単数、複数）や、Client User（別のTwilio Client）、SIM、SIPエンドポイント、あるいはカンファレンスコールに接続させることができます。今回は複数の番号に転送したいため、CONNECT CALL TOをMultiple Numbers (Simulring)に、PHONE NUMBERS OR CLIENTSに複数の電話番号をカンマ（,）区切りで設定しました。この際、電話番号はE.164フォーマットで指定する必要があります。

（例）050-3196-5549 → +815031965549

また、複数の番号に転送する場合は、同時に転送するわけでなく、Call Per Second（CPS）と呼ばれる１秒間あたりの発信数に則り転送されます。現在の設定はコンソールで確認できます。

つぎに発信者ID（CALLER ID）を設定しましょう。この項目は転送先の携帯電話等に表示される発信元の番号になります。本来であれば電話をかけてきたお客様の番号を表示できれば良いのですが、一般電話回線にTwilio Studioを用いた電話の転送を行なった場合、発信者の偽装になりかねないため、残念ながら「非通知」と表示されてしまいます。

これでは本当に非通知なのか、Twilio Studioで転送された着信かどうかがわからず不便ですよね。そのため、代替策として、{{trigger.call.To}}と指定し、期間限定の問い合わせ番号として設定する番号、すなわち転送に利用したTwilioの電話番号が表示されるようにします。

これでStudioの設定は完了です。ウィジェットのSaveボタンで変更を保存するとともに、画面上のPublishボタンでフローを公開できます。忘れないように Publish してください。

さて、残るは電話番号の設定です。事前に購入している電話番号の詳細画面を電話番号コンソールから開き、VoiceセクションのA CALL COMES INで Studio Flowを選択します。

続けて先ほど設定したフローを選択します。

おっと、忘れずにSaveボタンを押しましょう。この番号に転送先でない番号から電話をかけて動作を確かめたら、Webサイトの更新ですね！