ComposioHQ/SurveyMonkey-Automation

SurveyMonkey-Automatisierung

Automatisiere SurveyMonkey-Umfrage-Workflows – erstelle Umfragen, liste und durchsuche vorhandene Umfragen, verwalte Collector und Verteilerlinks, rufe Antworten ab und prüfe Umfragedetails – alles über natürliche Sprache.

Toolkit-Dokumentation: composio.dev/toolkits/survey_monkey

---

Einrichtung

1. Füge den Rube MCP-Server zu deiner Umgebung hinzu: https://rube.app/mcp
2. Verbinde dein SurveyMonkey-Konto, wenn du dazu aufgefordert wirst (OAuth-Ablauf über Composio)
3. Beginne mit der Eingabe natürlicher Sprachbefehle für die SurveyMonkey-Automatisierung

---

Kern-Workflows

1. Eine neue Umfrage erstellen

Erstelle eine neue leere Umfrage, die später mit Fragen und Seiten weiter konfiguriert werden kann.

Tool: SURVEY_MONKEY_CREATE_SURVEY

Wichtige Parameter:

• title – der Umfragetitel, der den Befragten angezeigt wird (erforderlich)
• nickname – optionaler interner Name zur Organisation von Umfragen (wird Befragten nicht angezeigt)
• language – ISO 639-1 Sprachcode (Standard en); Beispiele: es, fr, de
• footer – ob das SurveyMonkey-Branding-Footer angezeigt werden soll (Standard true)

Die erstellte Umfrage beginnt mit einer leeren Seite und keinen Fragen. Verwende die zurückgegebene survey_id mit anderen Aktionen, um Inhalte hinzuzufügen und Collector zu konfigurieren.

Beispielaufforderung:

"Erstelle eine neue Umfrage mit dem Titel 'Kundenzufriedenheit Q1 2026'"

---

2. Umfragen auflisten und durchsuchen

Liste alle Umfragen in deinem Konto mit Filter-, Sortier- und Paginierungsoptionen auf.

Tool: SURVEY_MONKEY_GET_SURVEYS

Wichtige Parameter:

• title – Suche nach Umfragetitel (partielle Übereinstimmung)
• sort_by – Sortierung nach title, date_modified oder num_responses
• sort_order – ASC oder DESC
• page / per_page – Paginierungssteuerung (Standard 50 pro Seite, max. 100)
• include – zusätzliche Felder: response_count, date_modified, date_created, question_count, page_count, category, language, folder_id
• folder_id – Filter auf Umfragen in einem bestimmten Ordner
• start_modified_at / end_modified_at – Datumsbereichsfilter (Format: YYYY-MM-DDTHH:MM:SS)

Beispielaufforderung:

"Liste alle meine Umfragen, sortiert nach der letzten Änderung, inklusive Antwortanzahl"

---

3. Umfragedetails abrufen

Rufe umfassende Metadaten für eine bestimmte Umfrage ab, einschließlich Konfiguration, Frage-/Seitenanzahl, Antwortanzahl und aller relevanten URLs.

Tool: SURVEY_MONKEY_GET_SURVEY_DETAILS

Wichtige Parameter:

• survey_id – die eindeutige Umfrage-ID (erforderlich)

Rückgabe: Titel, Sprache, Frageanzahl, Seitenanzahl, Antwortanzahl, URLs für Vorschau/Bearbeiten/Analyse/Sammeln, Schaltflächentext und Zeitstempel.

Beispielaufforderung:

"Zeige mir die vollständigen Details und die Antwortanzahl für Umfrage 123456789"

---

4. Collector und Verteilerlinks verwalten

Rufe Collector (Verteilerkanäle) für eine Umfrage ab, um teilbare Links zu erhalten und den Antwortfortschritt zu überwachen.

Tool: SURVEY_MONKEY_GET_COLLECTORS

Wichtige Parameter:

• survey_id – die Umfrage, für die Collector abgerufen werden sollen (erforderlich)
• include – zusätzliche Felder: type, status, response_count, date_created, date_modified, url
• name – partielle Übereinstimmung des Collectornamens
• sort_by – Sortierung nach id, date_modified, type, status oder name
• sort_order – ASC oder DESC
• page / per_page – Paginierung (Standard 50, max. 1000)
• start_date / end_date – Filter nach Erstellungsdatum (Format: YYYY-MM-DDTHH:MM:SS)

Beispielaufforderung:

