SimpleSurvey(預覽)
透過此連接器,您可以輕鬆連接 SimpleSurvey 專案,存取調查資料、自動化工作流程,並透過事件驅動的觸發器隨時掌握最新資訊。 無論您是在衡量員工參與度、追蹤顧客滿意度,或管理註冊流程,SimpleSurvey 都能幫助您集中洞察並更快採取行動。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | SimpleSurvey 支援 |
| URL | https://simplesurvey.com/contact |
| support@simplesurvey.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | SimpleSurvey 簡易調查 |
| 網站 | https://simplesurvey.com/ |
| 隱私策略 | https://form.simplesurvey.com/oss/external/privacypolicy.aspx?lang=EN |
| 類別 | 資料;傳達 |
SimpleSurvey 連接器
透過此連接器,您可以輕鬆連接 SimpleSurvey 專案,存取調查資料、自動化工作流程,並透過事件驅動的觸發器隨時掌握最新資訊。 無論您是在衡量員工參與度、追蹤顧客滿意度,或管理註冊流程,SimpleSurvey 都能幫助您集中洞察並更快採取行動。
先決條件
您將需要以下內容才能繼續:
- 具有自訂連接器功能的 Microsoft Power Apps 或 Power Automate 方案
- 有效的 SimpleSurvey 訂閱,並啟用 Power Apps 整合及共享存取關鍵功能
- 你帳號的 Power Apps API 金鑰
支援的作業
連接器支援下列作業:
-
Get surveys列出所有符合資格的調查。 -
Get survey respondents details in JSON or CSV format:以所選格式提供您調查受訪者的具體細節。 -
Schedule a task:在 SimpleSurvey 中排程自動化任務。 -
Get your survey data warehouse report in JSON or CSV format:取得您調查受訪者及其回應的所有資料,並以所選格式呈現。 -
Get your project's statistics:獲得你專案的最新見解。
支援的觸發器
-
When a response is submitted:程式會產生流程,當您的調查收到回應時執行。 -
When a response is changed:程式流程,當您的調查中回應被修改時會執行。
已知問題和限制
- 並非所有類型的排程任務都能在此連接器上使用。
- 此連接器支援的日期時間格式為:yyyy-MM-dd HH:mm
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 密鑰 (api_key) | 安全字串 | 此 API 的api_key | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 以 JSON 或 CSV 格式取得調查受訪者詳細資料 |
以 JSON 或 CSV 格式取得調查受訪者的詳細資訊 |
| 取得你的專案統計數據 |
取得你的專案統計數據 |
| 取得問卷 |
取得所有符合資格的問卷。 |
| 取得您的調查資料庫報告(JSON或CSV)格式 |
取得您的調查資料庫報告(JSON或CSV)格式 |
| 排定工作 |
為您的調查安排自動任務 |
以 JSON 或 CSV 格式取得調查受訪者詳細資料
以 JSON 或 CSV 格式取得調查受訪者的詳細資訊
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
調查過程
|
idProject | True | string |
選取問卷 |
|
獲取詳細資訊
|
tableCode | True | string |
細節要取得 |
|
回傳資料的格式
|
format | True | string |
必須是 JSON 或 CSV |
|
使用共享存取鑰匙進行調查:
|
X-SAKKey | True | string |
必須與所選調查相同 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
受訪者表格
|
respondentsTable | array of object |
受訪者表格 |
|
respondent_id
|
respondentsTable.respondent_id | string |
respondent_id |
|
ip
|
respondentsTable.ip | string |
ip |
|
internal_id
|
respondentsTable.internal_id | integer |
internal_id |
|
資訊1
|
respondentsTable.info1 | string |
資訊1 |
|
資訊2
|
respondentsTable.info2 | string |
資訊2 |
|
資訊3
|
respondentsTable.info3 | string |
資訊3 |
|
資訊4
|
respondentsTable.info4 | string |
資訊4 |
|
資訊5
|
respondentsTable.info5 | string |
資訊5 |
|
confirmation_number
|
respondentsTable.confirmation_number | string |
confirmation_number |
|
created_date_utc
|
respondentsTable.created_date_utc | string |
created_date_utc |
|
first_answer_date_utc
|
respondentsTable.first_answer_date_utc | string |
first_answer_date_utc |
|
last_answer_date_utc
|
respondentsTable.last_answer_date_utc | string |
last_answer_date_utc |
|
submitted_date_utc
|
respondentsTable.submitted_date_utc | string |
submitted_date_utc |
|
lang_code
|
respondentsTable.lang_code | string |
lang_code |
|
lang_localized
|
respondentsTable.lang_localized | string |
lang_localized |
|
分數
|
respondentsTable.score | integer |
分數 |
|
score_auto
|
respondentsTable.score_auto | integer |
score_auto |
|
completion_time
|
respondentsTable.completion_time | integer |
completion_time |
|
state_code
|
respondentsTable.state_code | string |
state_code |
|
state_localized
|
respondentsTable.state_localized | string |
state_localized |
|
caseTable(案例表)
|
caseTable | array of object |
caseTable(案例表) |
|
respondent_id
|
caseTable.respondent_id | string |
respondent_id |
|
element_id
|
caseTable.element_id | string |
element_id |
|
variable_id
|
caseTable.variable_id | string |
variable_id |
|
value
|
caseTable.value | string |
value |
|
變數表格
|
variableTable | array of object |
變數表格 |
|
element_id
|
variableTable.element_id | string |
element_id |
|
element_label
|
variableTable.element_label | string |
element_label |
|
描述
|
variableTable.description | string |
描述 |
|
variable_id
|
variableTable.variable_id | string |
variable_id |
|
variable_label
|
variableTable.variable_label | string |
variable_label |
|
variableValueLabelTable
|
variableValueLabelTable | array of object |
variableValueLabelTable |
|
element_id
|
variableValueLabelTable.element_id | string |
element_id |
|
variable_id
|
variableValueLabelTable.variable_id | string |
variable_id |
|
描述
|
variableValueLabelTable.description | string |
描述 |
|
標籤
|
variableValueLabelTable.label | string |
標籤 |
|
genericFieldHeaderTable
|
genericFieldHeaderTable | array of object |
genericFieldHeaderTable |
|
generic_field_id
|
genericFieldHeaderTable.generic_field_id | integer |
generic_field_id |
|
名稱
|
genericFieldHeaderTable.name | string |
名稱 |
|
字碼
|
genericFieldHeaderTable.code | string |
字碼 |
|
genericFieldDataTable
|
genericFieldDataTable | array of object |
genericFieldDataTable |
|
generic_field_id
|
genericFieldDataTable.generic_field_id | integer |
generic_field_id |
|
respondent_id
|
genericFieldDataTable.respondent_id | string |
respondent_id |
|
value
|
genericFieldDataTable.value | string |
value |
|
respondentsTable_csv
|
respondentsTable_csv | string |
respondentsTable_csv |
|
caseTable_csv
|
caseTable_csv | string |
caseTable_csv |
|
variableTable_csv
|
variableTable_csv | string |
variableTable_csv |
|
variableValueLabelTable_csv
|
variableValueLabelTable_csv | string |
variableValueLabelTable_csv |
|
genericFieldHeaderTable_csv
|
genericFieldHeaderTable_csv | string |
genericFieldHeaderTable_csv |
|
genericFieldDataTable_csv
|
genericFieldDataTable_csv | string |
genericFieldDataTable_csv |
|
成功
|
success | boolean |
成功 |
取得你的專案統計數據
取得你的專案統計數據
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
調查過程
|
idProject | True | string |
選取問卷 |
|
強制重新彙編統計數據?
|
f | True | boolean |
設定此值以強制重新編譯統計量 |
|
使用共享存取鑰匙進行調查:
|
X-SAKKey | True | string |
必須與所選調查相同 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
指派計數
|
value.AssignedCount | integer |
指派計數 |
|
AssignedContactCount
|
value.AssignedContactCount | integer |
AssignedContactCount |
|
分配列表成員計數
|
value.AssignedDistributionListMemberCount | integer |
分配列表成員計數 |
|
AssignedNoInviteDeliveredCount
|
value.AssignedNoInviteDeliveredCount | integer |
AssignedNoInviteDeliveredCount |
|
符合資格的聯絡人數
|
value.EligibleContactCount | integer |
符合資格的聯絡人數 |
|
邀請發送計數
|
value.InviteSentCount | integer |
邀請發送計數 |
|
邀請退票
|
value.InviteBouncedCount | integer |
邀請退票 |
|
邀請退票率
|
value.InviteBounceRate | integer |
邀請退票率 |
|
邀請DeliveredCount
|
value.InviteDeliveredCount | integer |
邀請DeliveredCount |
|
邀請送達率
|
value.InviteDeliveryRate | integer |
邀請送達率 |
|
邀請開放計數
|
value.InviteOpenedCount | integer |
邀請開放計數 |
|
邀請開放率
|
value.InviteOpenRate | integer |
邀請開放率 |
|
取消訂閱計數
|
value.UnsubscribedCount | integer |
取消訂閱計數 |
|
取消訂閱率
|
value.UnsubscribeRate | integer |
取消訂閱率 |
|
邀請已交付無存取計數
|
value.InviteDeliveredNoAccessCount | integer |
邀請已交付無存取計數 |
|
空計數
|
value.EmptyCount | integer |
空計數 |
|
空百分比
|
value.EmptyPercentage | integer |
空百分比 |
|
存取計數
|
value.AccessedCount | integer |
存取計數 |
|
回應了
|
value.RespondedCount | integer |
回應了 |
|
進行中計數
|
value.InProgressCount | integer |
進行中計數 |
|
完成計數
|
value.CompletedCount | integer |
完成計數 |
|
封閉計數
|
value.ClosedCount | integer |
封閉計數 |
|
進步百分比
|
value.InProgressPercentage | float |
進步百分比 |
|
完成百分比
|
value.CompletedPercentage | float |
完成百分比 |
|
封閉百分比
|
value.ClosedPercentage | float |
封閉百分比 |
|
CompletionRate_CompletedOverResponded
|
value.CompletionRate_CompletedOverResponded | float |
CompletionRate_CompletedOverResponded |
|
CompletionRate_CompletedOverAccessed
|
value.CompletionRate_CompletedOverAccessed | float |
CompletionRate_CompletedOverAccessed |
|
CompletionTime_Avg
|
value.CompletionTime_Avg | integer |
CompletionTime_Avg |
|
CompletionTime_Med
|
value.CompletionTime_Med | integer |
CompletionTime_Med |
|
OptInConfirmationCount
|
value.OptInConfirmationCount | integer |
OptInConfirmationCount |
|
電子郵件發送計數
|
value.EmailSentCount | integer |
電子郵件發送計數 |
|
最後完成日期
|
value.LastCompletedDate | string |
最後完成日期 |
|
最後更新日期
|
value.LastUpdatedDate | string |
最後更新日期 |
|
完成了每日計數字串
|
value.CompletedCountPerDayString | string |
完成了每日計數字串 |
|
完成CountPerDay
|
value.CompletedCountPerDay | array of array |
完成CountPerDay |
|
items
|
value.CompletedCountPerDay | array of integer | |
|
完成的每月計數字串
|
value.CompletedCountPerMonthString | string |
完成的每月計數字串 |
|
每月完成計數
|
value.CompletedCountPerMonth | array of array |
每月完成計數 |
|
items
|
value.CompletedCountPerMonth | array of integer | |
|
成功
|
success | boolean |
成功 |
取得問卷
取得所有符合資格的問卷。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of object |
value |
|
display_name
|
value.display_name | string |
display_name |
|
識別碼
|
value.id | string |
識別碼 |
|
共享密鑰
|
value.sharedKey | string |
共享密鑰 |
|
成功
|
success | boolean |
成功 |
|
錯誤訊息
|
errormsg | string |
錯誤訊息 |
|
錯誤詳情
|
errordetails | string |
錯誤詳情 |
|
錯誤代碼
|
errorcode | string |
錯誤代碼 |
|
內容
|
context | string |
內容 |
取得您的調查資料庫報告(JSON或CSV)格式
取得您的調查資料庫報告(JSON或CSV)格式
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
調查過程
|
idProject | True | string |
選取問卷 |
|
回傳資料的格式
|
format | True | string |
必須是 JSON 或 CSV |
|
使用共享存取鑰匙進行調查:
|
X-SAKKey | True | string |
必須與所選調查相同 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
DatawarehouseRpt
|
DatawarehouseRpt | array of object |
DatawarehouseRpt |
|
問題進展
|
DatawarehouseRpt.QuestionProgId | string |
問題進展 |
|
Question
|
DatawarehouseRpt.Question | string |
Question |
|
回應
|
DatawarehouseRpt.Response | string |
回應 |
|
子問題
|
DatawarehouseRpt.SubQuestion | string |
子問題 |
|
|
DatawarehouseRpt.Score | float |
Score |
|
Date_Time
|
DatawarehouseRpt.Date_Time | string |
Date_Time |
|
地位
|
DatawarehouseRpt.Status | string |
地位 |
|
內部識別
|
DatawarehouseRpt.InternalID | integer |
內部識別 |
|
語言
|
DatawarehouseRpt.Language | string |
語言 |
|
建立於
|
DatawarehouseRpt.CreatedAt | string |
建立於 |
|
更新於
|
DatawarehouseRpt.UpdatedAt | string |
更新於 |
|
加權分數
|
DatawarehouseRpt.WeightedScore | integer |
加權分數 |
|
IP位址
|
DatawarehouseRpt.IPAddress | string |
IP位址 |
|
邀請名稱
|
DatawarehouseRpt.InviteName | string |
邀請名稱 |
|
評論
|
DatawarehouseRpt.Comment | string |
評論 |
|
DatawarehouseRpt_csv
|
DatawarehouseRpt_csv | string |
DatawarehouseRpt_csv |
|
成功
|
success | boolean |
成功 |
排定工作
為您的調查安排自動任務
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
調查過程
|
idProject | True | string |
選取問卷 |
|
使用共享存取鑰匙進行調查:
|
X-SAKKey | True | string |
必須與所選調查相同 |
|
型別
|
type | True | integer |
任務類型 |
|
描述
|
description | True | string |
工作描述 |
|
date
|
date | True | date-time |
執行日期(格式:yyyy-MM-dd HH:mm) |
|
idOtherSurvey
|
idSurveyFrom | string |
要指派的專案(類型 6 與 7 的集合) |
|
|
所有參與者
|
allParticipants | boolean |
發送至(設定為類型 10X 與 14) |
|
|
通訊模式
|
communicationMode | string |
溝通模式(僅設定為「群眾提醒」與「初始邀請」任務) |
|
|
idAssignationGroup
|
idAssignationGroup | string |
僅鎖定以下群組成員(可選擇性設定為類型101至105) |
|
|
idContactGroup
|
idContactGroup | string |
聯絡群組名稱(設定為類型3) |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
成功
|
success | boolean |
成功 |
|
錯誤訊息
|
errormsg | string |
錯誤訊息 |
|
成功MSG
|
successmsg | string |
成功MSG |
觸發程序
| 提交回應時 |
提交回應時 |
| 當回應被改變時 |
當回應被改變時 |
提交回應時
提交回應時
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
調查過程
|
idProject | True | string |
選取問卷 |
|
目標通訊工作流程
|
automationId | True | integer |
目標通訊工作流程 |
|
使用共享存取鑰匙進行調查:
|
X-SAKKey | True | string |
必須與所選調查相同 |
|
名稱
|
Name | True | string |
名稱 |
當回應被改變時
當回應被改變時
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
調查過程
|
idProject | True | string |
選取問卷 |
|
目標通訊工作流程
|
automationId | True | integer |
目標通訊工作流程 |
|
使用共享存取鑰匙進行調查:
|
X-SAKKey | True | string |
必須與所選調查相同 |
|
名稱
|
Name | True | string |
名稱 |