今回は、前回準備したアプリを使って、初めてのシナリオを作成します。
作るのは、「問い合わせ管理アプリにレコードが追加されたら、To Doアプリに対応タスクを追加する」シナリオです。

この記事で最も大切なのは、「ステップ間で値を受け渡す」考え方です。
イベントで受け取った値をアクションに渡すしくみは、すべてのシナリオに共通する基本です。
実際に手を動かしながら、しっかり押さえておきましょう。

今回のシナリオは、次の2つのステップで構成します。

まず、前回作成した「問い合わせ対応チーム」プロジェクトの中に、シナリオを作成します。
シナリオ名は「問い合わせからTo Doを追加」とします。

1. 連携コネクタの画面上部のメニューで、［プロジェクト］をクリックします。

2. ［プロジェクト一覧］で、「問い合わせ対応チーム」プロジェクトをクリックします。

   

3. ［シナリオ一覧］で、画面左のサイドメニューにマウスポインターを合わせ、［新規シナリオ作成］をクリックします。
   サイドメニューは、マウスポインターを合わせると広がります。

   

4. 画面左の［設定］で、［シナリオ名］に「問い合わせからTo Doを追加」と入力します。
   ［タグ］や［シナリオの説明］など、ほかの項目は空欄のままで問題ありません。

   

シナリオ名を入力したら、保存せずに、そのまま次のイベントの作成に進みます。
シナリオの保存は、アクションまで作成した後にまとめて行います。

途中で［保存］をクリックすると、シナリオの画面が表示モードに切り替わります。
続けてステップを設定するときは、画面右上の［編集］をクリックしてください。

注意

保存しないまま画面を閉じると、それまでの設定は保存されません。
作業を中断するときは、画面右上の［保存］をクリックしてから閉じてください。

最初に、問い合わせ管理アプリへのレコード追加を検知するイベントを作成します。

1. ［アプリ選択］で「kintone」をクリックし、［次へ］をクリックします。

   

2. ［イベント選択］で「レコード追加/編集の検知」を選択し、［次へ］をクリックします。

   

3. ［Webhookコネクタ選択］で、［新しいコネクタを作成する］をクリックします。

   

4. ［Webhookコネクタ作成］で、［タイトル］に任意の名前（例：問い合わせ管理）を入力し、［コネクタ作成］をクリックします。

   

5. 作成されたWebhook URLの右側にあるコピーボタンをクリックして、URLをコピーします。

   

6. kintoneの問い合わせ管理アプリで、Webhookを次のとおり設定します。
   設定後は、［アプリを更新］をクリックして変更を反映してください。

   項目	設定する値
   Webhook URL	手順5でコピーしたURL
   通知を送信する条件	［レコードの追加］だけにチェックを入れる
   有効化	［このWebhookを有効にする］にチェックを入れる

   kintoneでWebhookを設定する方法は、次のページを参照してください。
   Webhookを設定する

7. 連携コネクタの画面に戻り、作成したWebhookコネクタが選択されていることを確認して、［次へ］をクリックします。

8. ［基本設定］で、［検知するイベントの種類］に「追加」を選択し、［次へ］をクリックします。

   

9. ［出力確認］で［サンプル取得］をクリックします。
   ［出力確認］に最初から表示されている値は、出力データの見本です。
   自分のアプリのデータではないので、気にせず進めてください。

   

10. ［サンプル取得］で［Webhook待機］をクリックします。
    Webhookの待機中の画面が表示されます。

    

11. kintoneの問い合わせ管理アプリを開き、次のテスト用のデータでレコードを追加します。

    フィールド	入力する値
    顧客名	サイボウズ商事
    ご担当者名	山田花子
    問い合わせ種別	受発注について
    詳細	先月発注した商品の納期を教えてください。
    期限	2026-10-31

    表にないフィールド（対応担当者や対応状況など）は、今回のシナリオでは使いません。
    空欄のままか、初期値のままで問題ありません。

    

    テストには、この入力例のような架空のデータを使ってください。
    実在の顧客情報などを、誤って連携先へ送らないためです。

12. 連携コネクタの画面に戻ります。
    レコードの追加が検知され、［出力確認］に追加したレコードの内容が表示されていることを確認します。
    ［record］の横の▼をクリックすると、追加したレコードの各フィールドの値を確認できます。
    ここで取得したデータは、後のアクションの設定と［テスト実行］で使います。

    

    

    ［Webhook待機］でデータが表示されない場合は、次のページを参照してください。
    Webhook関連のトラブルシューティング一覧

13. ［完了して次へ］をクリックします。
    イベントの設定が完了し、次のステップの設定画面に移ります。

手順12で表示された内容が、このイベントの「出力データ」です。
出力データは、後に続くアクションの設定で使います。

イベント「レコード追加/編集の検知」の出力データには、追加されたレコードの値がフィールドごとに含まれています。
各値は、次のような階層で表示されます。

1

レコード追加/編集の検知 > record > Customer > value

それぞれの部分の意味は次のとおりです。

［出力確認］の画面では、［record］の中にフィールドコードごとの値が並んでいます。
たとえば、顧客名の値は［record］の中の［Customer］の［value］に入っています。

