Pesquisas

A pesquisa é um questionário da equipe, com várias perguntas organizadas em seções, para quem tem acesso a um espaço da comunidade e/ou para qualquer pessoa com o link público. Serve para medir o NPS da comunidade, a satisfação com um evento ou um curso, o eNPS de uma empresa, ou o que mais a equipe quiser perguntar, sem Google Forms nem Typeform, com o resultado consolidado dentro da comunidade.

Pesquisas é um módulo de espaço, na aba Comunidade de Adicionar Espaço. Toda pesquisa mora num espaço de Pesquisas, e quem tem acesso ao espaço é o público dela.

#Pesquisa ou enquete

Para uma pergunta rápida no dia a dia, a enquete. Para um feedback estruturado, a pesquisa.

#Para que serve

#Como funciona

#O espaço: uma pesquisa ou várias

Ao criar o espaço, Como o espaço funciona pergunta:

Uma pesquisa só vale com no máximo uma pesquisa no espaço (rascunhos e encerradas contam): trocar para ele com duas ou mais é recusado, e uma segunda pesquisa também. O modo muda depois nas configurações do espaço.

O espaço nasce com a pesquisa. Em Uma pesquisa, Próximo leva a um terceiro passo, Pesquisa, na mesma janela: Comece por (um modelo ou Em branco), Título da pesquisa (obrigatório), Descrição, Modo (identificada ou anônima) e Tipo de resposta. Criar pesquisa cria o espaço e a pesquisa, em rascunho, e já abre o editor dela: "A pesquisa nasce como rascunho: ninguém recebe nada até você abrir." Se a pesquisa for recusada, o espaço fica criado, o passo continua com o que foi digitado e só a pesquisa é tentada de novo. Os espaços de uma chamada e de um curso funcionam igual: terminam abertos na chamada ou no curso.

Um exemplo: um espaço Pesquisa do evento, no modo Uma pesquisa, privado para quem comprou o ingresso; e um espaço Pesquisas, no modo Várias pesquisas, aberto aos membros, com o NPS do semestre e as pesquisas de cada curso.

#Quem faz o quê

#Os modelos

Nova pesquisa abre a escolha do modelo. As perguntas vêm prontas, no idioma da comunidade, e tudo se edita antes de abrir.

#Seções

Toda pesquisa tem pelo menos uma seção, com título e descrição opcional; cada pergunta pertence a uma seção. Para quem responde, as seções são etapas:

• O título e a introdução da pesquisa abrem a primeira tela, com o modo (anônima ou identificada), o número de etapas e de perguntas e o botão Começar.
• No alto, a barra com o título de cada etapa (Conteúdo · Infraestrutura · Experiência · Perfil). No celular, ela vira "Etapa 2 de 4 · Infraestrutura". Uma pesquisa de uma seção só não mostra a barra.
• Avançar só passa com as obrigatórias da etapa respondidas; Voltar mantém o que foi marcado; Enviar aparece na última etapa.
• A resposta é gravada uma vez só, no Enviar. Nada fica salvo no servidor pela metade: se a pessoa fechar a aba antes, começa de novo.

No resultado, as perguntas aparecem agrupadas por seção, na mesma ordem. Uma pesquisa tem até 20 seções e 100 perguntas.

#O editor

Montar a pesquisa é editar a própria tela de quem responde, com as cores da comunidade, como no editor de campanhas:

• Clique para escrever no lugar: título, introdução, título e descrição da seção, enunciado, ajuda e alternativas.
• As seções aparecem como as etapas, em abas no alto do canvas; Seção cria uma nova. Excluir seção apaga as perguntas dela junto, depois de confirmar.
• O + entre as perguntas insere uma pergunta (um dos 5 tipos) ou uma seção nova.
• Arraste pela alça para reordenar as perguntas dentro da seção; arraste uma pergunta até a aba de outra etapa para movê-la para lá; arraste as abas para reordenar as seções. Mover para seção, Subir e Descer, no painel, fazem o mesmo sem arrastar.
• O painel da pergunta selecionada tem Tipo, Obrigatória, as opções da escala, Duplicar (copia as alternativas junto, útil quando a mesma escala se repete) e Excluir.
• Computador e Celular mudam a largura; Prévia percorre as etapas como quem responde, com Enviar (prévia), sem gravar nada.

