Sommaire

• Introduction
• Présentation des SMS transactionnels
• Page Mes SMS transactionnels
  • Générer des jetons d'accès
  • Tarification des SMS
  • Ajouter des crédits à votre compte SMS
  • Devise de votre compte SMS
• Envoyer des messages via l'API SMS
• Tableau de bord des statistiques SMS

Introduction

Communiquez avec vos clients où qu'ils soient ! Avec l'API SMS de Mailjet, envoyez des messages transactionnels vers plus de 55 pays dans le monde.

Voici comment cela fonctionne :

• Ajoutez des crédits à votre compte SMS et générez des jetons d'accès ;
• Envoyez des messages transactionnels à l'aide de l'API SMS ;
• Visualisez vos statistiques depuis votre tableau de bord SMS.

Ce guide porte sur la gestion de votre compte SMS (génération de jetons, tarifs et crédits, tableau de bord des statistiques).

Demandez à votre développeur de consulter notre Guide de référence de l'API SMS, qui comporte des explications sur les méthodes, l'encodage et les codes d'erreur ainsi que des instructions d'utilisation pour notre API RESTful.

Présentation des SMS transactionnels

Voici quelques généralités sur l'envoi de SMS transactionnels :

• Un SMS peut contenir jusqu'à 160 caractères (encodés en GSM7) et il est possible d'envoyer au maximum 5 SMS concaténés (jusqu'à 765 caractères) à la fois*
• La limite d'envoi par défaut est de 200 SMS par jour
• La page du compte SMS est disponible uniquement depuis votre compte principal (et non depuis les sous-comptes) ;
• Les SMS ne peuvent pas être envoyés à vos listes de contacts. Ils ne peuvent être envoyés qu'aux utilisateurs ayant donné leur accord pour recevoir des SMS transactionnels et renseigné un numéro de téléphone dans le formulaire d'inscription.

* Documentation pour les développeurs : section Concaténation et encodage des SMS

Page Mes SMS transactionnels

Cliquez sur « SMS » depuis le menu principal.

Depuis la page SMS transactionnels, vous pouvez :

• Générer des jetons d'accès ;
• Visualiser le solde actuel de votre compte SMS prépayé et acheter des crédits ;
• Analyser et télécharger les statistiques SMS des 3 derniers mois.

Générer des jetons d'accès

Avant de pouvoir utiliser l'API SMS, vous devez générer un jeton d'accès qui sera utilisé pour l'authentification.

Pour créer un jeton d'accès, cliquez sur « Générer un jeton ».

Saisissez un nom unique pour votre jeton et cliquez sur « Générer ».

Une fois le jeton généré, copiez et enregistrez sa valeur. Pour des raisons de sécurité, la valeur de votre jeton n'est pas conservée sur Mailjet. Une fois la fenêtre modale fermée, vous ne pouvez plus visualiser la valeur du jeton.

Vous pouvez générer un maximum de 10 jetons actifs. Pour afficher ou supprimer vos jetons actuels, cliquez sur « Gérer les jetons ».

Documentation pour les développeurs : Comment s'authentifier à l'aide de jetons de porteur

Tarification des SMS

Le tarif d'envoi des SMS transactionnels dépend du pays de destination.

Consultez notre « Consulter les tarifs » pour connaître le coût d'envoi des SMS par pays. Si vous souhaitez envoyer des messages vers un pays ne figurant pas dans la liste, veuillez ouvrir un ticket de support.

Vous pouvez ajouter des crédits (en dollars américains, euros ou livres sterling) à votre compte SMS à tout moment. Le montant minimum par recharge est de 1 dollar/euro/livre et les crédits sont non remboursables.

Le coût de chaque SMS envoyé sera automatiquement déduit de votre compte SMS.

Ajouter des crédits à votre compte SMS

Remarque : en vertu de la réglementation internationale, un processus de validation est nécessaire pour le premier achat de SMS avec une nouvelle carte bancaire. Ce processus peut prendre jusqu'à 48 heures. Une fois votre paiement validé, votre carte bancaire sera débitée et les crédits seront ajoutés à votre compte SMS.

Depuis la page SMS transactionnels, cliquez sur « Ajouter des crédits ».

Saisissez le montant à ajouter dans la devise souhaitée. Utilisez le calculateur SMS pour estimer le nombre de messages transactionnels pouvant être envoyés vers un pays donné. Cliquez ensuite sur « Continuer ».

Confirmez vos informations de facturation (étape 2) et cliquez sur « Continuer ».

Sélectionnez votre carte de paiement et cliquez sur « Continuer ».

Lisez les Conditions générales et cochez la case pour confirmer que seuls des SMS transactionnels seront envoyés aux contacts ayant explicitement accepté de recevoir des SMS, le non-respect de cette règle pouvant entraîner une amende ou l'annulation du service.

Cliquez sur « Confirmer votre commande ».

Pour rappel, si vous utilisez une nouvelle carte bancaire pour acheter des SMS pour la première fois, le processus de validation peut prendre jusqu'à 48 heures et le montant sera « en attente » sur votre compte pendant ce temps.

Une facture sera émise pour chaque ajout de crédits à votre compte SMS.

Devise de votre compte SMS

La devise utilisée lors de votre achat de crédits déterminera celle de votre compte SMS. Si vous achetez des crédits en dollars, la devise de votre compte SMS sera le dollar ; si vous achetez des crédits en euros, la devise de votre compte sera l'euro. Le montant minimum par recharge est de 1 unité (dollar/euro/livre).

Si la devise de votre compte SMS change lors d'une recharge, les crédits existants éventuels ne seront pas convertis ni transférés dans la nouvelle devise. Ces crédits seront de nouveau accessibles lorsque vous effectuerez une nouvelle recharge (d'un montant minimum de 1 unité) dans la devise correspondante.

Par exemple :

Paul effectue un achat de crédits initial d'un montant de 400 $ et le solde de son compte SMS prépayé est de 400 $. Pour chaque SMS transactionnel envoyé, le coût est automatiquement déduit du solde prépayé. Après un mois d'envoi, il reste 125 $ sur son compte.

Paul achète ensuite 200 € de crédits. Son compte SMS prépayé passe en euros et le solde est maintenant de 200 €. Tout SMS envoyé sera déduit de ces 200 €.

Les 125 $ seront inaccessibles jusqu'à ce que le compte repasse en dollars lors du prochain achat en dollars (d'un montant minimum de 1 $).

Envoyer des messages via l'API SMS

Une fois vos jetons d'accès générés et des crédits ajoutés à votre compte SMS, vous pouvez utiliser l'API SMS pour :

• Envoyer d'importants volumes de SMS ;
• Consulter les détails des SMS et les statistiques d'envoi ;
• Exporter une liste de SMS.

Voici la documentation technique dont votre équipe de développement aura besoin pour l'intégration de l'API SMS :

• Guide de référence de l'API SMS
• Guide de l'API SMS
• Concaténation et encodage des SMS
• Codes de statut des SMS
• Codes d'erreur

Tableau de bord des statistiques SMS

• Délivré : Le SMS est parvenu au destinataire.
• En attente : Le SMS a été envoyé.
• Rejeté : Le SMS n'a pas pu parvenir au destinataire (expéditeur sur liste noire, numéro invalide ou inactif, destinataire ayant activé une fonction « Ne pas déranger », message rejeté par l'opérateur, etc.). Si un motif d'erreur a été fourni, il s'affichera dans la colonne Détails.