Zoho CreatorでのSMS送信

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

Zoho CreatorからZoho VoiceのSMSを送信するには？

Zoho Creatorのソリューションから直接、Zoho Voiceの番号を使用してSMSを自動送信するには、以下の手順を実行します。

ステップ1：

次のURLにログインします：https://creator.zoho.com/

ステップ2：

Creatorソリューション用のコネクターを作成するには、次の手順を実行します。

次の順に［マイクロサービス］→［新規作成］→［接続］→［選択して作成］に移動します。

ステップ3：

次の順に［カスタムコネクター］→［新規作成］をクリックします。

以前にカスタムコネクターを作成している場合、カスタムコネクターのページにカードとして表示されます。右上にある［+新規作成］アイコンをクリックすると、ビルダーが表示されます。

ステップ4：

［コネクター名］を入力して保存します。

ステップ5：

［一般］で、次のコネクターの詳細（［コネクター名］、［コネクターリンク名］、［説明］、［ロゴ］）を入力し、［保存して続行］をクリックします。

ステップ6：

カスタムコネクターの認証設定（［認証方式］、［認証パラメーター］、［スコープ］など）を定義します。認証方式として［OAuth2認証］を選択し、その後［保存して続行］をクリックします。

次のページに認証パラメーターが以下のように表示されます：

APIコンソールに設定するため、［コールバックURL］をクリップボードにコピーします。

ステップ7：

認証パラメーターを更新するには、別のタブを開いて次のURLに移動します：'https://api-console.zoho.com/'

これにより、Zoho APIコンソールが開き、特定の認証API ZCreatorSMSに直接アクセスして設定できます。

［クライアントの追加］をクリックし、次に［サーバーベースのアプリケーション］を選択します。

ステップ8：

［クライアント名］と［ホームページURL］を追加します。Creatorページからコピーした［コールバックURL］を［承認済みリダイレクトURL］に貼り付け、［作成］をクリックします。

新しいクライアントが作成されたら、［クライアントID］と［クライアントシークレット］の値（［クライアントシークレット］タブで自動生成されたもの）をコピーします。

ステップ9：

Creatorページの認証パラメーター画面（ステップ6に示した画面）で、［クライアントID］、［クライアントシークレット］および以下の値をそれぞれの項目に貼り付けます。

［認証URL］：https://accounts.zoho.com/oauth/v2/auth

［リフレッシュトークンURL］：https://accounts.zoho.com/oauth/v2/token

［トークンURL］：https://accounts.zoho.com/oauth/v2/token

［トークン取り消しURL］：https://accounts.zoho.com/oauth/v2/revoke

次に、［保存して続ける］ボタンをクリックします。

「認証パラメーター」を OAuth2認証で保存すると、自動的に OAuthスコープ セクションに移動します。または、左ペインの［OAuthスコープ］をクリックして移動することもできます。

ステップ10。

Creatorページで、［OAuthスコープ］メニュー（セキュリティセクション内）を選択し、次に［スコープを追加］をクリックします。

スコープの詳細を次のように入力します。

［スコープの表示名］：ZohoVoice Send SMS

［スコープ値］：ZohoVoice.sms.ALL

次に、［準備完了にする］ボタンをクリックし、作成したカスタムコネクターを接続で使用できる状態にします。これにより、スコープのステージが下書きから準備完了に変わります。

ステップ11。

Zoho CreatorアプリケーションをZoho Voiceなどの別のクラウドサービスと連携させるには、接続を設定する必要があります。この接続設定の手順は2段階です。

最初に、指定したパラメーターで接続を作成する必要があります。

次に、接続を利用できるように接続を認証する必要があります。

コネクターの準備が完了すると、［接続を追加］ボタンが表示されます。［接続を追加］をクリックします。

接続名として zohovoice_sms を入力します。

認証方式が OAuth2認証のコネクターでは、接続を作成する前に、接続用の スコープを選択するよう求められます。

［すべての環境で常に同じ認証を使用する］チェックボックスは、同じ認証情報をすべての環境での認証に使用する必要がある場合に選択します。

［作成して認証］をクリックします。接続が作成され、認証を求められます。

メモ：

スコープは、カスタムコネクターで接続を追加すると編集または削除できません。

ステップ12。

入力するのは［認証アカウント名］と認証情報です。入力した名前は認証を識別するために使用されます。認証に必要な認証情報は、対象サービスでサポートされている認証方式に基づきます。ここではOAuth2認証方式です。

チェックボックス［すべての環境で同じ認証を常に使用する］を選択すると、すべての環境がロックされ、環境間で認証が一定に保たれます。

［認証］をクリックし、選択したサービスへのアクセスを認証します。

OAuth2認証タイプでは、［認証］をクリックすると、Zoho Voiceの認証ページにリダイレクトされます。次に［承諾］をクリックしてアプリケーションのアクセス権限を承諾します。

［接続名］には必ず 'zohovoice_sms' を指定してください。その後、新しいページにリダイレクトされます。

次に、［マイクロサービス］→［接続］に移動し、名前が「zohovoice_sms connection」の接続カードをクリックします。次に、アプリケーションへの接続アクセスを有効にします。

接続アクセスを有効にすると、他のユーザーがCreatorアプリケーションでその接続を使用できるようになります。対象のアプリケーションの接続アクセスを有効にするには、以下のように右側の切り替えボタンを緑色になるまでドラッグします。

ステップ13。

次に、［ソリューション］に移動します。［ソリューションを作成または編集］をクリックします。

上部の［ワークフロー］ボタンをクリックして、ワークフローダッシュボードに移動します。

次に、［ワークフローを作成］→［新しいワークフロー］をクリックします。

ワークフローをトリガーするタイミングを指定するため、［フォームの使用時］オプションを選択します。

必要な詳細を入力します。

［フォーム名］で必要なフォームを選択します。［作成または編集時］オプションを［データイベント］として、［フォーム送信の成功時］オプションを［フォームイベント］として選択します。最後にワークフローに名前を付け、［ワークフローを作成］ボタンをクリックします。ワークフロービルダーが、以下の例のように表示されます。

［新しいアクションを追加］をクリックします。選択したフォームイベントに関連付けられたアクションが表示されます。

［Delugeスクリプト］を選択します。

情報。

カスタムコネクターを使用する接続は、Delugeのinvoke URLタスクを使用して呼び出す必要があります。その際、特定のシナリオ／ワークフローに応じて、以下のコードのように該当するアクションAPIを指定します。

以下のコードを貼り付けて保存します。最後に［完了］をクリックして、ワークフロービルダーを終了します。

response = Map();
dataTxt = Map();
dataTxt.put('message','this is test SMS');
dataTxt.put('customerNumber',input.{FORM_FILED});
dataTxt.put('senderId','+1484292YYYY');
resp = invokeurl
[
url :'https://voice.zoho.com/rest/json/v1/sms/send'
type :POST
parameters:dataTxt.toString()
headers:{'Content-Type':'application/json'}
connection:'zohovoice_sms'
];
info resp;

コード内：

input.{FORM_FILED} は、Zoho Creatorソリューションから送信された番号の差し込み項目として機能します

メッセージ送信用のZoho Voice番号を、変数 senderID の近くにハードコードします

便宜上、設定全体でコネクター名はzohovoice_sms にすることをおすすめします。