Référence de l’API

Messages

Les messages appartiennent à une conversation. Ils sont rédigés par le visiteur (contact), l’assistant (bot), un membre de l’équipe (agent) ou Yuno Chat (system, par exemple « Léa a rejoint la conversation »).

Points de terminaison

GET/conversations/{id}/messages
POST/conversations/{id}/messages
GET/messages/{id}

L’objet message

Attributs

idstring
Identifiant unique, préfixé par msg_.
objectstring
Toujours message.
conversation_idstring
La conversation à laquelle appartient ce message.
authorobject
L’auteur du message.
- typeenum
  Le type d’auteur.
  contactbotagentsystem
- idstring | null
  Identifiant du contact ou du membre de l’équipe. Null pour bot et system.
- namestring | null
  Nom affiché.
bodystring
Le texte du message. Les liens Markdown sont autorisés.
attachmentsarray
Les fichiers joints au message.
- urlstring
  Une URL de téléchargement signée, valable une heure.
- namestring
  Nom d’origine du fichier.
- sizeinteger
  Taille en octets.
sourcesarray
Pour les réponses de l’assistant : les pages utilisées pour formuler la réponse.
- titlestring
  Titre de la page.
- urlstring
  URL de la page.
created_atstring
Date de création de l’objet, au format ISO 8601 en UTC.

Objet message

{
  "id": "msg_2Wd7nPq1",
  "object": "message",
  "conversation_id": "conv_8HqL2v9K",
  "author": {
    "type": "agent",
    "id": "usr_team_lea",
    "name": "Léa"
  },
  "body": "C’est fait ! La commande sera livrée à l’adresse de votre bureau.",
  "attachments": [],
  "sources": [],
  "created_at": "2026-10-03T09:14:02Z"
}

Lister les messages

GET/conversations/{id}/messages

Renvoie les messages d’une conversation, du plus ancien au plus récent.

Paramètres de chemin

idstringobligatoire
L’identifiant de la conversation.

Paramètres de requête

limitinteger
Nombre d’objets à renvoyer, entre 1 et 100. Valeur par défaut : 20.
cursorstring
Le next_cursor d’une page précédente. Omettez-le pour commencer par l’objet le plus récent.

Requête

curl -G https://api.yuno.chat/v1/conversations/conv_8HqL2v9K/messages \
  -H "Authorization: Bearer $YUNO_SECRET_KEY" \
  -d limit=50

Réponse · 200

{
  "object": "list",
  "data": [
    {
      "id": "msg_2Wd7nPq1",
      "object": "message",
      "conversation_id": "conv_8HqL2v9K",
      "author": {
        "type": "agent",
        "id": "usr_team_lea",
        "name": "Léa"
      },
      "body": "C’est fait ! La commande sera livrée à l’adresse de votre bureau.",
      "attachments": [],
      "sources": [],
      "created_at": "2026-10-03T09:14:02Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Envoyer un message

POST/conversations/{id}/messages

Envoie un message au visiteur au nom d’un membre de l’équipe. Si la conversation était à waiting, elle passe à handed_off.

Paramètres de chemin

idstringobligatoire
L’identifiant de la conversation.

Paramètres du corps

bodystringobligatoire
Le texte du message, limité à 4 000 caractères.
author_idstringobligatoire
Le membre de l’équipe qui l’envoie.
attachmentsarray
Jusqu’à 5 fichiers, chacun fourni sous forme d’une URL publique depuis laquelle Yuno Chat le téléchargera.
- urlstringobligatoire
  URL HTTPS du fichier.
- namestring
  Nom du fichier à afficher.

Requête

curl -X POST https://api.yuno.chat/v1/conversations/conv_8HqL2v9K/messages \
  -H "Authorization: Bearer $YUNO_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "C’est fait ! La commande sera livrée à l’adresse de votre bureau.",
    "author_id": "usr_team_lea"
  }'

Réponse · 201

{
  "id": "msg_2Wd7nPq1",
  "object": "message",
  "conversation_id": "conv_8HqL2v9K",
  "author": {
    "type": "agent",
    "id": "usr_team_lea",
    "name": "Léa"
  },
  "body": "C’est fait ! La commande sera livrée à l’adresse de votre bureau.",
  "attachments": [],
  "sources": [],
  "created_at": "2026-10-03T09:14:02Z"
}

Récupérer un message

GET/messages/{id}

Renvoie un seul message.

Paramètres de chemin

idstringobligatoire
L’identifiant du message.

Requête

curl https://api.yuno.chat/v1/messages/msg_2Wd7nPq1 \
  -H "Authorization: Bearer $YUNO_SECRET_KEY"

Réponse · 200

{
  "id": "msg_2Wd7nPq1",
  "object": "message",
  "conversation_id": "conv_8HqL2v9K",
  "author": {
    "type": "agent",
    "id": "usr_team_lea",
    "name": "Léa"
  },
  "body": "C’est fait ! La commande sera livrée à l’adresse de votre bureau.",
  "attachments": [],
  "sources": [],
  "created_at": "2026-10-03T09:14:02Z"
}