SimpleSurvey (versão prévia)
Com esse conector, você pode se conectar facilmente aos seus projetos simpleSurvey para acessar dados de pesquisa, automatizar fluxos de trabalho e permanecer informado por meio de gatilhos controlados por eventos. Quer você esteja medindo o envolvimento dos funcionários, acompanhando a satisfação do cliente ou gerenciando processos de registro, o SimpleSurvey ajuda você a centralizar insights e tomar medidas mais rapidamente.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Government regiões - Azure regiões da China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões Power Apps exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte ao SimpleSurvey |
| URL | https://simplesurvey.com/contact |
| support@simplesurvey.com |
| Metadados do conector | |
|---|---|
| Publicador | SimpleSurvey |
| Site | https://simplesurvey.com/ |
| Política de privacidade | https://form.simplesurvey.com/oss/external/privacypolicy.aspx?lang=EN |
| Categorias | Dados; Comunicação |
Conector SimpleSurvey
Com esse conector, você pode se conectar facilmente aos seus projetos simpleSurvey para acessar dados de pesquisa, automatizar fluxos de trabalho e permanecer informado por meio de gatilhos controlados por eventos. Quer você esteja medindo o envolvimento dos funcionários, acompanhando a satisfação do cliente ou gerenciando processos de registro, o SimpleSurvey ajuda você a centralizar insights e tomar medidas mais rapidamente.
Pré-requisitos
Você precisará do seguinte para continuar:
- Um plano do Microsoft Power Apps ou Power Automate com o recurso de conector personalizado
- Uma assinatura válida do SimpleSurvey com a integração Power Apps e recursos de chave de acesso compartilhado habilitados
- Chave de API Power Apps da sua conta
Operações com suporte
O conector dá suporte às seguintes operações:
-
Get surveys: lista todas as suas pesquisas qualificadas. -
Get survey respondents details in JSON or CSV format: obtém detalhes específicos sobre os entrevistados da pesquisa no formato selecionado. -
Schedule a task: agende uma tarefa automatizada no SimpleSurvey. -
Get your survey data warehouse report in JSON or CSV format: obtém todos os dados sobre os entrevistados da pesquisa e suas respostas no formato selecionado. -
Get your project's statistics: obtém as informações mais recentes do projeto.
Gatilhos com suporte
-
When a response is submitted: programa um fluxo a ser executado quando uma resposta é recebida em sua pesquisa. -
When a response is changed: programa um fluxo a ser executado quando uma resposta é modificada em sua pesquisa.
Problemas e limitações conhecidos
- Nem todos os tipos de tarefas agendadas estão disponíveis para esse conector.
- O formato datetime compatível com esse conector é: yyyy-MM-dd HH:mm
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| chave_de_api | cadeia de caracteres segura | O api_key desta api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Agendar uma tarefa |
Agendar uma tarefa automática para sua pesquisa |
| Obter as estatísticas do projeto |
Obter as estatísticas do projeto |
| Obter detalhes dos entrevistados da pesquisa no formato JSON ou CSV |
Obter detalhes sobre os entrevistados da pesquisa no formato JSON ou CSV |
| Obter o relatório datawarehouse da pesquisa no formato JSON ou CSV |
Obter o relatório datawarehouse da pesquisa no formato JSON ou CSV |
| Obter pesquisas |
Obtenha todas as pesquisas qualificadas. |
Agendar uma tarefa
Agendar uma tarefa automática para sua pesquisa
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
A pesquisa
|
idProject | True | string |
Selecionar uma pesquisa |
|
Insira sua chave de acesso compartilhado para esta pesquisa
|
X-SAKKey | True | string |
Deve ser sua chave para a pesquisa selecionada |
|
tipo
|
type | True | integer |
Tipo de tarefa |
|
descrição
|
description | True | string |
Descrição da tarefa |
|
date
|
date | True | date-time |
Data de execução (formato: yyyy-MM-dd HH:mm) |
|
idOtherSurvey
|
idSurveyFrom | string |
Projeto ao qual atribuir (Definir para os tipos 6 e 7) |
|
|
allParticipants
|
allParticipants | boolean |
Enviar para (Definido para os tipos 10X &14) |
|
|
communicationMode
|
communicationMode | string |
Modo de comunicação (definido apenas para tarefas de "lembrete em massa" e "convite inicial") |
|
|
idAssignationGroup
|
idAssignationGroup | string |
Somente membros de destino dos grupos a seguir (opcionalmente definidos para os tipos 101 a 105) |
|
|
idContactGroup
|
idContactGroup | string |
Nome do Grupo de Contatos (Definido para o tipo 3) |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
sucesso
|
success | boolean |
sucesso |
|
errormsg
|
errormsg | string |
errormsg |
|
successmsg
|
successmsg | string |
successmsg |
Obter as estatísticas do projeto
Obter as estatísticas do projeto
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
A pesquisa
|
idProject | True | string |
Selecionar uma pesquisa |
|
Forçar a recompilação de estatísticas?
|
f | True | boolean |
Defina esse valor para forçar a recompilação de estatísticas |
|
Insira sua chave de acesso compartilhado para esta pesquisa
|
X-SAKKey | True | string |
Deve ser sua chave para a pesquisa selecionada |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
AssignedCount | integer |
AssignedCount |
|
|
AssignedContactCount | integer |
AssignedContactCount |
|
|
AssignedDistributionListMemberCount | integer |
AssignedDistributionListMemberCount |
|
|
AssignedNoInviteDeliveredCount | integer |
AssignedNoInviteDeliveredCount |
|
|
EligibleContactCount | integer |
EligibleContactCount |
|
InviteSentCount
|
InviteSentCount | integer |
InviteSentCount |
|
InviteBouncedCount
|
InviteBouncedCount | integer |
InviteBouncedCount |
|
InviteBounceRate
|
InviteBounceRate | float |
InviteBounceRate |
|
InviteDeliveredCount
|
InviteDeliveredCount | integer |
InviteDeliveredCount |
|
InviteDeliveryRate
|
InviteDeliveryRate | float |
InviteDeliveryRate |
|
InviteOpenedCount
|
InviteOpenedCount | integer |
InviteOpenedCount |
|
InviteOpenRate
|
InviteOpenRate | float |
InviteOpenRate |
|
UnsubscribedCount
|
UnsubscribedCount | integer |
UnsubscribedCount |
|
Cancelar a taxa de inscrição
|
UnsubscribeRate | float |
Cancelar a taxa de inscrição |
|
InviteDeliveredNoAccessCount
|
InviteDeliveredNoAccessCount | integer |
InviteDeliveredNoAccessCount |
|
EmptyCount
|
EmptyCount | integer |
EmptyCount |
|
EmptyPercentage
|
EmptyPercentage | float |
EmptyPercentage |
|
|
AccessedCount | integer |
AccessedCount |
|
RespondCount
|
RespondedCount | integer |
RespondCount |
|
InProgressCount
|
InProgressCount | integer |
InProgressCount |
|
|
CompletedCount | integer |
CompletedCount |
|
|
ClosedCount | integer |
ClosedCount |
|
InProgressPercentage
|
InProgressPercentage | float |
InProgressPercentage |
|
CompletedPercentage
|
CompletedPercentage | float |
CompletedPercentage |
|
ClosedPercentage
|
ClosedPercentage | float |
ClosedPercentage |
|
CompletionRate_CompletedOverResponded
|
CompletionRate_CompletedOverResponded | float |
CompletionRate_CompletedOverResponded |
|
CompletionRate_CompletedOverAccessed
|
CompletionRate_CompletedOverAccessed | float |
CompletionRate_CompletedOverAccessed |
|
ResponseRate_RespondedOverAssigned
|
ResponseRate_RespondedOverAssigned | float |
ResponseRate_RespondedOverAssigned |
|
ResponseRate_CompletedOverAssigned
|
ResponseRate_CompletedOverAssigned | float |
ResponseRate_CompletedOverAssigned |
|
ResponseRate_RespondedOverInvited
|
ResponseRate_RespondedOverInvited | float |
ResponseRate_RespondedOverInvited |
|
ResponseRate_CompletedOverInvited
|
ResponseRate_CompletedOverInvited | float |
ResponseRate_CompletedOverInvited |
|
CompletionTime_Avg
|
CompletionTime_Avg | integer |
CompletionTime_Avg |
|
CompletionTime_Med
|
CompletionTime_Med | integer |
CompletionTime_Med |
|
OptInConfirmationCount
|
OptInConfirmationCount | integer |
OptInConfirmationCount |
|
EmailSentCount
|
EmailSentCount | integer |
EmailSentCount |
|
SMSSentCount
|
SMSSentCount | integer |
SMSSentCount |
|
LastCompletedDate
|
LastCompletedDate | string |
LastCompletedDate |
|
LastUpdatedDate
|
LastUpdatedDate | string |
LastUpdatedDate |
|
CompletedCountPerDayString
|
CompletedCountPerDayString | string |
CompletedCountPerDayString |
|
CompletedCountPerDay
|
CompletedCountPerDay | array of object |
CompletedCountPerDay |
|
|
CompletedCountPerDay.timestamp | integer |
carimbo de data/hora |
|
contagem
|
CompletedCountPerDay.count | integer |
contagem |
|
CompletedCountPerMonthString
|
CompletedCountPerMonthString | string |
CompletedCountPerMonthString |
|
CompletedCountPerMonth
|
CompletedCountPerMonth | array of object |
CompletedCountPerMonth |
|
|
CompletedCountPerMonth.timestamp | integer |
carimbo de data/hora |
|
contagem
|
CompletedCountPerMonth.count | integer |
contagem |
|
sucesso
|
success | boolean |
sucesso |
Obter detalhes dos entrevistados da pesquisa no formato JSON ou CSV
Obter detalhes sobre os entrevistados da pesquisa no formato JSON ou CSV
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
A pesquisa
|
idProject | True | string |
Selecionar uma pesquisa |
|
Obter detalhes sobre
|
tableCode | True | string |
Os detalhes a serem obtidos |
|
O formato dos dados retornados
|
format | True | string |
Deve ser JSON ou CSV |
|
Insira sua chave de acesso compartilhado para esta pesquisa
|
X-SAKKey | True | string |
Deve ser sua chave para a pesquisa selecionada |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
respondentsTable
|
respondentsTable | array of object |
respondentsTable |
|
respondent_id
|
respondentsTable.respondent_id | string |
respondent_id |
|
ip
|
respondentsTable.ip | string |
ip |
|
|
respondentsTable.internal_id | integer |
internal_id |
|
info1
|
respondentsTable.info1 | string |
info1 |
|
info2
|
respondentsTable.info2 | string |
info2 |
|
info3
|
respondentsTable.info3 | string |
info3 |
|
info4
|
respondentsTable.info4 | string |
info4 |
|
info5
|
respondentsTable.info5 | string |
info5 |
|
navegador
|
respondentsTable.browser | string |
navegador |
|
plataforma
|
respondentsTable.platform | string |
plataforma |
|
is_mobile
|
respondentsTable.is_mobile | boolean |
is_mobile |
|
referer_url
|
respondentsTable.referer_url | string |
referer_url |
|
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 |
|
last_savecont_date_utc
|
respondentsTable.last_savecont_date_utc | string |
last_savecont_date_utc |
|
lang_code
|
respondentsTable.lang_code | string |
lang_code |
|
lang_localized
|
respondentsTable.lang_localized | string |
lang_localized |
|
|
respondentsTable.score | float |
pontuação |
|
|
respondentsTable.score_auto | float |
score_auto |
|
|
respondentsTable.score_manual | float |
score_manual |
|
completion_time
|
respondentsTable.completion_time | integer |
completion_time |
|
title
|
respondentsTable.title | string |
title |
|
móvel
|
respondentsTable.mobile | string |
móvel |
|
organização
|
respondentsTable.organization | string |
organização |
|
segmento
|
respondentsTable.segment | string |
segmento |
|
local
|
respondentsTable.location | string |
local |
|
primeiro_nome
|
respondentsTable.first_name | string |
primeiro_nome |
|
sobrenome
|
respondentsTable.last_name | string |
sobrenome |
|
email
|
respondentsTable.email | string |
|
|
state_code
|
respondentsTable.state_code | string |
state_code |
|
state_localized
|
respondentsTable.state_localized | string |
state_localized |
|
agrupar
|
respondentsTable.group | string |
agrupar |
|
espaço de trabalho
|
respondentsTable.workspace | string |
espaço de trabalho |
|
collector_code
|
respondentsTable.collector_code | string |
collector_code |
|
fixar
|
respondentsTable.pin | string |
fixar |
|
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 |
|
column_id
|
caseTable.column_id | string |
column_id |
|
sub_element
|
caseTable.sub_element | integer |
sub_element |
|
value
|
caseTable.value | string |
value |
|
variableTable
|
variableTable | array of object |
variableTable |
|
element_id
|
variableTable.element_id | string |
element_id |
|
variable_id
|
variableTable.variable_id | string |
variable_id |
|
column_id
|
variableTable.column_id | string |
column_id |
|
sub_element
|
variableTable.sub_element | integer |
sub_element |
|
element_label
|
variableTable.element_label | string |
element_label |
|
variable_label
|
variableTable.variable_label | string |
variable_label |
|
column_label
|
variableTable.column_label | string |
column_label |
|
sub_element_label
|
variableTable.sub_element_label | string |
sub_element_label |
|
descrição
|
variableTable.description | string |
descrição |
|
variableValueLabelTable
|
variableValueLabelTable | array of object |
variableValueLabelTable |
|
element_id
|
variableValueLabelTable.element_id | string |
element_id |
|
variable_id
|
variableValueLabelTable.variable_id | string |
variable_id |
|
column_id
|
variableValueLabelTable.column_id | string |
column_id |
|
sub_element
|
variableValueLabelTable.sub_element | integer |
sub_element |
|
descrição
|
variableValueLabelTable.description | string |
descrição |
|
etiqueta
|
variableValueLabelTable.label | string |
etiqueta |
|
genericFieldHeaderTable
|
genericFieldHeaderTable | array of object |
genericFieldHeaderTable |
|
generic_field_id
|
genericFieldHeaderTable.generic_field_id | integer |
generic_field_id |
|
codificar
|
genericFieldHeaderTable.code | string |
codificar |
|
nome
|
genericFieldHeaderTable.name | string |
nome |
|
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 |
|
genericFieldDataTable_csv
|
genericFieldDataTable_csv | string |
genericFieldDataTable_csv |
|
genericFieldHeaderTable_csv
|
genericFieldHeaderTable_csv | string |
genericFieldHeaderTable_csv |
|
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 |
Obter o relatório datawarehouse da pesquisa no formato JSON ou CSV
Obter o relatório datawarehouse da pesquisa no formato JSON ou CSV
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
A pesquisa
|
idProject | True | string |
Selecionar uma pesquisa |
|
O formato dos dados retornados
|
format | True | string |
Deve ser JSON ou CSV |
|
Insira sua chave de acesso compartilhado para esta pesquisa
|
X-SAKKey | True | string |
Deve ser sua chave para a pesquisa selecionada |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
DatawarehouseRpt
|
DatawarehouseRpt | array of object |
DatawarehouseRpt |
|
QuestionProgId
|
DatawarehouseRpt.QuestionProgId | string |
QuestionProgId |
|
Pergunta
|
DatawarehouseRpt.Question | string |
Pergunta |
|
Resposta
|
DatawarehouseRpt.Response | string |
Resposta |
|
Comment
|
DatawarehouseRpt.Comment | string |
Comment |
|
SubQuestion
|
DatawarehouseRpt.SubQuestion | string |
SubQuestion |
|
Score
|
DatawarehouseRpt.Score | float |
Score |
|
Date_Time
|
DatawarehouseRpt.Date_Time | string |
Date_Time |
|
Situação
|
DatawarehouseRpt.Status | string |
Situação |
|
|
DatawarehouseRpt.InternalID | integer |
InternalID |
|
Linguagem
|
DatawarehouseRpt.Language | string |
Linguagem |
|
CreatedAt
|
DatawarehouseRpt.CreatedAt | string |
CreatedAt |
|
AtualizadoAt
|
DatawarehouseRpt.UpdatedAt | string |
AtualizadoAt |
|
Localidade
|
DatawarehouseRpt.Location | string |
Localidade |
|
GETVariables
|
DatawarehouseRpt.GETVariables | string |
GETVariables |
|
Referenciador
|
DatawarehouseRpt.Referrer | string |
Referenciador |
|
WeightedScore
|
DatawarehouseRpt.WeightedScore | float |
WeightedScore |
|
Endereço IP
|
DatawarehouseRpt.IPAddress | string |
Endereço IP |
|
BrowserName
|
DatawarehouseRpt.BrowserName | string |
BrowserName |
|
Sistema Operacional
|
DatawarehouseRpt.OperatingSystem | string |
Sistema Operacional |
|
InviteCode
|
DatawarehouseRpt.InviteCode | string |
InviteCode |
|
InviteEmail
|
DatawarehouseRpt.InviteEmail | string |
InviteEmail |
|
InviteName
|
DatawarehouseRpt.InviteName | string |
InviteName |
|
Collector
|
DatawarehouseRpt.Collector | string |
Collector |
|
DatawarehouseRpt_csv
|
DatawarehouseRpt_csv | string |
DatawarehouseRpt_csv |
Obter pesquisas
Obtenha todas as pesquisas qualificadas.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of object |
value |
|
display_name
|
value.display_name | string |
display_name |
|
id
|
value.id | string |
id |
|
Chave compartilhada
|
value.sharedKey | string |
Chave compartilhada |
|
sucesso
|
success | boolean |
sucesso |
|
errormsg
|
errormsg | string |
errormsg |
|
errordetails
|
errordetails | string |
errordetails |
|
código de erro
|
errorcode | string |
código de erro |
|
contexto
|
context | string |
contexto |
Gatilhos
| Quando uma resposta é alterada |
Quando uma resposta é alterada |
| Quando uma resposta é enviada |
Quando uma resposta é enviada |
Quando uma resposta é alterada
Quando uma resposta é alterada
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
A pesquisa
|
idProject | True | string |
Selecionar uma pesquisa |
|
O fluxo de trabalho de comunicação de destino
|
automationId | True | integer |
O fluxo de trabalho de comunicação de destino |
|
Insira sua chave de acesso compartilhado para esta pesquisa
|
X-SAKKey | True | string |
Deve ser sua chave para a pesquisa selecionada |
|
Nome
|
Name | True | string |
Nome |
Quando uma resposta é enviada
Quando uma resposta é enviada
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
A pesquisa
|
idProject | True | string |
Selecionar uma pesquisa |
|
O fluxo de trabalho de comunicação de destino
|
automationId | True | integer |
O fluxo de trabalho de comunicação de destino |
|
Insira sua chave de acesso compartilhado para esta pesquisa
|
X-SAKKey | True | string |
Deve ser sua chave para a pesquisa selecionada |
|
Nome
|
Name | True | string |
Nome |