Ajouter une note interne

POST

/api/threads/{key}/notes

• Production

Crée une note interne sur la conversation. Les notes créées par l’API sont sans auteur : elles ne sont pas modifiables depuis l’interface, et restent visibles par votre équipe dans la boîte de réception.

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).

Request Body^required

object

note

required

Contenu de la note.

string

<= 1000 characters

Responses

200

Conversation mise à jour, avec ses notes.

object

thread

object

id

Identifiant de la conversation (le vôtre, ou l’UUID v7 généré).

string

status

string

Allowed values: open processing pending answered closed

requires_action

true tant qu’une action signalée par l’IA (réexpédition, remboursement…) reste à réaliser par votre équipe sur cette conversation. Le détail figure dans required_action de l’enveloppe pending et de l’historique des messages.

boolean

tags

Array

object

id

string format: uuid

name

string

color

One of:

string

L’une des 16 couleurs de la palette de tags.

string

Allowed values: red orange amber yellow lime green emerald teal cyan sky blue indigo violet fuchsia pink rose

null

null

hex

Code couleur CSS (ex. #3b82f6).

string | null

title

string | null

notes

Notes internes, des plus récentes aux plus anciennes.

Array<object>

object

id

string format: uuid

note

string

created_at

string format: date-time

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.

422

Corps de requête invalide (erreurs de validation Laravel).

object

message

string

errors

object

key

additional properties

Array<string>

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