No alto ficam Público e link, Modo, Tipo de resposta, Período, Prévia, Salvar rascunho e Abrir (ou Agendar, com um início no futuro). Numa agendada, Cancelar agendamento no lugar de Abrir; numa aberta, Encerrar. Ao lado do título aparece Alterações não salvas ou Tudo salvo.

A barra do editor mostra só o título, o estado e a ação principal; as configurações viram resumos clicáveis, e Pausar, Encerrar e Excluir ficam em Mais ações. O aviso do modo fica acima da introdução, e uma pesquisa identificada cuja introdução fala em anonimato mostra "A introdução fala em anonimato, mas a pesquisa é identificada.", com Corrigir texto. Os modelos mostram as primeiras perguntas antes de escolher.

#Os 5 tipos de pergunta

Qualquer pergunta pode ser Obrigatória. Não há lógica condicional (pular perguntas conforme a resposta), matriz nem envio de arquivo.

#Identificada ou anônima

O Modo se escolhe no rascunho e não muda depois de aberta. A introdução diz o modo antes da primeira pergunta.

Na anônima, a introdução diz exatamente: "Pesquisa anônima: a comunidade não consegue ligar a resposta a você." É essa a promessa: a comunidade (equipe, API, assistente, CSV) não tem como saber quem respondeu o quê. A resposta é guardada sem a pessoa e sem horário, separada do registro de que ela já respondeu, e as respostas nunca aparecem na ordem em que chegaram.

Os cuidados da anônima:

• Mínimo de 3 respostas. Antes disso, o resultado mostra "O resultado aparece com 3 respostas" e nenhum número nem texto.
• Publicação em blocos de 3. As respostas entram no resultado de 3 em 3, sempre 3 novas da mesma origem (membros ou visitantes). O número de respostas cresce de 3 em 3, e uma resposta sozinha nunca muda o resultado: comparar duas leituras não revela o que uma pessoa respondeu.
• Filtro só por origem. Na anônima, o resultado se filtra apenas por membros ou visitantes; grupo, tag e empresa ficam só para a identificada. O recorte aparece quando ele e o resto têm pelo menos 3 respostas cada. Sem a regra do resto, um recorte de 3 numa pesquisa de 4 entregaria a quarta pessoa pela diferença.
• Textos embaralhados e sem data.
• CSV sem pessoa, sem segmento, sem origem e sem data, só a partir de 3 respostas e só com as respostas já publicadas nos blocos de 3.

Numa pesquisa identificada, a resposta é dado pessoal da comunidade, que é a controladora. Não pergunte sobre saúde, religião, opinião política ou outro dado sensível numa pesquisa identificada; se precisar, use a anônima.

#Público e link

O público é quem tem acesso ao espaço: a visibilidade dele e, num espaço privado, os grupos, produtos e planos de Quem tem acesso. A pesquisa precisa de alguém com acesso ao espaço, do link público ligado, ou dos dois.

• Público: Público e link mostra quantas pessoas têm acesso ao espaço hoje (até 50.000), com alguns nomes. Para mudar quem responde, mude o acesso do espaço. O público é congelado quando a pesquisa abre: quem ganhar acesso ao espaço depois não entra nela.

• Convite por e-mail: ao abrir, com a caixa Avisar por e-mail marcada (o padrão), cada pessoa do público recebe um e-mail de convite, 10 minutos depois, com o botão Responder, se deixou a categoria Pesquisas ligada em E-mails desta comunidade. Editar a pesquisa depois não reenvia. O botão leva ao mesmo endereço para todos, então o e-mail não liga ninguém a uma resposta anônima.

• Link para os membros: o endereço do convite. Quem tem acesso ao espaço responde por ele, com login, ou direto no espaço. Quem abre logado e não tem acesso vê "Esta pesquisa não é para você" (a não ser que o link público esteja ligado).

  O link do convite abre a pesquisa dentro do espaço dela, com o menu da comunidade. Quem responde cai no formulário (ou em Respondida e Encerrada, conforme o caso); o proprietário e o administrador caem no editor, se a pesquisa é rascunho ou agendada, ou no resultado, se está aberta ou encerrada. Se nenhum espaço do menu da pessoa tem a pesquisa, a tela de resposta avulsa explica por quê. Num espaço de Várias pesquisas, o endereço do navegador acompanha a pesquisa aberta: dá para copiar, mandar para alguém da equipe e recarregar a página sem voltar para a lista.

