Lister les messages d'une conversation

GET

/api/threads/{key}/messages

• Production

Historique complet, du plus récent au plus ancien, avec l’enveloppe de pagination standard. Les messages entrants et sortants partagent la même forme — direction les distingue. subject n’apparaît que si les titres sont activés sur l’agent, attachments que si les pièces jointes le sont.

Authorizations

• apiKey

Parameters

Path Parameters

key

required

string

Identifiant de la conversation : la valeur passée via X-Assilya-Thread, ou l’UUID v7 généré (champ thread.id).

Query Parameters

page

integer

default: 1 >= 1

per_page

integer

default: 100 >= 1 <= 200

100 par défaut, plafonné à 200.

Responses

200

Messages paginés.

object

data

Array<object>

object

id

Identifiant du message (le vôtre, ou l’UUID v7 généré).

string

direction

string

Allowed values: inbound outbound

status

string

Allowed values: draft queued published sent failed

content

string | null

confidence

Pourcentage 0–100 — messages sortants générés par l’IA uniquement.

integer | null

source

Origine d’un message sortant : ai (réponse automatique), suggestion_selected / suggestion_edited / human (via POST …/answer), preset (scénario), agent (autres canaux).

string | null

Allowed values: agent ai suggestion_selected suggestion_edited human preset

sender

{type: "contact", name, email, phone} pour un message entrant, {type: "agent", name} pour un sortant.

object

type

string

Allowed values: contact agent

name

string | null

email

string | null

phone

string | null

required_action

Sur un message entrant : action opérationnelle signalée par l’IA (réexpédition, remboursement…). processed_at est renseigné dès qu’un opérateur a répondu ou clôturé la conversation. null sur tous les autres messages.

object

summary

string | null

processed_at

string | null format: date-time

subject

Présent uniquement si les titres sont activés sur l’agent.

string | null

attachments

Présent uniquement si les pièces jointes sont activées sur l’agent.

Array<object>

object

id

string format: uuid

filename

string

mime

string

size

Taille en octets.

integer

url

URL présignée de téléchargement, valable 15 minutes.

string

error_message

Renseigné uniquement quand status vaut failed.

string | null

sent_at

string | null format: date-time

meta

object

current_page

integer

per_page

integer

total

integer

last_page

integer

links

object

first

string | null

last

string | null

prev

string | null

next

string | null

401

Clé API absente ou en-tête Authorization mal formé.

object

error

Message d’erreur lisible, dans la langue de l’agent.

string

404

Ressource inconnue pour cet agent.

429

Limites de débit dépassées. Plafonds appliqués simultanément : 30/min par conversation, 200/min par agent, 120/min par IP et 1 000/min par espace (valeur par défaut).

object

error

Message d’erreur lisible, dans la langue de l’agent.

string