SurveyMonkey Spoke

Gerencie pesquisas, respostas, coletores e assim por diante na conta SurveyMonkey da sua instância ServiceNow.

Solicitar aplicativos na Store

Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.

Assinatura do IntegrationHub

Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Programações jurídicas - Visão geral do IntegrationHub.

Versão do spoke

SurveyMonkey spoke v2.0.5 é a versão mais recente.

Versões compatíveis

Este spoke foi criado para a SurveyMonkey versão da API v3, mas pode ser compatível com versões posteriores.

Requisitos do spoke

Acesso de administrador a SurveyMonkey Portal do desenvolvedor de API.

Dependências do spoke

Se você estiver tendo problemas para instalar o aplicativo, verifique se estes plug-ins dependentes estão instalados:

• ServiceNow Flow Designer - Entradas dinâmicas (com.glide.hub.dynamic_inputs)
• Etapa de ação do ServiceNow IntegrationHub — REST (com.glide.hub.action_step.rest)
• Objeto complexo (com.glide.cobject)
• Tempo de execução do ServiceNow IntegrationHub (com.glide.hub.integration.runtime)
• Modelo de ação do ServiceNow IntegrationHub — fluxo de dados (com.glide.hub.action_type.datastream)

Nota:

Alguns desses plug-ins são recursos licenciáveis e exigem licenças apropriadas, se usados fora da implementação do spoke.

Ações do spoke

O spoke SurveyMonkey fornece ações para automatizar tarefas SurveyMonkey quando ocorrem eventos em sua instância ServiceNow. As ações disponíveis incluem:

Categoria	Ação	Descrição
Gestão de coletores	Criar coletor	Cria um coletor para a pesquisa fornecida. Os usuários do app público precisam de acesso ao escopo Criar/Modificar Coletores.
	Excluir coletor	Exclui o coletor especificado. Os usuários do app público precisam de acesso ao escopo Criar/Modificar Coletores.
	Obter detalhes do coletor	Recupera detalhes do coletor especificado. Os usuários do app público precisam de acesso ao escopo Exibir Coletores.
	Pesquisar fluxo de coletores	Recupera detalhes dos coletores na pesquisa especificada.
Gestão de contatos	Adicionar Contatos à Lista de Contatos	Cria vários contatos em uma lista de contatos. Os usuários do aplicativo público precisam de acesso ao escopo Criar/Modificar contatos.
	Criar Lista de Contatos	Cria uma lista de contatos. Os usuários do aplicativo público precisam de acesso ao escopo Criar/Modificar contatos.
	Excluir lista de contatos	Exclui a lista de contatos especificada. Os usuários do aplicativo público precisam de acesso ao escopo Criar/Modificar contatos.
	Pesquisar listas de contatos	Recupera todas as listas de contatos. Os usuários do aplicativo público precisam de acesso ao escopo Exibir contatos.
	Pesquisar contatos na lista de contatos	Recupera todos os contatos em uma lista de contatos. Os usuários do aplicativo público precisam de acesso ao escopo Exibir contatos.
	Atualizar lista de contatos	Modifica uma lista de contatos. Os usuários do aplicativo público precisam de acesso ao escopo Criar/Modificar contatos.
Gestão de pastas	Criar pasta	Cria uma pasta.
	Pesquisar pastas	Recupera as pastas disponíveis.
Gestão de respostas	Pesquisar respostas da pesquisa	Recupera uma lista de respostas. Os usuários do app público precisam de acesso ao escopo Exibir respostas.
	Pesquisar tendências de pesquisa	Recupera as contagens de respostas no período especificado. Os usuários do app público precisam de acesso ao escopo Exibir detalhes da resposta.
Survey and Question Management	Criar pergunta	Cria uma pergunta na página de pesquisa. Os usuários do aplicativo público precisam de acesso ao escopo Criar/Modificar pesquisas.
	Criar Pesquisa	Cria uma pesquisa vazia. Os usuários do aplicativo público precisam de acesso ao escopo Criar/Modificar pesquisas.
	Excluir Pergunta	Exclui a pergunta especificada. Os usuários do aplicativo público precisam de acesso ao escopo Criar/Modificar pesquisas.
	Excluir pesquisa	Exclui a pesquisa especificada. Os usuários do aplicativo público precisam de acesso ao escopo Criar/Modificar pesquisas.
	Obter detalhes da pesquisa	Recupera uma lista de respostas completas, incluindo respostas para todas as perguntas. Os usuários do app público precisam de acesso ao escopo Exibir detalhes da resposta.
	Pesquisar perguntas	Recupera todas as perguntas na pesquisa especificada.
	Pesquisar páginas de pesquisa	Recupera detalhes da página. Os usuários do aplicativo público precisam de acesso ao escopo Exibir pesquisas.
	Pesquisar pesquisas	Recupera uma lista de pesquisas pertencentes ou compartilhadas com o usuário autenticado. Os usuários do aplicativo público precisam de acesso ao escopo Exibir pesquisas.
	Atualizar pergunta	Atualiza os detalhes da pergunta especificada. Os usuários do app público precisam de acesso ao escopo Criar/Modificar pesquisas
	Atualizar Pesquisa	Modifica o título, apelido ou idioma da pesquisa especificada. Os usuários do aplicativo público precisam de acesso ao escopo Criar/Modificar pesquisas.