• Espaço: no rascunho, a pesquisa pode ir para outro espaço de Pesquisas.

• Link público: qualquer pessoa com o link responde sem login, no domínio da própria comunidade (o personalizado, se houver, ou o endereço dela em memberfy.net, como clube.memberfy.net/s/…), com a marca da comunidade, mesmo que a comunidade seja privada (a página mostra só a pesquisa). Copiar copia o endereço; desligar faz o link dizer "Este link não está disponível". O endereço é longo e aleatório: não dá para adivinhar o de outra pesquisa.

Quem já respondeu. Pelo link público, a resposta repetida é barrada por esforço, não com garantia:

• Quem abre o link sem entrar recebe um marcador neste navegador (a tela avisa: "Guardamos um marcador neste navegador só para evitar resposta repetida"). No mesmo navegador, a segunda tentativa vê "Você já respondeu neste navegador. Obrigado!". Uma janela anônima, outro navegador, outro aparelho ou os dados do navegador apagados respondem de novo. Se a pesquisa precisa de uma resposta por pessoa de verdade, use o público da comunidade, sem o link público.
• Quem abre logado e é membro da comunidade da pesquisa responde como membro, uma vez só de verdade, em qualquer navegador: a segunda tentativa vê "Você já respondeu". A resposta segue o modo da pesquisa. Logado em outra comunidade, conta como visitante.

Contra robôs e abuso, o link público tem:

• uma verificação contra robôs feita pelo próprio navegador, em cerca de um segundo, sem clicar em nada e sem enviar dados a terceiros (se ela falhar, a tela pede para enviar de novo);
• um limite de 300 envios a cada 10 minutos por rede, por pesquisa (acima, "Muitos envios desta rede. Espere alguns minutos e tente de novo.");
• um teto de 5.000 respostas de visitantes por pesquisa; as respostas de membros não contam no teto;
• e a equipe pode desligar o link a qualquer momento.

O endereço de rede de quem responde não é guardado com a pesquisa.

#Período e agendamento

Período define o Início e o Fim da coleta, no fuso da comunidade: "Fora desse período ninguém responde." O fim precisa ser depois do início.

• Sem Início (Ao abrir), a pesquisa começa quando a equipe clicar em Abrir.
• Com um Início no futuro, o botão vira Agendar. A confirmação diz quando ela abre e a partir de quando sai o convite por e-mail: "A pesquisa abre sozinha em … e o convite por e-mail sai a partir de …. Nada é enviado antes disso." Na hora marcada, a pesquisa abre sozinha, exatamente como se a equipe tivesse clicado em Abrir: o público é congelado nesse momento e o convite sai 10 minutos depois (se Avisar por e-mail ficou marcado ao agendar).
• Agendada, ela continua editável como um rascunho, inteira (perguntas, modo, tipo de resposta, período). Cancelar agendamento (ou remover o Início) a devolve a rascunho: "Agendamento cancelado: a pesquisa voltou a rascunho."
• Com Fim, ela encerra sozinha na data e hora escolhidas. Sem Fim, fica aberta até alguém da equipe Encerrar.

Fora do período, ninguém responde, por nenhum caminho (no espaço, pelo link do convite ou pelo link público). Antes do início, a tela diz "Esta pesquisa ainda não começou" e quando ela abre; depois do fim, ou encerrada, o link público mostra "Pesquisa encerrada". Uma pesquisa encerrada não reabre; as respostas e o resultado continuam disponíveis.

#Tipo de resposta

Tipo de resposta diz o quanto a comunidade conta com a resposta. Escolhe-se no rascunho (ou no passo Pesquisa do espaço de uma pesquisa) e trava ao abrir.

O tipo vale para quem entrou no público ao abrir; quem ganhou acesso ao espaço depois vê a pesquisa como opcional. Na identificada, obrigatória e imediata mostram no resultado quem falta responder (ver O resultado).

