Envoyer votre premier SMS avec l'API

Ce guide envoie un SMS avec l'API REST de FortWave. La référence de l'API SMS détaille chaque point de terminaison et chaque champ, et la référence de l'API WhatsApp couvre WhatsApp.

Ce qu'il vous faut

• Une clé API.
• Pour des SMS réels : une entreprise approuvée, un identifiant d'expéditeur approuvé et des crédits. Pour essayer d'abord, utilisez le mode test avec l'identifiant MiraiTest et votre numéro de test vérifié.

Envoyer la requête

Envoyez une requête POST vers /v1/sms avec votre clé dans l'en-tête Authorization. Les champs phone_number, sender et message sont obligatoires.

curl -X POST https://rest.api.fortwave.io/v1/sms \
  -H "Authorization: Bearer $FORTWAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"phone_number":"+25761000000","sender":"MyApp","message":"Your verification code is 123456."}'

Remplacez MyApp par votre identifiant d'expéditeur approuvé et le numéro par celui du destinataire, avec + et l'indicatif du pays (les numéros locaux comme 61000000 sont aussi acceptés). Une réponse réussie renvoie l'identifiant du message avec le statut queued (en file d'attente).

Recevoir les mises à jour de livraison

Plutôt que de vérifier chaque message, ajoutez une URL de webhook dans SMS → Identifiants d'expéditeur → Webhooks. FortWave appelle alors votre URL quand un message est envoyé (sms.sent) ou échoue (sms.failed). Chaque requête porte un en-tête X-Webhook-Signature, un HMAC-SHA256 du corps calculé avec votre secret de signature, pour vérifier qu'elle vient bien de FortWave. La référence de l'API montre comment le vérifier.

Erreurs fréquentes

• Non autorisé : la clé est absente, erronée ou révoquée.
• Entreprise non approuvée : les SMS réels exigent une entreprise approuvée. Utilisez le mode test en attendant.
• Expéditeur invalide : l'identifiant d'expéditeur n'est pas approuvé sur votre compte.
• Crédits insuffisants : achetez des crédits SMS.