— Développeurs

Construisez avec Wassa360.

Des API simples, versionnées et documentées pour connecter votre site, votre application ou votre système à Wassa360. On commence par les SMS : envoyez vers Orange, Free et Expresso, avec vos propres identifiants opérateur, et soyez prévenu de chaque livraison.

— Pour démarrer

Votre premier SMS.

  1. 1

    Créez votre compte

    Inscrivez votre commerce sur Wassa360, puis activez les SMS dans Réglages › SMS et créez une clé dans Réglages › API.

  2. 2

    Branchez votre opérateur

    Saisissez vos identifiants Orange SMS Pro : vos SMS partent sur votre contrat, avec votre nom d'expéditeur.

  3. 3

    Créez une clé et envoyez

    Une clé wm_test_ pour essayer sans rien envoyer, une clé wm_live_ pour la production.

RequêtePOST /v1/messages
curl https://wassa360.com/messaging/v1/messages \
  -H "Authorization: Bearer wm_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: commande-1042" \
  -d '{
    "to": "+221771234567",
    "body": "Votre commande #1042 est prête."
  }'
Réponse 201
{
  "object": "message",
  "id": "8f0c2b5e-…",
  "status": "sent",
  "to": "+221771234567",
  "carrier": "orange-sn",
  "segments": 1
}

— Webhooks

Sachez quand c'est délivré.

Chaque changement de statut appelle votre serveur, signé en HMAC-SHA256. En cas d'échec, Wassa360 fait jusqu'à 8 tentatives sur environ 42 heures, et tous les événements restent consultables par l'API.

message.sent message.delivered message.undelivered message.expired message.failed
Vérifier la signature (Ruby)
header = request.headers["WassaMessaging-Signature"]
t, v1 = header.split(",").map { _1.split("=", 2).last }
expected = OpenSSL::HMAC.hexdigest(
  "SHA256", ENV["WASSA_WEBHOOK_SECRET"], "#{t}.#{request.raw_post}"
)
head :unauthorized unless
  ActiveSupport::SecurityUtils.secure_compare(expected, v1)
Service client