Depois de aberta, a estrutura trava: só mudam o título, a introdução, o Fim do período e o link público (ligar ou desligar), com Salvar alterações. O Início, o Modo e o Tipo de resposta não mudam mais.

Excluir o espaço exclui as pesquisas dele e desliga os links públicos.

#Quem sai da comunidade

Quando um membro sai da comunidade (por conta própria, removido pela equipe, pelo assistente, no fim do vínculo com a empresa ou ao recusar um convite de importação), as respostas identificadas dele são apagadas de verdade, e o resultado recalcula. As respostas anônimas ficam, porque não há como saber de quem são. É a única exceção à regra de a Memberfy guardar os dados da comunidade.

#Passo a passo

#Criar o espaço

Papel: proprietário ou administrador.

1. No menu, embaixo da seção, clique em Adicionar Espaço.
2. Na aba Comunidade, escolha Pesquisas e clique em Próximo.
3. Escreva o título, escolha a Visibilidade (e, se for Privada, Quem tem acesso): é quem vai responder.
4. Em Como o espaço funciona, escolha Várias pesquisas ou Uma pesquisa. Com Várias pesquisas, crie o espaço.
5. Com Uma pesquisa, Próximo leva ao passo Pesquisa: escolha o modelo (ou Em branco), o título, a descrição, o Modo e o Tipo de resposta, e clique em Criar pesquisa. O espaço e a pesquisa nascem juntos e o editor abre; siga de Criar e abrir a pesquisa, passo 3.

Ver Criar e organizar espaços.

#Criar e abrir a pesquisa

1. No espaço, clique em Nova pesquisa (no modo Uma pesquisa, Criar pesquisa).
2. Escolha um modelo, ou Em branco.
3. Ajuste o título, a introdução, as seções e as perguntas direto no canvas. Confira em Prévia.
4. Em Modo, escolha Identificada ou Anônima. Em Tipo de resposta, Pesquisa opcional, Pesquisa obrigatória ou Resposta imediata.
5. Em Público e link, confira quantas pessoas têm acesso ao espaço e, se quiser, ligue o Link público. Em Período, o Início (vazio para começar ao abrir) e o Fim, se houver.
6. Salvar rascunho. Até abrir, ninguém vê a pesquisa, nem pelo link.
7. Abrir e confirme: a janela diz para quantas pessoas vai o convite por e-mail. O público é congelado e a pesquisa passa a aceitar respostas. Com um Início no futuro, o botão é Agendar: a pesquisa fica Agendada e abre sozinha na hora marcada.
8. Se o link público estiver ligado, divulgue o endereço, copiado em Público e link.

#Responder (membro)

Quem tem acesso ao espaço responde de dois jeitos: abrindo o espaço no menu (no modo Várias pesquisas, clicando em Responder) ou pelo botão Responder do convite por e-mail. Uma pesquisa já respondida aparece como Respondida; uma obrigatória, como Obrigatória. Uma pesquisa agendada não aparece para quem responde até abrir; quem chega antes pelo link vê "Esta pesquisa ainda não começou".

O aviso no app. Só nas pesquisas obrigatórias e de resposta imediata: ao entrar na comunidade, quem está no público e ainda não respondeu vê um aviso só, "Uma pesquisa espera a sua resposta" (ou "N pesquisas esperam a sua resposta"), com cada pesquisa, o prazo (Fecha em…) e se é Anônima. Clicar numa pesquisa abre a resposta. Na obrigatória, Agora não fecha o aviso dessas pesquisas, e ele não volta para elas. Na de resposta imediata, não há Agora não: o aviso volta a cada tela até a pessoa responder ou a pesquisa encerrar. Responder remove a pesquisa do aviso. A pesquisa opcional não abre aviso: chega pelo convite por e-mail e pela lista do espaço.

#Ver o resultado

No espaço, clique numa pesquisa aberta ou encerrada (um rascunho abre o editor); no modo Uma pesquisa, o resultado aparece direto depois de aberta. A lista mostra, em cada uma, destinatários, respostas e o prazo.

#O resultado

O cabeçalho. O título da pesquisa, o estado (Aberta, Encerrada…), se é Identificada ou Anônima e o prazo, com Editar e Exportar CSV. Na anônima, o (i) ao lado de Anônima explica as regras de anonimato (os blocos e o filtro só por origem). No celular, os botões ficam só com o ícone.

