SMS

Envoyez des messages texte standard à l'aide de l'API SMSBAT. Le SMS est le canal de messagerie le plus universel avec les taux de livraison les plus élevés sur tous les appareils mobiles.

Aperçu

Le SMS (Short Message Service) est idéal pour :

Notifications urgentes
Repli pour les messages Viber/RCS
Atteindre les utilisateurs sans smartphone
Compatibilité universelle sur tous les réseaux mobiles
Taux de livraison élevés (95%+)

Message SMS de base

Demande

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

Paramètres

Paramètre	Tapez	Obligatoire	Descriptif
`de`	chaîne	Oui	ID de l'expéditeur alphanumérique (jusqu'à 11 caractères)
`à`	chaîne	Oui	Numéro de téléphone du destinataire au format E.164
`type`	chaîne	Oui	Définir sur « sms »
`texte`	chaîne	Oui	Contenu du message
`customerMessageId`	chaîne	Non	Votre identifiant de suivi interne
`ttl`	entier	Non	Durée de vie en secondes

Exemples

SMS simples

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

SMS avec identifiant client

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

SMS avec TTL

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

Encodage des caractères

Encodage GSM 7 bits

Alphabet GSM standard (160 caractères par SMS) :

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

Caractères GSM étendus

Ces caractères comptent pour 2 caractères :

| ^ € { } [ ] ~ \

Encodage Unicode (UCS-2)

Les messages comportant des caractères spéciaux utilisent le codage Unicode (70 caractères par SMS) :

-Emoji : 😀 🎉 ❤️ - Cyrillique : А Б В Г Д Е Ж - Symboles spéciaux : ✓ ✗ ★ ♥

Longueur du message

SMS unique

GSM 7 bits : 160 caractères
Unicode : 70 caractères

SMS en plusieurs parties

Lorsque votre message dépasse la limite, il est divisé en plusieurs parties :

GSM 7 bits : 153 caractères par partie
Unicode : 67 caractères par partie

Exemple

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

Ce message (201 caractères) sera divisé en 2 parties.

Réponse

Réponse réussie

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

Champs de réponse

Champ	Descriptif
`messageId`	Identifiant unique pour le suivi
`statut`	Statut du message (`accepté`, `rejeté`)
`pièces`	Nombre de parties SMS
`à`	Numéro de téléphone du destinataire

ID de l'expéditeur

Expéditeur alphanumérique

Utilisez le nom de votre marque comme expéditeur (jusqu'à 11 caractères) :

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

Restrictions :

Maximum 11 caractères
Lettres et chiffres uniquement
Pas d'espaces ni de caractères spéciaux
Le destinataire ne peut pas répondre aux expéditeurs alphanumériques

Expéditeur numérique

Utiliser un numéro de téléphone comme expéditeur (pour les SMS bidirectionnels) :

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

Cas d'utilisation

Vérification OTP

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

Notifications de commande

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

Rappels de rendez-vous

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

Confirmations de paiement

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

meilleures pratiques

Contenu du message

✅ Gardez les messages concis et clairs
✅ Inclure l'identification de l'expéditeur
✅ Ajoutez un appel à l'action si nécessaire
✅ Utilisez une grammaire et une orthographe appropriées
❌ Évitez les ponctuations excessives !!!
❌ N'utilisez pas de majuscules
❌ Évitez les raccourcisseurs d'URL qui semblent suspects

Utilisation des caractères

Vérifiez le nombre de caractères avant d'envoyer
Soyez conscient des caractères GSM étendus (comptez pour 2)
Testez avec des caractères spéciaux avant l'envoi groupé
Pensez à utiliser l'encodage GSM pour les messages plus longs

Numéros de téléphone

Utilisez toujours le format E.164 : +380XXXXXXXXX
Valider les numéros de téléphone avant d'envoyer
Supprimez les numéros invalides de votre liste
Gardez votre liste de contacts à jour

Moment

Respecter les fuseaux horaires locaux
Évitez d'envoyer la nuit (22h00 - 8h00)
Tenez compte des heures d'ouverture pour les messages commerciaux
Définir le TTL approprié pour les messages urgents

Conformité

Obtenir le consentement avant d'envoyer des messages marketing
Inclure des instructions de désinscription pour les SMS promotionnels
Suivre les réglementations locales (RGPD, etc.)
Respecter les listes "Ne pas déranger"

Gestion des erreurs

Erreurs courantes

Erreur	Parce que	Solutions
`INVALID_RECIPIENT`	Mauvais format de téléphone	Utiliser le format E.164
`INVALID_SENDER`	ID d'expéditeur invalide	Vérifier les règles d'identification de l'expéditeur
`MESSAGE_TOO_LONG`	Dépasse la longueur maximale	Diviser ou raccourcir le message
`INVALID_ENCODING`	Caractères non pris en charge	Utiliser GSM ou Unicode

Optimisation des coûts

Réduire les parties du message

Gardez les messages sous 160 caractères (GSM) ou 70 (Unicode)
Évitez les caractères spéciaux qui déclenchent Unicode
Utilisez des abréviations le cas échéant
Supprimer les espaces inutiles

Exemple d'optimisation

❌ Avant (171 caractères, 2 SMS) :

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ Après (156 caractères, 1 SMS) :

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

Envoi groupé

Envoyez plusieurs messages en une seule demande :

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

Prochaines étapes

Messages Viber - Messagerie multimédia enrichie
Messages RCS - Services de communication riches
Vérifier l'état - Suivre l'état de la livraison
Stratégies de secours - Configurer les solutions de secours