Gestão de equipe	Pesquisar fluxo de atividades da equipe	Recupera dados de atividade para a equipe especificada.
	Pesquisar detalhes de membro da equipe	Recupera detalhes do membro da equipe especificado.
	Pesquisar fluxo de membros da equipe	Recupera detalhes de todos os membros da equipe especificada.
	Pesquisar fluxo de equipes	Recupera detalhes de todas as equipes às quais a conta do usuário autenticado pertence.
Gestão de usuários	Obter detalhes do usuário	Recupera os detalhes da conta do usuário atual, incluindo o plano. Os usuários do app público precisam de acesso ao escopo Exibir Usuários.

Nota:

Este spoke tem uma ação Pesquisar usuário e apenas Gestão de ativos de software ações relacionadas.

Requisitos de aliases de conexão e credencial

IntegrationHub usa aliases para gerenciar informações de conexão e credenciais. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Se as informações de conexão ou de credencial forem alteradas, não será necessário atualizar nenhuma ação que use a conexão. Para obter mais informações, consulte Connections and Credentials.

Para obter informações sobre como configurar o spoke, consulte Configurar o spoke SurveyMonkey.

Configurar o spoke SurveyMonkey

Integre a instância [ ServiceNow e a conta SurveyMonkey criando uma aplicação OAuth personalizada no SurveyMonkey Portal do Desenvolvedor de API para autenticar ServiceNow solicitações.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Fazer login em SurveyMonkey Portal do desenvolvedor de API como administrador e adicione um app.
   1. Em URL de redirecionamento do OAuth, insira a URL da instância ServiceNow neste formato: https://<instance-name> .service-now.com/oauth_redirect.do .
   2. Copie e registre os valores de ID e segredo do cliente.
   3. Forneça estes escopos para a aplicação:
      • Criar/Modificar pesquisas
      • Criar/Modificar coletores
      • Criar/Modificar respostas
      • Exibir detalhes da resposta
      • Exibir Contatos
      • Criar/Modificar webhooks
      • Exibir ativos da biblioteca
      • Exibir Pesquisas
      • Exibir Coletores
      • Exibir Respostas
      • Criar/Modificar contatos
      • Exibir Usuários
      • Exibir webhook

      Nota:

      Se você fornecer escopos adicionais, certifique-se de adicioná-los na guia Escopos de entidade OAuth do registro da aplicação padrão disponível na instância ServiceNow.
2. Configure o registro da aplicação padrão.
   1. Navegar até OAuth de Sistema > Registro de aplicações.
   2. Abra o registro, SurveyMonkey.
   3. No formulário, preencha estes valores:

      Campo	Descrição
      ID de cliente	ID de cliente da aplicação criada em SurveyMonkey Portal do desenvolvedor de API.
      Segredo do cliente	Segredo da aplicação criado em SurveyMonkey Portal do desenvolvedor de API.
      URL de redirecionamento	ServiceNow URL da instância neste formato: https://<instance-name> .service-now.com/oauth_redirect.do . Substituir<instance-name> pelo nome da sua instância.

      Nota:

      Se você tiver fornecido escopos adicionais, crie registros para esses escopos na guia Escopos de entidade OAuth.
3. Crie um registro de credencial.
   1. Navegar até Conexões e Credenciais > Credenciais.
   2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de credenciais você deseja criar?.
   3. Selecione Credenciais OAuth 2.0.
   4. No formulário, preencha os campos.

      Campo	Valor necessário
      Nome	Nome para identificar exclusivamente o registro. Insira as credenciais do SurveyMonkey.
      Ativo	Opção de usar ativamente o registro de credencial.
      Perfil de Entidade OAuth	Perfil OAuth que você criou ao registrar o app SurveyMonkey como um provedor OAuth. Selecione SurveyMonkey default_profile.
      Aplica-se a	MID Servers que podem usar esta credencial. Selecione Todos os MID Servers.
      Ordem	A ordem na qual aplicar esta credencial. Insira 100.

   5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
4. Crie um registro de conexão.
   1. Navegar até Conexões e Credenciais > Aliases de conexão e credencial.
   2. Aberto para o registro da SurveyMonkey.
   3. Na guia Conexões, clique em Novo.
      O sistema exibe um formulário de conexão HTTP(s) em branco.
   4. No formulário, preencha estes valores.

      Campo	Valor necessário
      Nome	Nome para identificar o registro da conexão com exclusividade. InsiraConexão SurveyMonkey.
      Credencial	Registro de credencial que você criou para o Zoom. Selecione SurveyMonkey Credenciais.
      Alias de conexão	Registro de alias associado a esta conexão.
      URL de conexão	URL base para conectar à sua conta SurveyMonkey. Insira https://api.surveymonkey.net.
      Ativo	Opção para usar ativamente a conexão.
      Domínio	Domínio no qual a ação ou atividade é executada.

   5. Opcional: Na guia Atributos, forneça sua SurveyMonkey versão da API se ela for diferente do valor padrão de v3.
   6. Clique em Enviar.
   A instância [ ServiceNow e a conta SurveyMonkey estão integradas.