As seções, em abas. Logo abaixo, as abas Resumo, Respostas individuais (só na identificada), Rodadas (só na recorrente) e Mapa de calor (só na identificada). Na mesma linha ficam os filtros: Origem (Todas, membros ou visitantes) e Recorte (um grupo, uma tag ou uma empresa; Todos os recortes volta ao todo). No celular, os filtros ficam em Filtros. Uma pesquisa sem outras abas mostra a origem como botões.

Os cartões do topo. Só os que têm algo a dizer, divididos por igual na linha:

Respostas por dia. Um gráfico com quantas respostas chegaram em cada dia, no fuso da comunidade, seguindo o filtro. Na anônima, a pesquisa não guarda a hora de nenhuma resposta: o gráfico se chama Respostas publicadas por dia e conta os blocos que entraram no resultado em cada dia, nunca quando alguém respondeu. As respostas publicadas antes desse registro aparecem numa nota abaixo ("N respostas publicadas antes do registro diário não aparecem no gráfico."). O gráfico só aparece com pelo menos dois dias e alguma resposta. Numa pesquisa anônima filtrada por Origem ou Recorte, quando parte das respostas foi publicada antes do registro diário, o gráfico não aparece, e no lugar fica "O gráfico por dia não aparece para este recorte."

Um cartão por pergunta, agrupados por seção (o nome da seção aparece quando há mais de uma), em duas colunas na tela larga. Cada cartão diz o tipo e quantas pessoas responderam:

• Escolha única e múltipla escolha: barras com o percentual e a contagem; a opção mais escolhida fica em destaque.
• NPS: a nota (de −100 a 100: % de promotores menos % de detratores), as três faixas e o histograma de 0 a 10 com a Média. Promotores são as notas 9 e 10, neutros 7 e 8, detratores de 0 a 6.
• Escala: a Média e o histograma das notas.
• Texto: as respostas em lista (até 1.000 por pergunta). Com mais de 4, aparecem as 4 primeiras, a busca Buscar nas respostas e Ver todas (N).
• Uma pergunta que ninguém respondeu diz "Ninguém respondeu esta pergunta ainda."

Estados vazios. Sem nenhuma resposta: "Ainda não há respostas", com "O resultado aparece aqui assim que as primeiras respostas chegarem." (ou "A pesquisa foi encerrada sem respostas."). Com um filtro sem nada: "Nenhuma resposta neste recorte." Na anônima com menos de 3 respostas publicadas: "O resultado aparece com 3 respostas", sem nenhum número, e a explicação: depois disso, o resultado cresce em blocos de 3 respostas, publicados de hora em hora, para ninguém descobrir quem acabou de responder.

Nas outras abas:

• Respostas individuais: só na identificada, com o nome do membro (ou Visitante) e a data, da mais recente para a mais antiga.
• Faltam responder: só na identificada com Pesquisa obrigatória ou Resposta imediata, acima do resumo: os nomes de quem está no público e ainda não respondeu, com a contagem ("Mostrando N de M." quando a lista é longa), ou "Todo mundo do público já respondeu." Na anônima, o resultado não mostra nada sobre quem ou quantos faltam, em nenhum tipo de resposta: comparar a contagem antes e depois de uma resposta revelaria quem respondeu.
• Filtro: um por vez. Na anônima, só Origem, com o mínimo de 3 e a regra do complemento.
• Exportar CSV: uma linha por resposta e uma coluna por pergunta, com a seção no cabeçalho. Na identificada, começa com nome, e-mail, origem e data da resposta; na anônima, só as respostas já publicadas, embaralhadas, e só a partir de 3. O Mapa de calor e as Rodadas têm a exportação deles.

#Pesquisa recorrente e mapa de calor

#Repetir a pesquisa

Para medir o clima ou o eNPS de tempos em tempos sem recriar a pesquisa, ligue Repetir em Período da pesquisa (botão Período), com a pesquisa em rascunho:

Salvar e ligar a repetição. A pesquisa ganha a etiqueta Recorrente e o resumo mostra Repetição ativa, a agenda ("Todo dia 1, 09:00 · 7 dias aberta") e a Próxima rodada. Ela não tem Abrir: só abre por rodadas.

