Allo

Suspendre un compte

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…

POST/v2/api/partner/accounts/{id}/suspend

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.

Autorisation

Authorizationstring · headerrequis

Api-Key ak_live_…

Paramètres de chemin

idstringrequis

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

Réponses

200The account, with its new status
dataobject
5 champs
idstring
phone_numbersstring[]
statusstring

The account's status: ACTIVE, or SUSPENDED while the account is suspended with Suspend account.

activatedboolean

True once the customer has signed in on a device.

partner_client_refstring | null
401
403The API key lacks the PARTNER scope.
errorobject
404No account with this id was provisioned by your API key, or the account is deactivated (PARTNER_ACCOUNT_NOT_FOUND).
errorobject
429