"Hole alle Collector für Umfrage 123456789, inklusive URLs und Antwortanzahlen"

---

5. Umfrageantworten abrufen

Rufe Antwortdaten für eine bestimmte Umfrage mit umfangreichen Filteroptionen ab.

Tool: SURVEY_MONKEY_GET_RESPONSES

Wichtige Parameter:

• survey_id – die Umfrage, deren Antworten abgerufen werden sollen (erforderlich)
• status – Filter nach completed, partial, overquota oder disqualified
• page / per_page – Paginierung (Standard 50, max. 1000)
• sort_order – ASC oder DESC (sortiert nach date_modified)
• start_created_at / end_created_at – Filter nach Erstellungsdatumsbereich (ISO 8601)
• start_modified_at / end_modified_at – Filter nach Änderungsdatumsbereich
• email – Filter nach E-Mail-Adresse des Befragten
• first_name / last_name – Filter nach Name des Befragten
• ip – Filter nach IP-Adresse
• total_time_min / total_time_max / total_time_units – Filter nach Bearbeitungszeit

Beispielaufforderung:

"Hole alle abgeschlossenen Antworten für Umfrage 123456789 aus den letzten 30 Tagen"

---

6. Vollständiger Umfragelebenszyklus-Workflow

Kombiniere Tools für eine durchgängige Umfrageverwaltung:

1. Erstellen: SURVEY_MONKEY_CREATE_SURVEY – Umfrage erstellen, survey_id speichern
2. Verteilen: SURVEY_MONKEY_GET_COLLECTORS – den Collector-Link abrufen, um ihn mit Befragten zu teilen
3. Überwachen: SURVEY_MONKEY_GET_SURVEY_DETAILS – Antwortanzahl und Umfragestatus prüfen
4. Sammeln: SURVEY_MONKEY_GET_RESPONSES – abgeschlossene Antworten abrufen, filtern mit status=completed
5. Auditieren: SURVEY_MONKEY_GET_SURVEYS – Durchsuchen und Finden von Umfragen, falls die survey_id verloren gegangen ist

Beispielaufforderung:

"Erstelle eine Umfrage namens 'Event-Feedback', zeige mir dann, wie ich sie verteilen kann"

---

Bekannte Fallstricke

Fallstrick	Details
Paginierung erforderlich	SURVEY_MONKEY_GET_COLLECTORS und SURVEY_MONKEY_GET_RESPONSES erfordern die Verwaltung von page/per_page bei großen Umfragen, um Datenverlust zu vermeiden
Statusfilterung entscheidend	SURVEY_MONKEY_GET_RESPONSES gibt auch teilweise, überquotierte und disqualifizierte Einträge zurück, sofern nicht gefiltert – verwende status=completed für zuverlässige Daten
Kein teilbarer Link bei Erstellung	SURVEY_MONKEY_CREATE_SURVEY erstellt keinen Verteilerlink – verwende SURVEY_MONKEY_GET_COLLECTORS, um teilbare URLs zu erhalten
Umfrage-ID speichern	Das Verlieren der survey_id erzwingt die Nutzung von SURVEY_MONKEY_GET_SURVEYS, was langsamer ist – speichere IDs sofort nach der Erstellung
Frage-ID-Zuordnung	Frage-IDs und Antwortformate aus den Antworten müssen sorgfältig zugeordnet werden; verwende SURVEY_MONKEY_GET_SURVEY_DETAILS, um die Struktur zu verstehen
Datumsformat	Datumsfilter verwenden das Format YYYY-MM-DDTHH:MM:SS, nicht ISO 8601 mit Zeitzone
Leere Umfrage bei Erstellung	Neue Umfragen beginnen mit einer leeren Seite und keinen Fragen – weitere Konfiguration ist erforderlich

---

Kurzreferenz

Aktion	Tool-Slug	Wichtige Parameter
Umfrage erstellen	SURVEY_MONKEY_CREATE_SURVEY	title, language, nickname
Umfragen auflisten	SURVEY_MONKEY_GET_SURVEYS	title, sort_by, include, page
Umfragedetails abrufen	SURVEY_MONKEY_GET_SURVEY_DETAILS	survey_id
Collector auflisten	SURVEY_MONKEY_GET_COLLECTORS	survey_id, include, sort_by
Antworten abrufen	SURVEY_MONKEY_GET_RESPONSES	survey_id, status, start_created_at

---

Bereitgestellt von Composio