aethexDocs
SurveyMonkey logo
Sondages

SurveyMonkey

Transformez n'importe quel sondage SurveyMonkey public en agent vocal qui appelle les gens, pose les questions à voix haute dans leur langue et enregistre chaque réponse dans votre sondage. Vous collez un lien ; Aethex fait le reste.

Comment ça marche

Donnez à Aethex un lien SurveyMonkey public. Il lit le sondage page par page et construit un agent vocal dont le script pose chaque question dans l'ordre.Quand l'agent appelle quelqu'un, la conversation est transcrite. Après l'appel, Aethex remplit votre formulaire de sondage en direct à partir de la transcription, une page à la fois, et soumet la réponse. Vous ne touchez jamais au formulaire vous-même.

Quand votre agent est prêt

La lecture du sondage se fait en arrière-plan, donc un nouvel agent démarre avec le statut provisioning. Il passe à active une fois son script écrit, généralement en quelques secondes. Si le sondage ne peut pas être lu, l'agent est marqué failed.

Remarque
Un agent de sondage ne peut pas passer d'appels tant qu'il n'est pas active. Interrogez GET /api/v1/agents/:id avec le scope agents:read, et commencez à appeler une fois son statut active.
ÉTAPE 01

Créer un agent de sondage

Envoyez le lien du sondage public, la voix que l'agent doit utiliser et la langue de l'appel. Cela nécessite le scope agents:write (et agents:read pour interroger le statut). L'agent revient avec le statut provisioning.- survey_url (requis) : un collecteur Web Link public sur surveymonkey.com, surveymonkey.eu, surveymonkey.co.uk ou research.net.
- voice_id (requis) : une de vos voix depuis GET /voices.
- language (requis) : english ou french, la langue que l'agent parle.
- name (optionnel) : un libellé pour l'agent. Par défaut « SurveyMonkey agent ».

Créer un agent de sondage
bash
curl -X POST https://api.aethexai.com/api/v1/integrations/surveymonkey \
  -H "X-API-Key: $AETHEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "survey_url": "https://www.surveymonkey.com/r/XXXXXXX",
    "voice_id": "<your-voice-id>",
    "language": "english",
    "name": "Customer satisfaction survey"
  }'
ÉTAPE 02

Appeler un participant

Une fois l'agent active, utilisez-le comme n'importe quel agent Aethex : lancez un appel sortant, ou attachez un numéro de téléphone pour l'entrant. Vous ne soumettez rien vous-même. À la fin de l'appel, Aethex remplit et soumet la réponse du sondage à partir de la transcription.

Ce qu'il peut demander

L'agent parcourt le sondage dans l'ordre, page par page : texte court, zones de commentaire, choix unique (boutons radio et listes déroulantes), choix multiple (cases à cocher) et dates. Il s'adapte au contenu du sondage, vous n'avez donc jamais à mapper les questions à la main.

Tester sans polluer vos résultats

Lancer un agent de sondage depuis « Tester dans le navigateur » du tableau de bord soumet à votre collecteur en direct comme un vrai appel, mais marque la réponse avec la variable personnalisée aethex_source=dashboard_test.

Astuce
Ajoutez une variable personnalisée nommée aethex_source à votre sondage (Concevoir le sondage, puis Variables personnalisées) pour filtrer les lignes de test de vos résultats. Les sondages qui ne la définissent pas ignorent simplement le paramètre.

Notes et limites

L'intégration ne stocke aucun identifiant SurveyMonkey et n'ajoute aucun outil en cours d'appel. Elle a seulement besoin d'un lien de sondage public, et Aethex parle anglais et français aujourd'hui.Limites de provisioning. La lecture parcourt le sondage sans répondre, donc une question obligatoire qui bloque avant la dernière page, ou un sondage de plus de 20 pages, échoue au provisioning et l'agent ne devient jamais actif. Gardez les questions obligatoires répondables dans l'ordre, et divisez les sondages très longs.

Attention
Une réponse est enregistrée dès que le remplissage atteint la dernière page du sondage avec au moins une réponse captée, donc un appel écourté peut tout de même enregistrer une réponse partielle si les questions restantes sont optionnelles. « Tester dans le navigateur » enregistre une réponse marquée, pas un test à blanc, donc utilisez un sondage jetable pendant vos tests si vous ne voulez pas de réponses dans vos résultats de production.