前回、ご担当者名のフィールドコードを「ContactName」に変更したのは、この表示を読みやすくするためです。
フィールドコードが初期値のままだと、record > 文字列__1行__0 > valueのように表示され、どのフィールドの値なのか判断できません。

次に、To Doアプリにレコードを追加するアクションを作成します。
ここでは、アクションの種類と接続先を設定し、［基本設定］の画面を開くところまで進めます。

1. ［アプリ選択］で「kintone」をクリックし、［次へ］をクリックします。

   

2. ［アクション選択］で「レコードの追加」を選択し、［次へ］をクリックします。

   

3. ［認証コネクタ選択］で、［新しいコネクタを追加］をクリックします。

   

4. ［認証コネクタ作成］で、次の項目を入力して［コネクタ作成］をクリックします。
   入力する値は、前回控えたTo Doアプリの値です。

   項目	入力する値
   認証種別	APIキー
   タイトル	任意の名前（例：To Do）
   トークン	To DoアプリのAPIトークン
   ドメイン	cybozu.com
   サブドメイン	利用しているkintoneのサブドメイン
   アプリID	To DoアプリのアプリID

   

5. 作成した認証コネクタが選択されていることを確認して、［次へ］をクリックします。

   

6. ［基本設定］で、［開始日］［終了日］［締切日］に入っている日付を削除します。
   この時点では、操作した日の日付が固定値として入っています。
   そのままにすると、シナリオが実行されるたびに、この日付が登録されてしまいます。

   

連携コネクタでは、前のステップの出力データを、後のステップの設定項目に入れられます。
これにより、「イベントで受け取ったレコードの顧客名を、To DoのToDo名に使う」といった処理を、プログラムを書かずに実現できます。
このステップ間で値を受け渡すしくみは、すべてのシナリオで使う基本です。

アクションの設定項目の入力欄をクリックすると、画面の右側に、前のステップの出力データの一覧が表示されます。
一覧から使いたい値をクリックすると、入力欄にその値が設定されます。

入力欄に設定された値は、実際の値ではなく「この場所の値を使う」という目印です。
シナリオが実行されるたびに、そのとき追加されたレコードの値に置き換わります。

出力データの値と、自分で入力した文字列は、組み合わせて使えます。
たとえば、ToDo名の入力欄に次のように設定すると、顧客名とご担当者名を含むToDo名が作れます。

1

【問い合わせ対応】{顧客名}（{ご担当者名}様）

「【問い合わせ対応】」「（」「様）」のような固定の文字は、入力欄に直接入力するか、貼り付けます。
{顧客名}と{ご担当者名}の部分には、出力データからそれぞれrecord > Customer > valueとrecord > ContactName > valueを設定します。
テスト用のデータでシナリオが実行されると、ToDo名は次のようになります。

1

【問い合わせ対応】サイボウズ商事（山田花子様）

STEP 3で開いた［基本設定］の画面で、次の操作をします。

1. To Doアプリのフィールドに、次の表のとおり値を設定します。
   入力欄をクリックし、右側に表示される出力データから値を選択してください。

   フィールド	設定する値
   ToDo名	【問い合わせ対応】record > Customer > value（record > ContactName > value様）
   詳細内容	record > Detail > value
   締切日	record > LimitDay > value

   ToDo名は、入力欄に次の順番で入力します。

   1. 【問い合わせ対応】と入力する。
   2. 出力データからrecord > Customer > valueをクリックする。
   3. （と入力する。
   4. 出力データからrecord > ContactName > valueをクリックする。
   5. 様）と入力する。

   ほかのフィールドは空欄のままで問題ありません。

   

   実際に運用するときは、連携に必要な項目だけを設定してください。
   個人情報や機密情報が含まれる場合もあるため、連携するデータの内容はセキュリティを考慮して設計しましょう。

   

2. ［次へ］をクリックします。

3. ［出力確認］で［テスト実行］をクリックします。

   

   

   警告

   ［テスト実行］をすると、連携先に実際にデータが追加されます。
   動作確認が終わったら、テストで追加されたTo Doアプリのレコードを削除してください。

4. kintoneのTo Doアプリを開き、レコードが追加されていることを確認します。
   ToDo名が「【問い合わせ対応】サイボウズ商事（山田花子様）」、締切日が「2026-10-31」になっていれば成功です。

   

最後に、画面右上の［保存］をクリックして、シナリオを保存します。
これで、シナリオの作成は完了です。

アクション「レコードの追加」の設定項目の詳細は、BizteX Connectヘルプセンターを参照してください。
kintoneのアクション一覧

今回は、イベントとアクションを作成し、初めてのシナリオを完成させました。
ステップ間で値を受け渡すしくみは、このあと作るどのシナリオでも使います。
出力データの階層と、フィールドコードとの関係を覚えておきましょう。

ただし、作成したシナリオはまだ有効になっていないため、レコードを追加しても自動では動きません。
次回は シナリオを動かして結果を確認しよう で、シナリオを有効にして実際に動かし、実行結果やエラーの確認方法を学びましょう。

このTipsは、2026年10月版kintoneで動作を確認しています。