アドレス帳 API 送信
SurveyMars 360度評価では「内部メッセージ(API)」を通じて、アドレス帳に登録された評価者へアンケート招待を送信できます。評価者は企業アドレス帳または回答待ちリストより内部メッセージを受け取り、アンケートに回答できます。アドレス帳APIと連携済みの法人向け機能で、メールに依存せず評価者へ招待を届けることが可能です。
機能概要
360度評価の「アンケート送信」画面にて、電子メール・パスワードログインに加え、「内部メッセージ(API)」を送信方法として選択できます。本機能は評価関係に登録された連絡先情報をもとに、アンケート招待を連携済みのアドレス帳チャネルへプッシュ送信します。回答データの統計分析画面では、送信元チャネルが「アドレス帳API」と表示されます。
利用前提条件
ご利用前に下記の条件をすべて満たしているかご確認ください。条件が不足している場合、送信画面に「内部メッセージ(API)」の項目が表示されない、または送信に失敗する可能性があります。
1. アカウントにてアドレス帳機能が有効化され、利用可能な状態であること。
2. SurveyMarsへご連絡いただき、アドレス帳API連携の開通手続きが完了していること。未開通の状態で項目をクリックすると、連携申し込みを促すメッセージが表示されます。
3. 評価関係一覧画面にて「連絡先を有効にする」をオンにし、連絡先リストより被評価者と評価者を設定済みであること。
補足：連絡先を有効にしていない場合、送信画面に「内部メッセージ(API)」の項目は表示されません。
操作手順
一、送信方法に内部メッセージ(API)を選択する
1. 対象の360度評価アンケートを開き、「アンケート送信」画面へ進みます。
2. 左側の「送信方法」欄より「内部メッセージ(API)」にチェックを入れます。
3. チェック後、右側の評価者一覧からメールアドレスの列が非表示になります。画面上部の案内より「内部メッセージを編集」または（送信済みの場合）「送信状況を確認」へ進めます。
補足：電子メール、パスワードログイン、内部メッセージ(API)は同時に選択可能です。排他関係にないため、用途に合わせて組み合わせてご利用いただけます。
二、内部メッセージを編集し送信する
1. 上部案内の「内部メッセージを編集」をクリックし、編集画面を開きます。
2. 「送信先」欄には送信対象の評価者名がタグ形式で表示され、初期状態ですべて選択されています。タグをクリックして今回の送信から除外するほか、「全選択解除」または右上の反転選択で送信対象を一括調整できます。
3. 必要に応じて送信タイミング（即時送信 / 予約送信）、連絡先向けオプション（「回答待ちリストへ表示」「匿名機能」など）を設定します。
4. 「送信内容」の文章を確認した後、「即時送信」（または予約時間に送信）をクリックします。
補足：選択解除は今回の送信のみ有効です。次回編集画面を開いた際、対象者は再び初期選択状態となります。他の手段で既に回答済みの評価者は送信リストから自動的に除外されます。本画面からは「連絡先の追加」「URL・QRコードの取得」は行えません。
三、送信状況を確認する
1. 送信完了後、「送信状況を確認」をクリックし状況画面へ移動します。
2. 一覧を「すべて」「送信中」「未回答」「回答済み」「送信失敗」で絞り込み、氏名、部署、ThirdUserId、メールアドレス、ステータス、送信日時を確認できます。
3. 送信失敗したレコードについては「再送信」より招待を再プッシュできます。
4. 評価者が回答を完了すると、「統計分析」→「回答の閲覧・ダウンロード」画面にて、送信元チャネルが「アドレス帳API」と表示され、チャネル詳細および評価関係を参照可能です。
設定オプション詳細
- 連絡先を有効にする：評価関係画面の切り替えスイッチです。オンにすることで送信画面に「内部メッセージ(API)」が表示され、連絡先リストから被評価者・評価者を選択できるようになります。
- 送信タイミング：即時送信または予約送信に対応。通常のアンケートAPI送信機能と仕様は同一です。
- 回答待ちリストへ表示：オンにすると招待メッセージが連絡先の回答待ちリストに表示されます（アドレス帳連携利用時に適しています）。
- 匿名機能：オンにすると回答者が送信した際、アドレス帳に登録された氏名・部署情報が非表示となります。
よくあるご質問
Q：送信画面に「内部メッセージ(API)」が表示されません。
A：評価関係画面で「連絡先を有効にする」がオンか、アカウントでアドレス帳機能が利用可能かをご確認ください。いずれかの条件が満たされていない場合、項目は表示されません。
Q：「内部メッセージ(API)」をクリックすると連携開通が必要というメッセージが出ます。どうすればよいですか？
A：本機能をご利用いただくにはアドレス帳API連携の開通手続きが必須です。SurveyMarsサポートまたはカスタマーサクセスチームへご連絡いただき、開通後に再度お試しください。
Q：メール送信とAPI送信を同時に利用することはできますか？
A：可能です。電子メール、パスワードログイン、内部メッセージ(API)は同時に選択でき、排他関係にありません。
Q：内部メッセージ編集画面で評価者を選択解除しました。次回も送信対象から除外されますか？
A：選択解除は今回の送信のみ有効です。回答が完了していない評価者は、次回編集画面を開いた際再び初期選択の状態に戻り、再度送信を行うことができます。
Q：メールから既に回答済みの評価者はAPI送信リストに表示されますか？
A：表示されません。回答完了済みのユーザーは自動的にリストから除外され、メール送信時と同じロジックで重複招待を回避します。