• Cada rodada é uma cópia da pesquisa que abre sozinha no dia e na hora, com o público de agora (quem tem acesso ao espaço nesse momento), manda o convite e fecha ao fim da duração. O modo (identificada ou anônima) e as regras de publicação do resultado valem em cada rodada.
• Cada pessoa responde uma vez por rodada; a resposta de uma rodada não conta para outra.
• Mudar as perguntas vale só para as próximas rodadas. A pesquisa recorrente continua editável; a rodada aberta segue com as perguntas com que abriu.
• Pausar repetição para de abrir rodadas novas, sem fechar a rodada aberta; Retomar repetição volta a agenda. Encerrar repetição pede confirmação e não tem volta: nenhuma rodada nova abre, as que já aconteceram continuam no resultado e a aberta segue até fechar.
• No espaço de Uma pesquisa, quem responde cai na rodada aberta mais recente. Excluir a pesquisa recorrente exclui as rodadas dela.

#Rodadas e evolução

No resultado de uma pesquisa recorrente, a aba Rodadas abre primeiro:

• um gráfico de linha por pergunta de NPS ou de escala, com a Evolução por rodada;
• a tabela das rodadas, com Abertura, Respostas, Taxa e o valor de cada pergunta, e Ver resultado para abrir o resultado daquela rodada.

O seletor Rodada, no topo, troca a rodada do resumo, das respostas e do mapa. Na anônima, a rodada com menos de 3 respostas e a rodada ainda aberta aparecem sem número.

#Mapa de calor

Na pesquisa identificada (recorrente ou não), a aba Mapa de calor mostra onde a nota é melhor ou pior:

• Agrupar por: Grupo principal, Tag ou Empresa, uma de cada vez. Na tag e na empresa, quem tem mais de uma conta em cada linha;
• uma coluna por pergunta de NPS e de escala, a coluna Respostas e a linha do total;
• cada célula com o valor, a contagem de respostas e uma cor de cinco faixas, de Pior a Melhor. O mapa usa o grupo, a tag e a empresa da pessoa na hora em que ela respondeu, e conta só as respostas de membros;
• na recorrente, o mapa é o da rodada escolhida, com a Variação de cada célula contra a rodada anterior;
• Exportar mapa (CSV) baixa o que está na tela.

O mapa de calor agrupa por um controle compacto, chama as colunas de P1, P2… com as perguntas embaixo, explica a seta da variação ("+3 vs. rodada anterior") e tem uma exportação só. Também na pesquisa identificada, um grupo com menos de 3 respostas aparece como Poucas respostas, sem número.

Na pesquisa anônima, o mapa de calor não está disponível.

Rodadas e mapa são do proprietário e do administrador; o moderador e os membros não os veem.

#Exemplo: a pesquisa de satisfação de um evento

Um evento de tecnologia acabou e a organização quer ouvir quem foi, membro ou não:

1. Nova pesquisa › Feedback do evento, no espaço do evento. Título: Pesquisa de satisfação do evento. Introdução: "Obrigado por participar da 10ª edição! Leva menos de 2 minutos."
2. As quatro seções já vêm: Conteúdo, Infraestrutura, Experiência e Perfil. Na Conteúdo, a equipe acrescenta "Qualidade da trilha de APIs" com Duplicar numa pergunta pronta (a escala Excelente…Não se aplica vem junto) e cria uma escolha única com alternativas próprias: "A duração das palestras foi…" Curta demais, Na medida, Longa demais.
3. Modo: Anônima e Link público ligado (os dois vêm assim no modelo). A pesquisa mora num espaço Pesquisa do evento, no modo Uma pesquisa, privado para o produto do ingresso: quem comprou recebe o convite por e-mail ao abrir. Prazo: uma semana.
4. Abrir, copiar o link público e mandar no grupo do evento, para quem não tem conta.
5. Quem foi responde pelo celular, sem conta, em quatro etapas. Na terceira resposta, o resultado aparece, e daí em diante muda de 3 em 3; o filtro Origem separa membros e visitantes quando cada lado tem pelo menos 3.

