Aperçu

SurveyAnalytica vous permet de connecter votre propre numéro de téléphone Telnyx ou Twilio pour envoyer et recevoir des SMS dans le cadre de vos campagnes et flux de travail. Une fois connecté, les réponses des contacts arrivent directement dans votre vue des conversations.

Avant de commencer

• Un numéro de téléphone acheté auprès de Telnyx ou Twilio.
• Les identifiants API de ce numéro (voir l’étape 2 ci-dessous).
• Un espace de travail dans SurveyAnalytica auquel attribuer le numéro.

Étape 1 : acheter un numéro de téléphone

Si vous n’avez pas encore de numéro, achetez-en un auprès du fournisseur de votre choix :

• Telnyx — Rechercher et acheter des numéros dans le portail Telnyx
• Twilio — Rechercher et acheter des numéros dans la console Twilio

Notez le numéro complet au format international, par exemple +14155551234.

Étape 2 : obtenir vos identifiants API

Telnyx

1. Connectez-vous au portail Telnyx.
2. Accédez à Auth > API Keys.
3. Cliquez sur Create API Key (ou copiez une clé existante qui commence par KEY...).
4. Copiez la clé complète — vous la collerez dans le champ API Key de SurveyAnalytica.

Twilio

1. Connectez-vous à la console Twilio.
2. Sur le tableau de bord principal, repérez votre Account SID et votre Auth Token.
3. Combinez-les au format AccountSID:AuthToken (séparés par deux-points, sans espaces).
4. Collez cette valeur combinée dans le champ API Key de SurveyAnalytica.

Étape 3 : connecter le numéro dans SurveyAnalytica

1. Accédez à Account > Domains & Numbers et ouvrez l’onglet SMS.
2. Remplissez le formulaire de connexion :

Champ	Que saisir
Provider	Sélectionnez Telnyx ou Twilio selon votre numéro.
Phone Number (E.164)	Votre numéro au format international, par ex. +14155551234. Doit commencer par + suivi de l’indicatif du pays.
API Key	Votre clé API Telnyx (KEY...), ou votre AccountSID:AuthToken Twilio.
Display Name (optionnel)	Un libellé convivial, par ex. Support Line. Utilise le numéro de téléphone par défaut si laissé vide.

3. Cliquez sur Connect. Si les identifiants sont incorrects, un message d’erreur s’affichera — vérifiez la clé API et réessayez.

Étape 4 : attribuer le numéro à un espace de travail

Chaque numéro connecté peut être attribué à un seul espace de travail. Une fois le numéro affiché dans la liste :

1. Utilisez le menu déroulant Assign to workspace sur la fiche du numéro.
2. Cliquez sur Save.

Le numéro est désormais disponible lors de la composition de campagnes SMS ou de conversations dans cet espace de travail.

Statut du webhook

Chaque fiche de numéro affiche un badge Webhook Active ou Webhook Not Configured qui se met à jour automatiquement.

• Webhook Active — les réponses entrantes et les mises à jour de livraison sont bien reçues.
• Webhook Not Configured — SurveyAnalytica n’a pas pu enregistrer le gestionnaire de messages entrants auprès du fournisseur. Vérifiez que la clé API est toujours valide, puis essayez de retirer et de rajouter le numéro.

Supprimer un numéro

Cliquez sur Delete sur la fiche du numéro pour le déconnecter. Le numéro reste dans votre compte Telnyx ou Twilio mais cessera de recevoir des messages entrants dans SurveyAnalytica.

Dépannage

Symptôme	Quoi vérifier
“Failed to connect number” error	Vérifiez que la clé API est correcte et n’a pas expiré. Pour Twilio, confirmez que le format est AccountSID:AuthToken sans espaces supplémentaires.
Numéro de téléphone rejeté	Assurez-vous que le numéro est au format E.164 : commence par +, l’indicatif du pays, puis le numéro — sans espaces ni tirets.
Webhook Not Configured après la connexion	Attendez un instant que le badge se mette à jour. S’il reste orange, retirez et reconnectez le numéro avec une nouvelle clé API.
Les messages entrants n’apparaissent pas	Confirmez que le numéro est attribué au bon espace de travail et que le badge du webhook affiche Active.