Allo

Obtenir les suggestions de boîtes

Retourne des sources de boîte de réception prêtes à l'emploi pour l'appelant, les meilleures en premier, classées d'après ses appels et SMS récents. Cet…

GET/v2/api/inboxes/suggestions

Comportement

Retourne des sources de boîte de réception prêtes à l'emploi pour l'appelant, les meilleures en premier, classées d'après ses appels et SMS récents. Cet endpoint ne prend pas de user_id : les suggestions sont toujours celles de l'appelant.

Chaque suggestion contient une source. Mettez-la telle quelle dans les sources de Créer une boîte de réception :

  • Une suggestion avec branch: null couvre toute la ligne, et sa source a des conditions vides.
  • Une suggestion avec une branch couvre un chemin du menu téléphonique, et sa source contient une condition MENU_BRANCH pour ce chemin.

Pour mettre plusieurs suggestions d'une même ligne dans une boîte, fusionnez-les en une seule source : concaténez les branches de leurs conditions MENU_BRANCH.

name et description sont des libellés suggérés pour les branches de menu. Une suggestion sur toute la ligne (branch: null) a toujours name et description à null, et ils peuvent aussi valoir null pour une branche quand aucun libellé n'a pu être généré.

Autorisation

Authorizationstring · headerrequis

Api-Key ak_live_…

Réponses

200Suggestions, best first
dataobject[]
9 champs
allo_numberstringrequis
namestring | nullrequis

Suggested inbox name. Always null for a whole-line suggestion (branch: null).

descriptionstring | nullrequis

Always null for a whole-line suggestion (branch: null).

branchobject[]requis

Phone-menu path, or null for the whole line.

2 champs
node_idstringrequis

ID of the phone-menu node in the line's published call flow.

digitstringrequis

Key pressed at that menu.

answeredintegerrequis

Calls the caller answered from this source recently.

rungintegerrequis

Calls that rang the caller from this source recently.

textedintegerrequis

Texts the caller exchanged on this source recently.

scoreintegerrequis

Ranking score. Higher first.

sourceobjectrequis
2 champs
allo_numberstringrequis

Allo line (E.164).

conditionsobject[]requis

Empty means every conversation on the line.

401
403
429