Passer au contenu principal
GET
List conversations
Scope requis : CONVERSATIONS_READ
Cet endpoint est paginé. Utilisez les paramètres de requête page et size pour contrôler les résultats. Voir Pagination.

Ligne ou boîte de réception

Envoyez exactement un des deux paramètres allo_number ou inbox_id. Envoyer les deux, ou aucun, retourne une erreur 400 avec le code INVALID_REQUEST.
  • allo_number liste les conversations d’une ligne Allo. Une ligne à laquelle l’appelant n’a pas accès retourne une erreur 403 avec le code ALLO_NUMBER_FORBIDDEN.
  • inbox_id liste les conversations d’une de vos boîtes de réception, avec des conversations de plusieurs lignes (chaque ligne de résultat a un seul allo_number). Les sources et filtres enregistrés de la boîte s’appliquent, mais pas les onglets À traiter et Les miennes de l’app. “Non lues uniquement” n’est pas enregistré sur une boîte : passez le paramètre de requête unread. Une boîte qui n’est pas la vôtre retourne une erreur 404 avec le code INBOX_NOT_FOUND.
Chaque conversation a un champ allo_number, la ligne Allo sur laquelle elle se trouve. Utilisez-le pour épingler ou répondre quand vous listez par boîte.

Erreurs liées aux boîtes et aux épingles

Conversations épinglées

Chaque conversation a un champ pinned. Passez pinned=true pour lister seulement les conversations épinglées, ou pinned=false pour les exclure. Épinglez et désépinglez avec Épingler une conversation et Désépingler une conversation.

Notes sur les champs

last_item.duration est la durée totale de l’appel en secondes, sonnerie incluse. last_item.recording_duration est la durée de conversation, celle affichée dans l’application Allo pour les appels enregistrés. Pour les appels sans enregistrement, l’application utilise last_item.duration.

Paramètre extend

Le paramètre de requête extend accepte une liste de champs optionnels séparés par des virgules. Actuellement pris en charge : Passer une valeur non prise en charge renvoie une erreur 400 avec le code UNSUPPORTED_EXTEND_VALUE.

Autorisations

Authorization
string
header
requis

Paramètres de requête

allo_number
string

Filter by Allo number (E.164). Send exactly one of allo_number or inbox_id. List your numbers with GET /v2/api/numbers to find the right one.

Exemple:

"+14155550100"

inbox_id
string

List the conversations of one of your inboxes (inb-*), from all of its lines (each row has its own allo_number). The inbox's sources and saved filters apply, but not the app's Needs action and Mine tabs; pass unread yourself. Send exactly one of allo_number or inbox_id.

Exemple:

"inb-abc123"

last_activity_since
string<date-time>

Only return conversations with activity after this timestamp (ISO 8601). Ideal for incremental sync.

Exemple:

"2026-04-20T10:00:00Z"

unread
boolean
pinned
boolean

Only pinned (true) or only unpinned (false) conversations. Any other value returns 400 INVALID_PARAMETER.

page
integer
défaut:1

Page number (1-indexed)

Plage requise: x >= 1
size
integer
défaut:20

Results per page

Plage requise: 1 <= x <= 100
extend
string

Comma-separated optional fields. Supported: transcript

Exemple:

"transcript"

Réponse

List of conversations

data
object[]
pagination
object