SMS récurrents

Définissez sending_type: "recurring" et passez un objet recurring_schedule. La passerelle développe le planning à la soumission et facture le total projeté contre votre solde.

Récurrence hebdomadaire

Une paire de rappels hebdomadaires, chaque lundi et jeudi à 09:00, pendant six mois :

cURL

curl $BASE_URL/api/v1/lisoloo/sms-api/send \
  -X POST \
  -H "app-key: $LISOLOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["+243998857000"],
    "message": "Rappel : votre check-in hebdomadaire.",
    "sender_id": "WELLNESS",
    "sending_type": "recurring",
    "recurring_schedule": {
      "start_date": "2026-06-01",
      "end_date":   "2026-12-31",
      "frequency":  "weekly",
      "interval":   1,
      "times":      ["09:00"]
    }
  }'

Python

requests.post(SEND_URL, headers=HEADERS, json={
    "to":          ["+243998857000"],
    "message":     "Rappel : votre check-in hebdomadaire.",
    "sender_id":   "WELLNESS",
    "sending_type":"recurring",
    "recurring_schedule": {
        "start_date": "2026-06-01",
        "end_date":   "2026-12-31",
        "frequency":  "weekly",
        "interval":   1,
        "times":      ["09:00"],
    },
}).raise_for_status()

JavaScript

await fetch(SEND_URL, {
  method: "POST",
  headers: HEADERS,
  body: JSON.stringify({
    to: ["+243998857000"],
    message: "Rappel : votre check-in hebdomadaire.",
    sender_id: "WELLNESS",
    sending_type: "recurring",
    recurring_schedule: {
      start_date: "2026-06-01",
      end_date:   "2026-12-31",
      frequency:  "weekly",
      interval:   1,
      times:      ["09:00"],
    },
  }),
});

Variantes de fréquence

frequency	interval: 1	interval: 2	interval: 3
daily	chaque jour	un jour sur deux	tous les trois jours
weekly	chaque semaine	toutes les deux semaines	toutes les trois semaines
monthly	chaque mois, même jour du mois	tous les deux mois	tous les trois mois
yearly	une fois par an, même date	tous les deux ans	tous les trois ans

interval doit être ≥ 1. times est un tableau d’heures d’envoi HH:mm appliquées à chaque jour éligible.

Plusieurs heures par jour

{
  "to": ["+243998857000"],
  "message": "Prenez votre médicament.",
  "sending_type": "recurring",
  "recurring_schedule": {
    "start_date": "2026-06-01",
    "end_date":   "2026-07-01",
    "frequency":  "daily",
    "interval":   1,
    "times":      ["08:00", "14:00", "20:00"]
  }
}

Trois envois par jour × 30 jours × 1 destinataire = 90 SMS, tous facturés à la soumission.

Récurrence mensuelle et mois courts

La récurrence monthly s’ancre sur le jour-du-mois de start_date. Si ce jour n’existe pas dans un mois donné (par exemple start_date = 2026-01-31 appliqué à février), la passerelle utilise le dernier jour de ce mois à la place.

{
  "recurring_schedule": {
    "start_date": "2026-01-31",
    "end_date":   "2026-12-31",
    "frequency":  "monthly",
    "interval":   1,
    "times":      ["09:00"]
  }
}

Génère : 31 jan, 28 fév, 31 mars, 30 avr, 31 mai, 30 juin, 31 juil, 31 août, 30 sep, 31 oct, 30 nov, 31 déc. (Ou 29 fév en année bissextile.)

Contraintes

Contrainte	Valeur
interval minimum	1
Enum frequency	daily, weekly, monthly, yearly

L’API n’expose pas actuellement d’endpoints de pause / reprise / annulation pour les envois récurrents. Pour arrêter un planning récurrent en cours, contactez le support avec le message_id.

Voir aussi

• Types d’envoi — détails du schéma
• Planifier un SMS — moments futurs ponctuels
• Vérifier le solde — vérifier que la réserve a été appliquée