Passer au contenu principal
POST
Suspend account
Scope requis : PARTNER
Suspend immédiatement un compte que vous avez provisionné, par exemple quand votre client ne vous paie plus. Le compte garde ses numéros, ses eSIM et son historique : Réactiver un compte remet tout en place. La réponse renvoie le compte avec status: SUSPENDED.

Ce qui s’arrête

La suspension s’applique à tous les membres et à tous les numéros du compte. Le status de chaque membre passe à SUSPENDED, et un membre que vous ajoutez pendant la suspension est SUSPENDED dès le départ.
  • Les appels entrants sont refusés : ils ne sonnent ni sur les apps ni sur les eSIM.
  • Les appels sortants passés depuis les apps Allo diffusent un court message à la place, qui indique que la ligne est suspendue et invite à contacter le fournisseur. Le message ne cite pas Allo.
  • Les SMS sortants sont refusés avec 403 ACCOUNT_SUSPENDED. Sur /v2/sms, l’endpoint utilisé par les apps Allo, le code d’erreur est Allo.9.
  • La réceptionniste IA ne répond plus, car les appels entrants s’arrêtent avant de l’atteindre.
  • Les lignes eSIM sont suspendues auprès du réseau mobile, puisque leur titulaire est SUSPENDED. Cela prend en général quelques secondes. Si le réseau ne confirme pas tout de suite, Allo réessaie toutes les 5 minutes. D’ici là, les appels et SMS sur l’eSIM elle-même peuvent encore passer.

Ce qui reste

  • Les numéros du compte, ses eSIM et son historique d’appels et de messages.
  • Les SMS entrants sont enregistrés dans la conversation, sans notification ni réponse automatique.
  • La connexion. Les membres peuvent toujours ouvrir les apps Allo et consulter leur historique. Ils ne peuvent ni appeler ni envoyer de SMS.
  • La facturation ne change pas. L’abonnement que vous payez pour le compte continue et se renouvelle normalement. Pour arrêter la facturation, désactivez le compte.

Webhook et idempotence

Allo envoie partner.account.suspended à votre propre endpoint webhook, pas à celui du compte. Sans endpoint webhook, lisez le statut avec Obtenir un compte. La requête est idempotente. Suspendre un compte déjà suspendu ne change rien, et Allo n’envoie pas de second webhook. {id} est l’identifiant du compte renvoyé par Créer un compte. Un compte que votre API key n’a pas créé, ou déjà désactivé, renvoie 404 PARTNER_ACCOUNT_NOT_FOUND.

Autorisations

Authorization
string
header
requis

Paramètres de chemin

id
string
requis

The account id returned by Create account (usr-*).

Réponse

The account, with its new status

data
object