Aller au contenu

API SMSBAT

SMSBAT est une plate-forme API RESTful permettant d'envoyer différents types de messages, notamment le carrousel Viber, la boîte de dialogue d'opinion Viber, la promotion Viber (images, vidéo), le chat professionnel Viber, les notifications OTP (Viber OTP, Flash Call) et leurs variantes de secours.

URL de base

Les requêtes adressées à l'API SMSBAT sont transmises à un point de terminaison avec localisation. Demandez l’adresse à votre Responsable au préalable.

Exemple : https://restapi.smsbat.com (l'URL réelle peut varier en fonction de votre région)

Authentification

L'API SMSBAT prend en charge trois méthodes d'authentification :

Méthode 1 : authentification HTTP de base

Utilisez votre nom d'utilisateur et votre mot de passe :

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d @request.json

Méthode 2 : en-tête de clé API

Utilisez l'en-tête X-Authorization-Key :

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Méthode 3 : clé API comme mot de passe

Utilisez @ comme nom d'utilisateur et votre clé API comme mot de passe :

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Points de terminaison disponibles

Méthode Point de terminaison Descriptif
POSTER /bat/liste de messages Envoyer des messages
OBTENIR /bat/message/{messageId} Vérifier l'état du message

Types de messages

L'API SMSBAT prend en charge les types de messages suivants :

  • SMS - Messages texte standards
  • Viber Promo - Messages promotionnels avec des médias riches
  • Viber Transactional - Notifications de transactions
  • Viber Carousel - Messages de carrousel interactifs
  • Viber Survey - Messages de dialogue d'opinion
  • Viber OTP - Notifications de mot de passe uniques
  • RCS - Messages des services de communication enrichis
  • Flash Call - Vérification des appels silencieux

Principales fonctionnalités

Messagerie de secours

Lorsque la livraison principale échoue, SMSBAT revient automatiquement vers des canaux alternatifs :

Viber → SMS → Email

Prise en charge des médias riches

Envoyez des messages avec :

-Images (JPG, PNG) - Vidéos (MP4) - PDF - Boutons et liens d'action

Suivi de l'état des messages

Suivez l'état de la livraison en temps réel :

  • Envoyé
  • Livré
  • Lire
  • Échec
  • Expiré

Rappels

Recevez des rappels de messages Viber entrants pour une communication bidirectionnelle.

Démarrage rapide

  1. Envoyer un message - Découvrez comment envoyer votre premier message
  2. Vérifier l'état - Suivre l'état de livraison des messages
  3. Types de messages - Explorez différents types de messages

Format de la demande

Toutes les requêtes utilisent le format JSON avec la structure suivante :

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "type": "viber",
      "text": "Your message here",
      // ... additional parameters
    }
  ]
}

Format de réponse

Les réponses positives reviennent :

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "recipient": "+380XXXXXXXXX",
      "status": "sent"
    }
  ]
}

Gestion des erreurs

Codes d'état HTTP :

  • 200 OK - Demande réussie
  • 400 Bad Request - Format de requête invalide
  • 401 Non autorisé - Échec de l'authentification
  • « 429 demandes trop nombreuses » - Limite de débit dépassée
  • 500 Erreur de serveur interne - Erreur de serveur

Prochaines étapes