API Numéros de téléphone

UUID du numéro de téléphone.

Libellé mis à jour (max 255 caractères, texte brut).

Nouvel UUID d'agent, ou null pour désassigner. Sur les numéros Twilio, cela reconfigure (ou délie) l'URL de voix.

Objet de règles de routage pour remplacer les règles actuelles, ou null pour effacer.

Réservé aux opérateurs gérés par le support. Sans effet sur les numéros Twilio.

Numéros SIP uniquement. Rattache le numéro à un autre de vos trunks SIP : les appels sortants depuis ce numéro passent par le nouveau trunk dès l'appel suivant. L'opérateur n'est pas contacté et le trunk lui-même n'est pas modifié. Le trunk doit être actif ; ne peut pas être null. Renvoie 422 sur un numéro Twilio. C'est le lien de trunk sortant du numéro ; il n'est consulté comme solution de secours entrante que si le trunk est de type entrant, donc le pointer vers un trunk uniquement sortant (le cas normal pour les numéros configurés via l'intégration de trunk SIP) est attendu.

Autorise ce numéro à envoyer des messages texte : liens de réservation et messages envoyés par vos agents pendant un appel. Plusieurs de vos numéros peuvent envoyer — chaque agent écrit depuis celui qui lui est désigné (sms_sender_number_id), de sorte qu'une ligne commerciale et une ligne support envoient chacune sous sa propre identité. Le numéro doit être actif et rattaché à votre propre compte Twilio ; Twilio est interrogé pour savoir s'il peut envoyer des SMS, et une ligne voix-seule est refusée. C'est ainsi qu'un client Twilio active l'envoi de SMS : il n'y a aucun compte de messagerie à relier. Le désactiver sur votre expéditeur par défaut est refusé tel quel — envoyez sms_sender_default: false avec, ou désignez d'abord un autre numéro par défaut. Les messages eux-mêmes s'écrivent dans Messages texte.

Désigne ce numéro comme celui qu'un agent utilise lorsqu'aucun numéro ne lui a été attribué. Vous n'en avez qu'un, donc l'activer ici le déplace depuis le numéro qui le portait — aucune fenêtre pendant laquelle rien n'enverrait. Le numéro doit aussi pouvoir envoyer (sms_sender), déjà ou dans la même requête : un défaut incapable d'envoyer est un repli qui ne mène à rien.

Laisse ce numéro recevoir les messages texte qu'on lui envoie. Qu'il y réponde ou non dépend de l'agent qui lui est lié : avec un agent, celui-ci répond ; sans agent, le message est enregistré et rien n'est envoyé, ce que veut un numéro qui ne sert qu'à collecter des réponses. Refusé si le numéro n'est pas actif, s'il est sur un compte Twilio partagé, si l'opérateur indique qu'il ne peut pas porter de textos, ou s'il est rattaché à une TwiML App pour la messagerie. Le webhook de l'app prend le dessus sur celui du numéro, et les textos ne nous atteindraient jamais. Un cas que nous ne pouvons pas voir : un numéro appartenant à un Twilio Messaging Service voit aussi le webhook de ce service l'emporter, et cela n'est pas lisible depuis le numéro. Détachez-le vous-même avant d'activer. Le routage des appels n'est pas touché : un numéro dont les appels passent déjà par un trunk SIP élastique ou une TwiML App voix continue de les y envoyer, et peut malgré tout recevoir des textos. Si un tel numéro porte encore une URL d'appel que nous avions inscrite avant le déplacement de ses appels, nous l'effaçons — jamais une URL qui ne nous appartient pas — de sorte qu'après avoir détaché le trunk ou l'app, il faut réaffecter l'agent du numéro pour que ses appels nous reviennent — renvoyer l'agent déjà en place suffit.

Désigne ce numéro comme expéditeur alors qu'il ne répond pas aux textos, en connaissance de cause. Sans ce champ, la demande est refusée : un destinataire écrit depuis une ligne muette ne peut pas répondre, et son STOP n'atteint personne. Le refus n'est pas absolu parce que deux configurations légitimes ne peuvent pas répondre — un numéro américain dans un Messaging Service, dont le webhook du service l'emporte, et une ligne Twilio qu'un client SIP détient uniquement pour envoyer. Ignoré si le numéro répond déjà. La date à laquelle vous l'avez donné est conservée dans replies_acknowledged_at, et effacée dès que la ligne répond ou cesse d'envoyer.

Shortcodes Africa's Talking uniquement : déplace le shortcode vers un autre de vos comptes de messagerie actifs, par exemple après une rotation de clé API (qui lie un nouveau compte). Validé comme une activation ; tant que sms_inbound est actif, le nouveau compte doit déjà avoir une URL de callback entrant.