Automação SurveyMonkey

O que Automação SurveyMonkey faz?

Automatize fluxos de trabalho do SurveyMonkey — crie pesquisas, liste e busque pesquisas existentes, gerencie coletores e links de distribuição, recupere respostas e inspecione detalhes de pesquisas — tudo por meio de linguagem natural.

Documentação do toolkit: composio.dev/toolkits/survey_monkey

---

Configuração

1. Adicione o servidor MCP Rube ao seu ambiente: https://rube.app/mcp
2. Conecte sua conta do SurveyMonkey quando solicitado (fluxo OAuth via Composio)
3. Comece a emitir comandos em linguagem natural para automação do SurveyMonkey

---

Fluxos de Trabalho Principais

1. Criar uma Nova Pesquisa

Crie uma nova pesquisa vazia que pode ser configurada posteriormente com perguntas e páginas.

Ferramenta: SURVEY_MONKEY_CREATE_SURVEY

Parâmetros principais:

• title — título da pesquisa exibido aos respondentes (obrigatório)
• nickname — nome interno opcional para organizar pesquisas (não exibido aos respondentes)
• language — código de idioma ISO 639-1 (padrão en); exemplos: es, fr, de
• footer — se deve exibir o rodapé com a marca SurveyMonkey (padrão true)

A pesquisa criada começa com uma página vazia e nenhuma pergunta. Use o survey_id retornado com outras ações para adicionar conteúdo e configurar coletores.

Exemplo de prompt:

"Crie uma nova pesquisa intitulada 'Satisfação do Cliente Q1 2026'"

---

2. Listar e Pesquisar Pesquisas

Enumere todas as pesquisas da sua conta com opções de filtragem, ordenação e paginação.

Ferramenta: SURVEY_MONKEY_GET_SURVEYS

Parâmetros principais:

• title — pesquisar pelo título da pesquisa (correspondência parcial)
• sort_by — ordenar por title, date_modified ou num_responses
• sort_order — ASC ou DESC
• page / per_page — controles de paginação (padrão 50 por página, máximo 100)
• include — campos adicionais: response_count, date_modified, date_created, question_count, page_count, category, language, folder_id
• folder_id — filtrar para pesquisas em uma pasta específica
• start_modified_at / end_modified_at — filtro por intervalo de datas (formato: YYYY-MM-DDTHH:MM:SS)

Exemplo de prompt:

"Liste todas as minhas pesquisas ordenadas pela modificação mais recente, inclua contagens de respostas"

---

3. Obter Detalhes da Pesquisa

Recupere metadados abrangentes para uma pesquisa específica, incluindo configuração, contagens de perguntas/páginas, contagens de respostas e todas as URLs relevantes.

Ferramenta: SURVEY_MONKEY_GET_SURVEY_DETAILS

Parâmetros principais:

• survey_id — o identificador único da pesquisa (obrigatório)

Retorna: título, idioma, question_count, page_count, response_count, URLs para visualização/edição/análise/coleta, texto do botão e carimbos de data/hora.

Exemplo de prompt:

"Mostre-me os detalhes completos e a contagem de respostas da pesquisa 123456789"

---

4. Gerenciar Coletores e Links de Distribuição

Recupere coletores (canais de distribuição) de uma pesquisa para obter links compartilháveis e monitorar o progresso das respostas.

Ferramenta: SURVEY_MONKEY_GET_COLLECTORS

Parâmetros principais:

• survey_id — a pesquisa para obter coletores (obrigatório)
• include — campos adicionais: type, status, response_count, date_created, date_modified, url
• name — filtro de correspondência parcial no nome do coletor
• sort_by — ordenar por id, date_modified, type, status ou name
• sort_order — ASC ou DESC
• page / per_page — paginação (padrão 50, máximo 1000)
• start_date / end_date — filtrar por data de criação (formato: YYYY-MM-DDTHH:MM:SS)

Exemplo de prompt:

