Added

Pilotage des options d'une ligne mobile : appels, SMS, MMS, messagerie vocale et conférence

Endpoints impactés

PATCH https://api.netwo.io/api/v2-beta/mobile/subscriptions/{subscription_id}
GET   https://api.netwo.io/api/v2-beta/mobile/subscriptions/{subscription_id}

Changement

La mise à jour d'une souscription accepte sept nouveaux champs optionnels. Un champ absent laisse l'option inchangée. Les sept champs sont restitués dans service par la lecture de la souscription, quelle que soit la forme de la réponse (legacy passé ou non).

ChampEffetValeur par défaut
incoming_calls_allowedAppels entrantstrue si la ligne a le service voix
outgoing_calls_allowedAppels sortantstrue si la ligne a le service voix
incoming_sms_allowedSMS entrantstrue si la ligne a le service SMS
outgoing_sms_allowedSMS sortantstrue si la ligne a le service SMS
mms_allowedMMStrue
voicemail_enabledMessagerie vocale (et messagerie vocale visuelle)true
conference_calls_allowedAppels en conférencefalse

Les lignes existantes portent ces mêmes valeurs par défaut.

mms_allowed et voicemail_enabled sont à true par défaut sur toute ligne, mais l'option ne fonctionne que si le service dont elle dépend est présent : les MMS passent par le service SMS, la messagerie vocale par le service voix. Sur une ligne sans ce service, la valeur restituée reste true et toute modification de l'option est refusée (400).

La requête est acceptée (202) et appliquée chez l'opérateur de façon asynchrone : environ 5 minutes pour les appels, les SMS, les MMS et la conférence, le lendemain pour la messagerie vocale.

La requête est refusée (400) dans les cas suivants :

  • une option d'appel, de messagerie vocale ou de conférence sur une ligne sans service voix ; une option SMS ou MMS sur une ligne sans service SMS ;
  • en dehors de la plage 05:05 à 21:55, heure de Paris ;
  • une ligne sur un réseau autre qu'Orange.

Exemple

PATCH https://api.netwo.io/api/v2-beta/mobile/subscriptions/0c14083f-6bba-4895-8302-c464228a8cfe

{
  "outgoing_calls_allowed": false,
  "mms_allowed": false,
  "conference_calls_allowed": true
}

GET https://api.netwo.io/api/v2-beta/mobile/subscriptions/0c14083f-6bba-4895-8302-c464228a8cfe

{
  "subscription_id": "0c14083f-6bba-4895-8302-c464228a8cfe",
  "service": {
    "msisdn": "+33698453172",
    "incoming_calls_allowed": true,
    "outgoing_calls_allowed": false,
    "incoming_sms_allowed": true,
    "outgoing_sms_allowed": true,
    "mms_allowed": false,
    "voicemail_enabled": true,
    "conference_calls_allowed": true,
    "...": "..."
  }
}