Lister les synthèses de l'enquête avec l'API SurveyMonkey
Renvoie la synthèse de chaque question d'une enquête : combien de réponses ont choisi chaque option, ligne et colonne, avec les ids de questions d'Obtenir une enquête.
- Identifiant
- surveymonkey_list_survey_rollups
L'appel
POST https://connect.reportei.com/api/tools/surveymonkey_list_survey_rollups/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"survey_id": "<survey_id>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| survey_id | string | Oui | Id of the survey, from List surveys. |
| collector_ids | string | Non | Only responses from these collectors: ids from List collectors, separated by commas. |
| status | string | Non | Only responses with this status.Valeurs : completed, partial, overquota, disqualified |
| start_created_at | string | Non | Only responses started after this moment, a UTC date and time as YYYY-MM-DDTHH:MM:SS, without offset. |
| end_created_at | string | Non | Only responses started before this moment, a UTC date and time as YYYY-MM-DDTHH:MM:SS, without offset. |
| start_modified_at | string | Non | Only responses changed after this moment, a UTC date and time as YYYY-MM-DDTHH:MM:SS, without offset. |
| end_modified_at | string | Non | Only responses changed before this moment, a UTC date and time as YYYY-MM-DDTHH:MM:SS, without offset. |
| string | Non | Only responses of this recipient email, for email collectors. |
Connexions possibles
Votre client connecte son compte SurveyMonkey une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/surveymonkey, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/surveymonkey_list_survey_rollups. Il devient la définition de tool de votre agent sans conversion.
Autres tools SurveyMonkey
- Lister les enquêtesGETListe les enquêtes que le compte possède ou qui ont été partagées avec lui, avec id, titre et nickname ; include ajoute les compteurs, dates et liens. Paginez avec page tant que la réponse contient links.next.
- Lister les dossiers d'enquêtesGETListe les dossiers d'enquêtes du compte avec id, titre et nombre d'enquêtes. Paginez avec page tant que la réponse contient links.next.
- Obtenir une enquêteGETRenvoie l'enquête entière : réglages, les liens de modification, d'aperçu, de collecte et d'analyse, et chaque page avec ses questions et choix de réponse, tous avec leurs ids. Les outils de réponses et Lister les synthèses de l'enquête se réfèrent à ces ids.
- Créer une enquêtePOSTCrée une enquête : vide, copiée d'une autre enquête avec from_survey_id, ou avec ses pages et questions dans pages. Renvoie l'id de l'enquête et ses liens de modification, d'aperçu et de collecte. Elle a encore besoin d'un collecteur pour recevoir des réponses.
- Mettre à jour une enquêtePATCHModifie le titre, le nickname, la langue, les textes des boutons, les variables personnalisées, le pied de page ou le dossier d'une enquête. Les pages et questions restent inchangées.
- Lister les collecteursGETListe les collecteurs d'une enquête, les moyens par lesquels elle reçoit des réponses, comme un lien web ou une invitation par email, avec id et nom ; include ajoute type, status, url et response_count. Paginez avec page tant que la réponse contient links.next.
- Créer un collecteurPOSTCrée un collecteur pour une enquête. Un collecteur weblink renvoie le lien à partager dans url, et c'est le seul type que le plan gratuit peut créer. Un collecteur email ne fait que préparer l'invitation : destinataires et envoi restent dans SurveyMonkey.
- Mettre à jour un collecteurPATCHModifie un collecteur : le ferme ou le rouvre avec status, ou change son nom, sa date de clôture, sa limite de réponses, ses messages et sa redirection.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
