Adalo の Test は実際にメッセージを送る:通知ボタンを業務につなぐ前に

Adalo の Ada でアプリに通知 API を接続する際は、テスト用の受信先、変数のサンプル値、戻り値を先に明確にします。Custom Actions の Test は実際のリクエストを実行するため、プレビューが成功しても外部の受信結果を確認し、本番の業務に組み込むか判断する必要があります。

ソース: ada-help.adalo.com
2026年11月7日
6 min

社内申請アプリに「担当者に通知」ボタンを追加するのは、操作を一つ増やすだけに見えるかもしれません。しかし実際に完成させるべきなのは、ユーザーが何を送信し、メッセージがどこに届き、どんな応答が返り、失敗時に画面がどう説明するかという一連の流れです。Adalo の Ada は自然言語の指示でアプリを変更し、Custom Actions で外部 API と接続できます。ただし公式ドキュメントには、アクションエディターの Test が実際のリクエストを送ると明記されています。

そのため、初めて通知 API を接続するなら、まずテスト専用の受信先を用意してから Ada に画面との接続を依頼します。以下では、申請後に通知を送る場面を分析例に、新しい Ada の公式ドキュメントに基づいて検証の順序を考えます。アプリの実行やメッセージ送信を実際に試したものではありません。

「ボタンを追加」だけでなく受信先まで要件に書く

まずは一つの完結した操作に範囲を絞ります。テストアプリでユーザーが架空の申請内容を入力し、ボタンを押して、その内容とテストレコードの番号を指定のテスト用受信先に送り、成功か失敗を表示する流れです。最初の試行に承認、支払い、レコード削除まで同時に加えないようにします。Ada の構築ガイドも、まとまりのある一つの変更から始めることを勧めています。新機能が既存の画面遷移やデータの動きを変えていないか判断しやすくなるためです。

アクション名を付ける際には、実行条件と用途も説明します。例えば「現在のテスト申請をテスト用チャンネルへ通知」は、「申請を処理」より確認しやすい表現です。公式の Custom Actions ドキュメントによると、Ada は説明文を読んで、いつ、どのようにアクションを呼び出すか判断します。説明が曖昧だと、API がつながっていても、後で画面の誤った場所に接続される可能性があります。

テスト用チャンネルはこの例での選択肢にすぎず、すべてのサービスにサンドボックスがあるわけではありません。受信側に隔離環境がなければ、許可を得た、実際の顧客を煩わせないテスト先を先に用意します。それができない場合は画面を下書きのままにし、本番通知には接続しません。

サンプル値も実際の操作への入力になる

受信側サービスの API ドキュメントに従い、メソッド、アドレス、必要な変数を設定し、サンプル値がすべて架空のデータか確認します。特に送信先チャンネル、メールアドレス、レコード番号を確かめてください。「サンプル」欄にあるから使われないとは考えないことです。

Ada のドキュメントでは、Test はこのサンプル値でリクエストを実行し、成功時には応答のサンプルを保持して、返されたフィールドを画面につなぐのに役立てると説明されています。単に形式を検査するボタンではありません。テスト前には、どの受信先にどのメッセージが現れ、アプリに何が表示されるべきかを書き出します。実行後は外部の結果と画面の結果を両方確認します。API が成功を返しても、通知先が間違っていれば合格ではありません。

キーはプロンプト、通常の入力欄、サンプルメッセージではなく、専用の Secrets 設定に置きます。公式説明によれば、キーはサーバー上で暗号化して保存され、呼び出し時に挿入されるため、アプリとともに配布されません。ただし、この仕組みが外部サービスへ送ってよい業務データを判断してくれるわけではありません。送信フィールドは個別に選別する必要があります。

ボタンだけでなく全体の流れをたどる

アクションのテストが通ったら、プレビューで申請ページに入るところから一通り操作します。新しいボタンを押すだけで終わらせません。さらに、未入力、読み込み中、API エラーなどの場合に、表示される説明が理解できるか確認します。公式のプレビューガイドは、ユーザーの全経路とこれらの状態を確認するよう求めています。生成された画面がすべての状況を正しく処理済みだと保証しているわけではありません。

通知の流れには三つの受け入れ確認項目を設けられます。成功表示は受信先への実際の到着と対応しているか。失敗しても誤って送信済みと表示されないか。ユーザーが繰り返し押すと、チームとして許容できない重複通知が生じないか。重複送信が業務に影響する場合は、API の担当者に防止方法を確認する必要があります。Ada や受信側サービスが自動で解決していると決めつけてはいけません。

変更が完了するたびに、「テスト通知フロー確認済み」など、判別できるバージョン名を付けます。Ada のドキュメントでは、完了した変更を、名前を付けて復元できるバージョンとして保存できると説明しています。アプリのバージョン復元を、外部に送信済みのメッセージを取り消す方法と捉えるべきではありません。通知がアプリの外に出た後の処理には、受信側の仕組みが必要です。

最後に、プレビューでの確認と本番での確認を分けます。本番環境では送信先、キー、権限が異なる可能性があるため、切り替え後も許可されたテスト内容で全経路をもう一度確認します。Adalo の公式ガイドも公開後の体験を別途テストするよう求めています。画面のフィードバックと外部の処理が対応して初めて、このボタンを実際の業務ユーザーに渡せます。

内容説明:本記事は公開情報をもとに整理した、ツール選定の参考情報です。機能、料金、関連ポリシーは随時変更される場合があります。最新の公式情報をご確認ください。

元の出典:ada-help.adalo.com