#Pelo assistente (MCP)

O proprietário e o administrador fazem pelo assistente quase tudo o que fazem no espaço: criar o espaço de Pesquisas (com o modo), ver os modelos, criar a pesquisa no espaço com seções e perguntas, o período (starts_at, closes_at) e o tipo de resposta (response_mode), editar o rascunho ou a agendada (ou movê-la para outro espaço), conferir o alcance do público, abrir ou agendar (open_survey com um starts_at no futuro agenda; starts_at nulo cancela), ligar o link (a resposta traz o endereço público), ler o resultado com um filtro (com quem falta responder, só na identificada), listar as respostas individuais e exportar o CSV. Abrir e agendar (porque mandam o convite por e-mail), encerrar e excluir pedem a sua confirmação; o resto age na primeira chamada. A receita Fazer uma pesquisa monta, abre e resume o resultado com você.

Qualquer membro pergunta ao assistente quais pesquisas esperam a resposta dele (list_my_pending_surveys), com o link para responder no app e o tipo de resposta (response_mode) de cada uma.

A pesquisa recorrente também se faz pelo assistente, com recurrence em create_survey e update_survey, pausar, retomar e encerrar a repetição (encerrar pede confirmação), as rodadas, a evolução e o mapa de calor da identificada, com o CSV. Ver Ferramentas · Membros.

get_survey_results traz também activity, as respostas por dia: na anônima, a contagem é das respostas publicadas em cada dia, e o assistente nunca diz quando alguém respondeu.

Responder a uma pesquisa pelo assistente não existe: o registro do que o assistente faz em nome de alguém identificaria quem respondeu. Ver Ferramentas · Membros.

#Erros comuns e como resolver

#Na API

O espaço é module: "surveys", com moduleConfig.mode single ou multi na criação e na edição do espaço; GET e PUT /api/surveys/spaces/{spaceId} leem e trocam o modo (no single, o GET traz a pesquisa). As rotas da equipe ficam em /api/surveys (proprietário e administrador, com o X-CommunityId): modelos, lista (?spaceId=), criar (com spaceId, obrigatório), editar (no rascunho ou na agendada, a árvore inteira de seções e perguntas, e spaceId para mover), prévia do público (spaceId ou surveyId), abrir, encerrar, excluir, resultado com um filtro (groupId, tag, companyId ou origin; na anônima, só origin, e os outros voltam 422), respostas individuais e CSV. O membro lista as pesquisas que pode responder em GET /api/surveys?spaceId=, com alreadyResponded; as abertas que ainda esperam a resposta dele em GET /api/surveys/pending (com responseMode de cada uma, notice se o aviso no app deve aparecer e blocking se há uma de resposta imediata), e fecha o aviso de uma em POST /api/surveys/{id}/notice/dismiss. As duas rotas públicas, /api/public/surveys/{publicToken}, servem a pesquisa e recebem a resposta sem login. Antes de enviar, a página pública pede um desafio em /api/public/surveys/{publicToken}/challenge, que o navegador resolve e manda junto com a resposta.

Período e tipo de resposta. Criar e editar aceitam startsAt e closesAt (o fim depois do início) e responseMode (optional, o padrão, required ou immediate), no rascunho e na agendada. Abrir com startsAt no futuro agenda: o status fica scheduled (os status são draft, scheduled, open e closed) e a pesquisa abre sozinha no startsAt; startsAt: null cancela. No resultado, pending (count, members, truncated) só vem na identificada com required ou immediate; na anônima, o campo não existe.

Respostas por dia. GET /api/surveys/{id}/results traz activity (nulo quando locked), só contagens, no fuso da comunidade e seguindo o filtro: basis, timeZone, days ([{ date, count }]), lastAt, lastWeek (quantas nos últimos 7 dias) e untracked. Na identificada, basis é response e conta cada resposta no seu dia. Na anônima, basis é publication: a resposta anônima não guarda hora, então a contagem é dos blocos publicados a cada hora, no dia da publicação; untracked são as respostas publicadas antes desse registro.

#Relacionados

• Módulos
• Visibilidade e acesso
• Campanhas de e-mail
• Enquetes
• Grupos e organograma
• Tags
• Papéis e permissões
• Ferramentas · Membros