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).
| Champ | Effet | Valeur par défaut |
|---|---|---|
incoming_calls_allowed | Appels entrants | true si la ligne a le service voix |
outgoing_calls_allowed | Appels sortants | true si la ligne a le service voix |
incoming_sms_allowed | SMS entrants | true si la ligne a le service SMS |
outgoing_sms_allowed | SMS sortants | true si la ligne a le service SMS |
mms_allowed | MMS | true |
voicemail_enabled | Messagerie vocale (et messagerie vocale visuelle) | true |
conference_calls_allowed | Appels en conférence | false |
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,
"...": "..."
}
}