"Obtenha todos os coletores da pesquisa 123456789, inclua URLs e contagens de respostas"

---

5. Recuperar Respostas da Pesquisa

Obtenha dados de respostas para uma pesquisa específica com opções abrangentes de filtragem.

Ferramenta: SURVEY_MONKEY_GET_RESPONSES

Parâmetros principais:

• survey_id — a pesquisa para recuperar respostas (obrigatório)
• status — filtrar por completed, partial, overquota ou disqualified
• page / per_page — paginação (padrão 50, máximo 1000)
• sort_order — ASC ou DESC (ordenado por date_modified)
• start_created_at / end_created_at — filtrar por intervalo de data de criação (ISO 8601)
• start_modified_at / end_modified_at — filtrar por intervalo de data de modificação
• email — filtrar por e-mail do respondente
• first_name / last_name — filtrar por nome do respondente
• ip — filtrar por endereço IP
• total_time_min / total_time_max / total_time_units — filtrar por tempo de conclusão

Exemplo de prompt:

"Obtenha todas as respostas concluídas para a pesquisa 123456789 dos últimos 30 dias"

---

6. Fluxo de Trabalho Completo do Ciclo de Vida da Pesquisa

Combine ferramentas para gerenciamento de ponta a ponta de pesquisas:

1. Criar: SURVEY_MONKEY_CREATE_SURVEY — crie a pesquisa, armazene o survey_id
2. Distribuir: SURVEY_MONKEY_GET_COLLECTORS — recupere o link do coletor para compartilhar com os respondentes
3. Monitorar: SURVEY_MONKEY_GET_SURVEY_DETAILS — verifique contagens de respostas e status da pesquisa
4. Coletar: SURVEY_MONKEY_GET_RESPONSES — recupere respostas concluídas, filtrando por status=completed
5. Auditar: SURVEY_MONKEY_GET_SURVEYS — navegue e encontre pesquisas se o survey_id for perdido

Exemplo de prompt:

"Crie uma pesquisa chamada 'Feedback do Evento' e depois me mostre como distribuí-la"

---

Armadilhas Conhecidas

Armadilha	Detalhes
Paginação necessária	SURVEY_MONKEY_GET_COLLECTORS e SURVEY_MONKEY_GET_RESPONSES exigem gerenciamento de page/per_page para pesquisas grandes, a fim de evitar perda de dados
Filtragem por status é crítica	SURVEY_MONKEY_GET_RESPONSES retorna entradas parciais, acima da cota e desqualificadas, a menos que filtradas — use status=completed para dados confiáveis
Sem link compartilhável na criação	SURVEY_MONKEY_CREATE_SURVEY não cria um link de distribuição — use SURVEY_MONKEY_GET_COLLECTORS para obter URLs compartilháveis
Armazenamento do ID da pesquisa	Perder o survey_id força a dependência de SURVEY_MONKEY_GET_SURVEYS, que é mais lento — armazene IDs imediatamente após a criação
Mapeamento de IDs de perguntas	IDs de perguntas e formatos de respostas devem ser mapeados cuidadosamente; use SURVEY_MONKEY_GET_SURVEY_DETAILS para entender a estrutura
Formato de data	Filtros de data usam o formato YYYY-MM-DDTHH:MM:SS, não ISO 8601 com fuso horário
Pesquisa vazia na criação	Novas pesquisas começam com uma página vazia e sem perguntas — é necessária configuração adicional

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Principais
Criar pesquisa	SURVEY_MONKEY_CREATE_SURVEY	title, language, nickname
Listar pesquisas	SURVEY_MONKEY_GET_SURVEYS	title, sort_by, include, page
Obter detalhes da pesquisa	SURVEY_MONKEY_GET_SURVEY_DETAILS	survey_id
Listar coletores	SURVEY_MONKEY_GET_COLLECTORS	survey_id, include, sort_by
Obter respostas	SURVEY_MONKEY_GET_RESPONSES	survey_id, status, start_created_at

---

Desenvolvido por Composio