Envoyer des SMS et WhatsApp avec votre compte Telnyx
Connectez Telnyx pour envoyer les invitations aux enquêtes par SMS et WhatsApp depuis vos propres numéros, recevoir les réponses dans Conversations et voir le statut de livraison de chaque message.
Sur cette page
Connectez votre compte Telnyx, et Polzy envoie les SMS et les messages WhatsApp de cet espace de travail — invitations et relances des campagnes, messages de workflow et réponses dans une conversation — depuis vos propres numéros Telnyx. Les destinataires peuvent répondre par SMS : les réponses arrivent dans la conversation dans Polzy, et le journal de chaque message indique s’il a été livré.
Le SMS et WhatsApp sont disponibles à partir de l’offre Business, et seuls les Administrateurs peuvent connecter un fournisseur. Connectez Telnyx depuis la page Intégrations, ou sous Messages → Intégrations.
Avant de commencer
Il vous faut :
- Un espace de travail avec l’offre Business ou supérieure, et le rôle Administrateur.
- Un compte Telnyx avec un numéro capable d’envoyer des messages, rattaché à un messaging profile.
- Pour WhatsApp : un compte WhatsApp Business connecté dans Telnyx, sur un numéro Telnyx (voir WhatsApp).
- Les numéros de mobile de vos participants dans leur fiche. Polzy les enregistre au format international, par exemple
+33 6 12 34 56 78; un numéro saisi sans indicatif est lu dans le pays de votre organisation, celui des Informations de facturation.
Comment Polzy utilise Telnyx
- SMS et WhatsApp. Dès que vous choisissez Telnyx pour le SMS, WhatsApp ou les deux, chaque message envoyé par l’espace de travail sur ce canal passe par votre compte.
- Réponses. Quand quelqu’un répond, la réponse s’ajoute à sa conversation ouverte dans Polzy (voir Conversations).
- Livraison. Le journal de chaque message dans Messages indique Livré ou Échoué, avec la raison donnée par Telnyx.
- Ce que ça coûte. Telnyx vous facture ces messages. Ils ne comptent pas dans les messages mensuels de votre organisation dans Polzy, qui ne concernent que l’expéditeur de Polzy.
Étape 1 : Configurer Telnyx
- Dans le portail Telnyx, achetez ou portez un numéro capable d’envoyer des messages, pour chaque pays de destination.
- Sous Messaging, créez un messaging profile et rattachez-y votre numéro. Un profil gère la mise en commun des numéros et les paramètres de livraison.
- Sous API Keys, créez une clé et copiez-la. Telnyx ne l’affiche qu’une fois.
- Sous Keys & Credentials, ouvrez Public Key et copiez-la. Polzy l’utilise pour vérifier que les accusés de livraison et les réponses viennent bien de Telnyx.
Pour envoyer avec un nom plutôt qu’un numéro, comme Acme, définissez un identifiant d’expéditeur alphanumérique sur le messaging profile. On ne peut pas y répondre, il n’atteint pas les États-Unis ni le Canada, et certains pays exigent de l’enregistrer d’abord.
Voir Telnyx: Create and manage API keys, Telnyx: Messaging profiles et Telnyx: Alphanumeric sender ID.
Étape 2 : Connecter Telnyx dans Polzy
- Ouvrez Intégrations dans la barre latérale, l’onglet Disponibles, et cliquez sur Connecter dans la ligne de Telnyx. Ou ouvrez Messages, l’onglet Intégrations, et cliquez sur Configurer pour Telnyx.
- Dans le panneau Connecter Telnyx, remplissez les champs :
| Champ | Ce qu’il faut saisir |
|---|---|
| API key | La clé de l’étape 1. Requis. |
| Messaging profile ID | L’identifiant du profil auquel votre numéro est rattaché. Recommandé pour le SMS. |
| Numéro expéditeur | Votre numéro Telnyx au format international (E.164), par exemple +15550000000. |
| Alpha sender | Un nom d’expéditeur pour les SMS internationaux, de 3 à 11 lettres ou chiffres, identique à celui du messaging profile. On ne peut pas y répondre. |
| Numéro WhatsApp | Le numéro enregistré sur votre compte WhatsApp Business, pour WhatsApp. |
| Clé publique du webhook | La clé publique de l’étape 1. Sans elle, les accusés de livraison et les réponses sont refusés. |
Pour le SMS, saisissez un Numéro expéditeur ou un Alpha sender : Polzy a besoin de l’un des deux pour envoyer, même avec un messaging profile. Si les deux sont remplis, le numéro est utilisé, pour que les destinataires puissent répondre.
- Cliquez sur Tester la connexion. Vous devez voir Connected to Telnyx avec le nombre de messaging profiles visibles par la clé (ce message est en anglais).
- Cliquez sur Connecter.
Étape 3 : Choisir Telnyx pour le SMS et WhatsApp
- Ouvrez Paramètres, puis l’onglet Notifications, et descendez jusqu’à Canaux.
- Sur la ligne SMS, remplacez Polzy · compte partagé par Telnyx, et vérifiez que l’interrupteur est activé.
- Pour envoyer aussi par WhatsApp, faites de même sur la ligne WhatsApp.
Slack
TeamsUne campagne envoie alors par Telnyx quand vous choisissez SMS ou WhatsApp comme canal dans l’onglet Envoi. Une campagne utilise un seul canal.
Étape 4 : Recevoir les réponses
Les accusés de livraison ne demandent rien de plus : Polzy demande un accusé à Telnyx pour chaque message envoyé. Les réponses demandent un réglage dans Telnyx.
- Dans Polzy, ouvrez la page de Telnyx depuis Intégrations et trouvez Réception. Copiez l’adresse affichée.
- Dans le portail Telnyx, ouvrez votre messaging profile et collez l’adresse comme URL de webhook entrant. Enregistrez.
La réponse d’une personne ayant une conversation ouverte sur ce canal s’y ajoute, et la personne qui a ouvert la conversation est prévenue. Un message de quelqu’un d’autre n’apparaît pas dans Polzy. Voir Telnyx: Receiving webhooks for messaging.
Les messages WhatsApp passent par un compte WhatsApp Business que vous connectez dans Telnyx, sous Messaging → WhatsApp, en vous connectant avec votre compte professionnel Meta et en vérifiant votre numéro. Saisissez ce numéro comme Numéro WhatsApp dans Polzy. Voir Telnyx: Send your first WhatsApp message.
WhatsApp n’autorise une entreprise à écrire librement que dans les 24 heures qui suivent le dernier message de la personne. En dehors de cette fenêtre, il n’accepte qu’un modèle approuvé par Meta. Ce que cela signifie dans Polzy :
- Les invitations des campagnes partent comme des messages ordinaires : WhatsApp ne les livre donc qu’aux personnes qui ont écrit à votre numéro WhatsApp dans les dernières 24 heures. Pour tous les autres, le message échoue, et son journal affiche la raison donnée par Telnyx. Pour un premier contact, envoyez par SMS ou par e-mail.
- Conversations. Dans les 24 heures qui suivent le dernier message de la personne, répondez librement. Ensuite, Polzy indique WhatsApp n'autorise les réponses libres que dans les 24 heures suivant leur dernier message. Envoyez un modèle approuvé pour rouvrir. Choisissez un modèle sous Choisir un modèle approuvé et cliquez sur Envoyer le modèle.
- Modèles. Les modèles se créent dans Telnyx et sont approuvés par Meta, en général en un ou deux jours. La liste dans Polzy affiche les modèles enregistrés pour votre espace de travail ; Polzy n’a pas d’écran pour en ajouter, donc quand il indique Aucun modèle approuvé, la conversation reprend dès que la personne écrit de nouveau.
Limites et coûts
- Segments SMS. Un SMS contient jusqu’à 160 caractères, ou 70 si le texte comporte un caractère hors de l’alphabet GSM standard — un emoji, ou une écriture comme l’arabe. Un message plus long part en plusieurs parties, et Telnyx facture chacune.
- Heures calmes. Avec Respecter les heures calmes activé sous Paramètres → Notifications, les messages des campagnes attendent 08:00 dans le fuseau horaire du destinataire au lieu de partir entre 20:00 et 08:00.
- Les limites de votre compte. Les limites d’envoi et les règles par pays de Telnyx s’appliquent.
Dépannage
| Ce que vous voyez | Pourquoi, et que faire |
|---|---|
| A from number, alpha sender, or WhatsApp number is required | Renseignez au moins un expéditeur. Pour le SMS, un Numéro expéditeur ou un Alpha sender. |
| Le test échoue avec un message de Telnyx sur l’authentification | La clé d’API a été mal saisie, supprimée ou a expiré. Créez-en une nouvelle. |
| Les messages échouent avec No SMS sender configured | Seul un messaging profile est défini. Ajoutez un Numéro expéditeur ou un Alpha sender. |
| Les messages échouent avec No WhatsApp sender configured | Renseignez le Numéro WhatsApp. |
| Le SMS n’est pas disponible dans une campagne | SMS est désactivé, ou n’a pas de fournisseur, sous Paramètres → Notifications → Canaux. |
| Les statuts ne dépassent jamais Envoyé, ou les réponses n’arrivent pas | La Clé publique du webhook est vide ou fausse : la section Activité de la page de Telnyx affiche Message entrant refusé. Pour les réponses, vérifiez aussi l’URL de webhook entrant du messaging profile. |
| Les destinataires ne peuvent pas répondre | Le message est parti d’un Alpha sender. Ajoutez un Numéro expéditeur. |
| Les messages WhatsApp échouent | La personne n’a pas écrit à votre numéro dans les dernières 24 heures (voir WhatsApp), ou le numéro n’est pas enregistré pour WhatsApp dans Telnyx. |
Bon à savoir
- L’expéditeur de Polzy. Sans fournisseur à vous, les SMS partent à sens unique depuis l’expéditeur partagé de Polzy, comptent dans les messages mensuels de votre organisation, et on ne peut pas y répondre. WhatsApp passe par votre propre compte Telnyx ou Twilio jusqu’à ce que le numéro WhatsApp de Polzy soit vérifié.
- Si Telnyx ne fonctionne plus, Polzy continue d’essayer et le marque Nécessite une action. Si vous le déconnectez, les SMS repassent par l’expéditeur partagé de Polzy.
- Ce que Polzy conserve. La clé d’API et la clé publique sont chiffrées et ne sont plus jamais affichées.
Liens utiles
Articles liés
Les membres connectés peuvent demander à Polzy ou écrire à l’équipe depuis Support. Notre délai de réponse dépend de votre forfait.