Retirer une marque de messagerie

Choisir la procédure de retrait

Retirez une marque de messagerie lorsque l’entreprise n’a plus besoin de cet enregistrement. Cette opération met fin à l’utilisation de l’enregistrement existant ; elle n’enregistre pas de marque de remplacement, ne libère pas les numéros de téléphone loués et ne corrige pas les informations d’identité de l’entreprise. Pour une correction, consultez Mettre à jour une marque de messagerie.

L’appel public DELETE pour une marque et l’action Supprimer la marque du portail ont des périmètres différents. L’appel public supprime une seule marque du registre. Le portail coordonne la dissociation des numéros et la désactivation des campagnes avant de tenter de supprimer la marque.

Examiner les conséquences dans le portail

Ouvrez la page d’enregistrement de la messagerie, repérez la bonne marque et choisissez Supprimer la marque. Vérifiez le nombre de campagnes associées et de numéros affectés. Saisissez l’identifiant exact de la marque pour activer l’action finale. Le formulaire client n’est disponible que si le compte dispose de l’autorisation de gestion des enregistrements.

Le portail traite les campagnes actives successivement : il tente de dissocier chaque numéro actuellement affecté, désactive la campagne, puis supprime la marque. Il n’effectue pas de nouvelle suppression à distance pour les campagnes déjà marquées comme expirées ou supprimées. Après la réussite de ces étapes externes, il met à jour les enregistrements locaux des campagnes et des numéros dans une transaction de base de données.

Cette séquence ne constitue pas une transaction atomique unique couvrant le registre, l’opérateur et les enregistrements locaux. Un échec ultérieur ne peut pas rétablir un numéro ou une campagne déjà modifiés à l’extérieur. Conservez les détails renvoyés sur les numéros dissociés et les campagnes désactivées lorsqu’ils sont disponibles ; rapprochez les résultats à partir de ces identifiants au lieu de créer une autre marque.

Préparer une suppression directe par API

Utilisez un compte API activé via HTTPS, depuis une adresse IP source autorisée. La marque doit appartenir à ce compte. Consultez et conservez son identifiant et son état actuel, puis vérifiez ses campagnes et les affectations des numéros. Dissociez les numéros concernés et procédez à l’opération suivante : désactiver les campagnes avant de supprimer la marque. Ne considérez pas cet appel DELETE comme une opération en cascade.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

Supprimer la marque vérifiée

Exécutez la commande suivante uniquement pour le retrait prévu, après avoir vérifié l’identifiant de la marque et terminé le nettoyage décrit précédemment. La requête ne contient pas de corps JSON.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request DELETE \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

Le résultat de réussite documenté est HTTP 204, sans corps de réponse. N’exigez pas d’objet de réussite JSON ni l’ancienne enveloppe v3 status/response. Un résultat rejeté dont le code n’appartient pas à la plage 2xx ne marque pas la marque comme supprimée via le mécanisme actuel de synchronisation de l’API.

Utilisez une seule clé d’idempotence pour la requête prévue. Lors d’une réexécution, conservez à l’identique les octets de la méthode, du chemin, de la chaîne de requête et du corps. La clé ne rend pas atomique l’ensemble du nettoyage effectué par le portail et ne prouve pas qu’un numéro a été dissocié chez l’opérateur. Une requête en double en cours de traitement peut renvoyer 409 avec Retry-After ; les requêtes terminées peuvent renvoyer leur réponse enregistrée, y compris une erreur.

Vérifier le retrait et rapprocher les résultats partiels

Après l’opération, vérifiez les listes des marques et des campagnes du portail ainsi que les numéros concernés. La synchronisation après réussite de l’API publique marque localement la marque concernée comme supprimée ; elle ne supprime pas les autres ressources de campagne et n’efface pas les affectations des numéros achetés. L’état dans le registre, l’affectation chez l’opérateur et l’affichage local nécessitent des vérifications distinctes.

L’adaptateur actuel du portail pour l’opérateur accepte une réponse de réussite HTTP sans valider séparément chaque valeur d’état métier dans son corps. Vérifiez donc les affectations réelles des numéros concernés aux campagnes après un nettoyage par le portail, même si celui-ci a signalé une réussite. Si une affectation ou un état présente une incohérence, conservez les identifiants concernés et contactez l’assistance avant d’envoyer des messages au moyen de la configuration retirée ou de la recréer.

Pour HTTP 400, consultez l’erreur détaillée du registre, en particulier une restriction liée à une campagne active. Pour 401, 403 ou 404, vérifiez les identifiants d’authentification, l’adresse IP source autorisée et l’appartenance de la marque au compte. Pour 429, respectez Retry-After. Une expiration du délai, 500 ou 502 peut survenir après une modification externe déjà effectuée ; examinez l’enregistrement existant avant de répéter la requête.

Vérifier les frais restants du compte

Le service DELETE actuel ne déclenche pas de débit immédiat pour l’enregistrement de la marque. La suppression d’une marque ne libère pas les numéros de téléphone loués, ne donne pas lieu à un remboursement et ne détermine pas le solde final du compte. Consultez dans le portail les éventuels engagements existants liés aux campagnes ainsi que les frais de location des numéros et d’utilisation. Cette opération ne constitue pas un devis pour ces services distincts.