Intégration avec Twilio

PlatoForms peut envoyer des messages texte (SMS) pour vos formulaires : notifications de soumission, invitations, demandes de documents, renouvellements et tâches de workflow. Par défaut, ils passent par PlatoForms SMS, qui est payé à partir de votre solde de crédit et utilise un texte fixe. Si vous avez un compte Twilio, vous pouvez le connecter et envoyer ces textes via votre propre Twilio à la place.

PlatoForms SMS ou votre propre Twilio

Pas de compte Twilio ? Vous n’en avez pas besoin : PlatoForms SMS envoie vos textes sans aucune configuration, et une entreprise américaine ou canadienne peut s’y inscrire pour envoyer des SMS aux numéros américains. Voir Envoyer des messages texte (SMS). Les deux services sont distincts : s’inscrire sur PlatoForms ne modifie pas ce que votre compte Twilio peut envoyer.

Vous connectez Twilio une fois pour votre équipe. Après cela, vous choisissez le service à chaque endroit qui envoie des textes, de sorte qu’un formulaire peut utiliser votre Twilio tandis qu’un autre reste sur PlatoForms SMS.

Avant de commencer : ce dont vous avez besoin de Twilio

Rassemblez ces éléments dans la console Twilio :

1. Un service de messagerie avec un expéditeur dans son pool. Allez dans Messaging > Services, ouvrez ou créez un service, et ajoutez un numéro de téléphone ou un ID d’expéditeur alphanumérique à son pool d’expéditeurs. Copiez le SID du service de messagerie (commence par MG).

2. Votre SID de compte (commence par AC), affiché sous Infos du compte.

3. Une clé API standard. Allez dans Account > API keys & tokens, créez une clé Standard, et copiez son SID (commence par SK) et son secret. Twilio montre le secret une seule fois. Laissez le sélecteur de région sur États-Unis (US1), par défaut. La région ne limite pas les pays que vous pouvez joindre.

Connectez votre compte Twilio

1. Sur le Tableau de bord, survolez n’importe quel formulaire, cliquez sur Paramètres (icône d’engrenage) en haut à droite, puis cliquez sur Gérer le formulaire.

   

2. Dans la barre latérale gauche, cliquez sur Intégrations.

3. Trouvez la carte Twilio et cliquez sur Connecter. La page Messagerie texte s’ouvre dans un nouvel onglet de navigateur, sur son onglet Votre propre Twilio.

   

   Note

   La connexion est pour toute votre équipe, donc vous le faites une fois, depuis n’importe quel formulaire. Vous pouvez également ouvrir la page depuis Plan et Facturation > Solde de crédit : cliquez sur Paramètres de messagerie texte à côté de Messages SMS, puis l’onglet Votre propre Twilio.

4. Sous Connectez votre Twilio, entrez le SID de compte, le SID du service de messagerie, le SID de la clé API et le secret de la clé API, puis cliquez sur Connecter.

   

   PlatoForms vérifie le compte, le service de messagerie et ses expéditeurs avec ces identifiants. Rien n’est envoyé. Le secret de la clé API est stocké de manière chiffrée.

5. Lorsque la vérification est réussie, Votre propre Twilio affiche Connecté, avec les numéros ou les ID d’expéditeur de votre service de messagerie.

   

6. (Optionnel) Sous Envoyer un texte de test, entrez un numéro de mobile et cliquez sur Envoyer un texte de test pour confirmer la livraison. Twilio vous facture pour ce texte.

Utilisez votre Twilio pour les textes d’un formulaire

Connecter Twilio ne change rien en soi. Chaque section SMS continue d’utiliser PlatoForms SMS jusqu’à ce que vous le changiez.

1. Ouvrez les paramètres SMS que vous souhaitez modifier, par exemple Gérer le formulaire > Invitations ou Gérer le formulaire > Notifications, et activez SMS.

2. Sélectionnez Votre propre Twilio.

   

3. Rédigez le message texte. Cliquez sur une variable à côté de Insérer pour l’ajouter. Ce que le téléphone affiche prévisualise le message avec des valeurs d’exemple, et vous indique sa longueur et combien de textes il est envoyé.

   

4. Enregistrez vos modifications.

Vous pouvez faire ce choix dans chacun de ces endroits :

Règles pour votre propre texte

• Un texte peut contenir jusqu’à 320 caractères. Un long message est envoyé en plusieurs textes ; la prévisualisation montre combien.
• Utilisez uniquement les variables proposées pour ce texte. Lorsque le texte délivre un lien (invitations, demandes de documents, renouvellements et tâches de workflow), il doit contenir {{ link }}.
• PlatoForms ajoute une ligne de désinscription à chaque texte : “Répondez STOP pour vous désinscrire.” lorsque l’expéditeur est un numéro de téléphone, ou un lien de désinscription lorsqu’il s’agit d’un ID d’expéditeur alphanumérique, qui ne peut pas recevoir de réponses. Si votre service de messagerie a les deux, Twilio utilise l’ID d’expéditeur alphanumérique partout où le pays le permet (partout sauf aux États-Unis et au Canada), donc ces textes se terminent par le lien de désinscription.
• Un texte est vérifié lorsque vous l’enregistrez. Un texte qui demande des mots de passe, des détails de paiement ou des informations personnelles n’est pas accepté.
• Envoyez des textes uniquement aux personnes qui ont accepté de recevoir des SMS de votre part. Des limites quotidiennes par destinataire et par formulaire s’appliquent toujours, pour protéger les personnes que vous contactez.

Facturation et utilisation

• Les textes envoyés via votre Twilio sont facturés par Twilio à votre compte. PlatoForms ne les facture pas, et ils n’utilisent pas votre solde de crédit.
• Ils apparaissent toujours sur la page Utilisation sous SMS, à 0,00 $.
• Les sections laissées sur PlatoForms SMS fonctionnent comme avant et sont payées à partir de votre solde de crédit.

Remplacer la clé API ou déconnecter

• Remplacer la clé : créez une nouvelle clé API dans Twilio, ouvrez la page Messagerie texte (cliquez sur Configurer sur la carte Twilio), et entrez la clé sous Reconnectez votre Twilio.
• Déconnecter : cliquez sur Déconnecter votre Twilio. Le secret de la clé API est supprimé de PlatoForms. Les sections définies sur Votre propre Twilio reviennent à PlatoForms SMS avec le texte standard. Votre choix et vos textes sont conservés, et sont réutilisés lorsque vous vous reconnectez.
• Nécessite une attention : si Twilio cesse d’accepter la clé, par exemple après que vous l’ayez révoquée, la connexion affiche Nécessite une attention et le propriétaire de l’équipe reçoit un email. Jusqu’à ce que vous vous reconnectiez, ces sections utilisent PlatoForms SMS, ce qui nécessite un crédit dans votre solde.

Dépannage

Références

• Twilio : Clés API

• Twilio : Services de messagerie

• Discutez avec notre équipe de support

• Politique de confidentialité des données