Skip to main content
PUT
Turn the AI receptionist on or off
Scope requis : AGENTS_WRITE

Comportement

Met le réceptionniste IA sur la ligne ou l’en retire, et renvoie la configuration complète avec le nouveau statut.
  • ACTIVE : le réceptionniste répond aux appels entrants.
  • FORWARDING : il ne répond pas, et les appels partent vers votre téléphone professionnel.
Cet appel reprogramme le routage d’une ligne en service, avec de vrais appels. Il a volontairement son propre endpoint pour qu’une écriture de configuration ne puisse jamais le déclencher par accident. Configurez entièrement le réceptionniste avant de l’activer, et faites confirmer par une personne avant d’appeler.
Désactiver le réceptionniste renvoie les appels vers le numéro professionnel de votre espace de travail : il faut donc qu’il y en ait un. Ce numéro n’est pas le business_phone du réceptionniste et ne se modifie pas par cette API.

Erreurs

  • 400 AGENT_NO_FORWARDING_NUMBER : FORWARDING a été demandé alors qu’aucun numéro professionnel n’est renseigné sur l’espace de travail. Tant qu’il n’y en a pas, le réceptionniste ne peut rester qu’en ACTIVE.
  • 409 AGENT_LINE_NOT_ASSIGNED : aucun numéro n’est attribué à la ligne, elle ne peut donc ni répondre ni transférer.
  • 404 PHONE_NUMBER_NOT_FOUND : ce numéro n’est pas un numéro auquel vous avez accès.

Autorisations

Authorization
string
header
requis

Paramètres de chemin

number
string
requis

Allo phone number in E.164 format

Exemple:

"+14155551234"

Corps

application/json
status
enum<string>
requis

ACTIVE puts the receptionist on the line. FORWARDING takes it off and sends calls to your business phone.

Options disponibles:
ACTIVE,
FORWARDING

Réponse

The configuration, with the new status

data
object

The whole configuration of one line's AI receptionist.