Compartilhar via

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 do 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:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do 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 do 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
Email 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 do Power Automate com o recurso de conector personalizado
  • Uma assinatura válida do SimpleSurvey com a integração do Power Apps e os recursos de chave de acesso compartilhado habilitados
  • Chave de API do 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

ID da operação:
ScheduleTask

Agendar uma tarefa automática para sua pesquisa

Parâmetros

Nome Chave Obrigatório Tipo Description
A pesquisa
 idProject True string

Selecionar uma pesquisa
Use a chave de acesso compartilhado para a pesquisa:
 X-SAKKey True string

Deve ser o mesmo que 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

ID da operação:
GetSurveyStats

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
Use a chave de acesso compartilhado para a pesquisa:
 X-SAKKey True string

Deve ser o mesmo que a pesquisa selecionada

Retornos

Nome Caminho Tipo Description
AssignedCount
 value.AssignedCount integer

AssignedCount
AssignedContactCount
 value.AssignedContactCount integer

AssignedContactCount
AssignedDistributionListMemberCount
 value.AssignedDistributionListMemberCount integer

AssignedDistributionListMemberCount
AssignedNoInviteDeliveredCount
 value.AssignedNoInviteDeliveredCount integer

AssignedNoInviteDeliveredCount
EligibleContactCount
 value.EligibleContactCount integer

EligibleContactCount
InviteSentCount
 value.InviteSentCount integer

InviteSentCount
InviteBouncedCount
 value.InviteBouncedCount integer

InviteBouncedCount
InviteBounceRate
 value.InviteBounceRate integer

InviteBounceRate
InviteDeliveredCount
 value.InviteDeliveredCount integer

InviteDeliveredCount
InviteDeliveryRate
 value.InviteDeliveryRate integer

InviteDeliveryRate
InviteOpenedCount
 value.InviteOpenedCount integer

InviteOpenedCount
InviteOpenRate
 value.InviteOpenRate integer

InviteOpenRate
UnsubscribedCount
 value.UnsubscribedCount integer

UnsubscribedCount
Cancelar a taxa de inscrição
 value.UnsubscribeRate integer

Cancelar a taxa de inscrição
InviteDeliveredNoAccessCount
 value.InviteDeliveredNoAccessCount integer

InviteDeliveredNoAccessCount
EmptyCount
 value.EmptyCount integer

EmptyCount
EmptyPercentage
 value.EmptyPercentage integer

EmptyPercentage
AccessedCount
 value.AccessedCount integer

AccessedCount
RespondCount
 value.RespondedCount integer

RespondCount
InProgressCount
 value.InProgressCount integer

InProgressCount
CompletedCount
 value.CompletedCount integer

CompletedCount
ClosedCount
 value.ClosedCount integer

ClosedCount
InProgressPercentage
 value.InProgressPercentage float

InProgressPercentage
CompletedPercentage
 value.CompletedPercentage float

CompletedPercentage
ClosedPercentage
 value.ClosedPercentage float

ClosedPercentage
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
EmailSentCount
 value.EmailSentCount integer

EmailSentCount
LastCompletedDate
 value.LastCompletedDate string

LastCompletedDate
LastUpdatedDate
 value.LastUpdatedDate string

LastUpdatedDate
CompletedCountPerDayString
 value.CompletedCountPerDayString string

CompletedCountPerDayString
CompletedCountPerDay
 value.CompletedCountPerDay array of array

CompletedCountPerDay
items
 value.CompletedCountPerDay array of integer
CompletedCountPerMonthString
 value.CompletedCountPerMonthString string

CompletedCountPerMonthString
CompletedCountPerMonth
 value.CompletedCountPerMonth array of array

CompletedCountPerMonth
items
 value.CompletedCountPerMonth array of integer
sucesso
 success boolean

sucesso

Obter detalhes dos entrevistados da pesquisa no formato JSON ou CSV

ID da operação:
GetSurveyRespondentsDetails

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
Use a chave de acesso compartilhado para a pesquisa:
 X-SAKKey True string

Deve ser o mesmo que 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
internal_id
 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
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
pontuação
 respondentsTable.score integer

pontuação
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
 variableTable array of object

variableTable
element_id
 variableTable.element_id string

element_id
element_label
 variableTable.element_label string

element_label
descrição
 variableTable.description string

descrição
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
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
nome
 genericFieldHeaderTable.name string

nome
codificar
 genericFieldHeaderTable.code string

codificar
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
sucesso
 success boolean

sucesso

Obter o relatório datawarehouse da pesquisa no formato JSON ou CSV

ID da operação:
GetSurveyDataWarehouseReport

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
Use a chave de acesso compartilhado para a pesquisa:
 X-SAKKey True string

Deve ser o mesmo que 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
SubQuestion
 DatawarehouseRpt.SubQuestion string

SubQuestion
DatawarehouseRpt.Score float

Score
Date_Time
 DatawarehouseRpt.Date_Time string

Date_Time
Situação
 DatawarehouseRpt.Status string

Situação
InternalID
 DatawarehouseRpt.InternalID integer

InternalID
Linguagem
 DatawarehouseRpt.Language string

Linguagem
CreatedAt
 DatawarehouseRpt.CreatedAt string

CreatedAt
AtualizadoAt
 DatawarehouseRpt.UpdatedAt string

AtualizadoAt
WeightedScore
 DatawarehouseRpt.WeightedScore integer

WeightedScore
Endereço IP
 DatawarehouseRpt.IPAddress string

Endereço IP
InviteName
 DatawarehouseRpt.InviteName string

InviteName
Comment
 DatawarehouseRpt.Comment string

Comment
DatawarehouseRpt_csv
 DatawarehouseRpt_csv string

DatawarehouseRpt_csv
sucesso
 success boolean

sucesso

Obter pesquisas

ID da operação:
GetSurveys

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

ID da operação:
ResponseChanged

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
Use a chave de acesso compartilhado para a pesquisa:
 X-SAKKey True string

Deve ser o mesmo que a pesquisa selecionada
Nome
 Name True string

Nome

Quando uma resposta é enviada

ID da operação:
ResponseSubmitted

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
Use a chave de acesso compartilhado para a pesquisa:
 X-SAKKey True string

Deve ser o mesmo que a pesquisa selecionada
Nome
 Name True string

Nome