お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

トリガーSMS招待とは？

使用ケース

用語集：

1. OAuth - 業界標準のプロトコルであり、ユーザーのパスワードを開示することなく、保護されたリソースへの安全なアクセスを提供します。
   
2. クライアント - Zoho Surveyへリクエストを送信し、エンドユーザーの代理として招待を実行するアプリケーションです。
   
3. クライアントID - Zohoでアプリケーションを登録すると受領する一意の識別子です。
   
4. Clientシークレット - Zohoにアプリケーションを登録した際に作成される一意のキーで、機密情報として保持する必要があります。
   
5. Grant Token - アクセストークンおよび更新トークンの生成に使用する一時的なトークンです。組織ごとのGrant Tokenの生成は一度限りです。
   
6. Access Token - Zoho Survey APIに送信され、ユーザーの実行済み招待へアクセスするためのトークンです。アクセストークンはZoho Survey APIへの安全で一時的なアクセスを提供します。各アクセストークンの有効期限は1時間のみで、スコープで定義された操作にのみ利用可能です。
   
7. 更新トークン - 新しいアクセストークンを取得するために使用できるトークンです。このトークンは、エンドユーザーが取り消すまで無期限で有効です。
   
8. API単価制限 - API単価制限は、任意の時点で同時に有効にできるAPI通話の最大数を指します。
   

事前準備：

1. 有効なZoho Surveyユーザー認証情報。
   
2. Zoho Survey APIへのアクセスに有効な認証トークンまたはOAuth。
   
3. Zoho SurveyポータルでSMS配信が設定されていること。
   

アプリケーションの登録方法：

1. ZohoのDeveloper Consoleでアプリケーションを登録し、クライアントIDとClientシークレットを生成します。
   
2. クライアントIDとClientシークレットが作成されると、スコープ「ZohoSurvey.invitation.create」を使用し、クライアント種類に基づいて組織専用のGrant Tokenを生成します。Grant Tokenは、セルフクライアントやサーバーベースのアプリケーションなど、特定のクライアントにのみ必要です。
   
3. 生成されたGrant Tokenをコピーします。各種アプリタイプでのクライアントIDおよびClientシークレットの生成については、その他の情報をご参照ください。
   

Access Tokenと更新トークンの生成    

1. 米国の場合：https://取引先。Zoho。com
   
2. オーストラリアの場合：https://取引先。Zoho。com。au
   
3. EUの場合：https://取引先。Zoho。eu
   
4. インドの場合：https://取引先。Zoho。in
   
5. 中国の場合：https://取引先。Zoho。com。cn
   
6. 日本の場合：https://取引先。Zoho。jp
   
7. カナダの場合：https://取引先。zohocloud。ca
   
8. サウジアラビアの場合：https://取引先。Zoho。sa
   

メモ:

1. サーバーベースのアプリケーションの場合、アクセス権限の種類パラメータ値を'オフライン'として認証リクエストを送信してください。値がオフラインの場合、初回リクエスト時にアクセス トークンと共に更新用トークンも受け取ります。アクセス トークンが有効期限切れになった際は、更新用トークンを使って再発行できます。
   
2. 各アクセス トークンの有効期限は1時間のみで、スコープ内で定義された操作のみに使用できます。
   
3. 新しいアクセス トークンを生成するには、更新用トークンを使用してください。更新用トークンに有効期限はありません。アクセス トークンの有効期限が切れた際は、更新用トークンで再発行してください。
   

Trigger SMS招待の設定方法

Zoho SMSサービスを利用したSMS配信の作成

1. Zoho Surveyポータルで、Launchタブに移動し、作成 SMSをクリックします。
   
   
2. 次に、接続先としてZoho SMSサービスを選択します。「DLTファイルをインポート」ボタンをクリックし、SMSとして送信するカスタムメッセージが含まれたDLTファイルをアップロードしてください。
   
   
3. アップロードしたテンプレートを選択し、「使用する」をクリックします。
   
   
4. テンプレート内のキーを置き換える変数を選択してください。
   
   
5. {Surveylink}変数が追加されていることを必ずご確認ください。これは必須の変数です。
   
   
6. 変数を追加したら、保存をクリックします。
   
   
7. テンプレートメッセージを認証し、次をクリックします。
   
   
8. 続いて、連絡先の追加に進みます。
   

メモ:

アップロードしたテンプレートには承認期間があります。承認後にのみ、SMS招待として送信可能です。承認期間中に却下される場合もあります。

SMSサービスでは、テンプレートの編集はできません。「既存テンプレートをコピー」をクリックすることで、既存テンプレートと差し替え、またはコピーのみ可能です。

1. Zoho Survey ポータルで、Launch タブに移動し、SMS の作成をクリックします。
   
   
2. Connection 種類を選択します。ドロップダウンボタンをクリックして、さまざまな外部連携を選択できます。
   
3. リッチテキストエディタを使ってカスタムメッセージを追加し、次へをクリックして連絡先の追加に進みます。

1. 送信するToセクションで、トリガーに基づき連絡先を選択し、［次へ］をクリックします。
   
   
2. トリガーの頻度を「一度きりの招待」または「繰り返し招待」から選択します。
   
   
1. 一度きりの招待の場合：以下の設定から頻度を選択できます。
   
1. 今すぐ - トリガーの設定後、SMS招待がすぐに送信されます。
   
   
2. 遅延後 - トリガー発動から一定時間経過後にSMS招待が送信されるよう設定できます。
   
   
3. 指定した日付と時間 - 招待を特定の日付と時間に送信するようにスケジュールできます。
   
   
4. 指定した時間枠でスケジュール - トリガーをバッチ処理として、特定の時間間隔で送信するように設定できます。
   
   
2. 繰り返し招待の場合：繰り返し招待を選択した場合は、トリガーの頻度をスケジュールしてください。
   
   
   
   
3. ［作成］をクリックすると、API情報が完了画面に表示されます。APIの詳細は、いつでもLaunch > SMS > 実行済み Invitationsから確認できます。
   
   

メモ:
API情報は、Launch > SMS Distribution > 実行済みInvitations > 表示する > API で確認できます。

 

メソッドPOST

ヘッダーAuthorization:Zoho-oauthtoken e4af2b6xxxxxxxxxxxxxbaaba

(キー) (値)

Content-Type:application/json 

 

メソッド POST

ヘッダー Authorization:Zoho-oauthtoken e4af2b6xxxxxxxxxxxxxbaaba

(キー) (値)

Content-Type: application/json

リクエスト本文

リクエスト本文:

メモ: 1回のPOSTリクエストで複数の連絡先を追加できます。

サンプルリクエスト

HTTPS ステータスコード

メモ事項

1. 更新するトークンの取り消し: ドメイン専用のZoho取引先URLを使用し、更新するトークンを取り消すリクエストを送信してください。詳細はこちら。
   
2. トークンの有効期限: 保管できるトークン数や、一定時間内に送信可能なリクエスト数には制限があります。詳細はこちら。
   
3. API制限: 1分間あたりのディストリビューションごとのリクエスト合計数は60です。