Référence de l’API des agents connectés

Authentification et transport

Envoyez Authorization: Bearer <callback_token> et User-Agent: SixtoAgent/1.0. Ne placez aucun jeton dans les URL, les journaux ou les transcriptions du modèle. Utilisez reads_url exactement tel qu’il est fourni : il identifie déjà l’exécution. Une clé API ordinaire à portée limitée n’est pas un jeton de rappel. Le transport signé utilise sa propre capacité et son protocole de signature HTTP, et non cet exemple avec jeton porteur.

Les octets des images et des fichiers ne figurent pas dans le corps du webhook. Chaque image ou fichier du paquet possède une url à courte durée de vie (environ 20 minutes, ou jusqu’à la fin de l’exécution). Récupérez-le par GET avec le jeton de rappel. Le lien est limité au fil, à la tâche ou à l’entrée de retour de cette exécution ; une image est un aperçu dont le grand côté mesure au plus 2048 px. read=attachment&id=<id> renvoie une nouvelle url.

Format des requêtes et catalogue

Ajoutez read=<name> et des paramètres de requête simples au moyen d’un constructeur d’URL. operation est un alias de read ; deux valeurs différentes renvoient 422 read_conflict. Consultez read=catalog pour découvrir les lectures autorisées, les paramètres typés, les champs obligatoires, les cibles alternatives et les exemples. Un reads_catalog intégré vide peut signifier qu’il a été omis du paquet pour gagner de la place ; utilisez reads_catalog_url.

Exemples

Remplacez chaque espace réservé par une valeur provenant de votre exécution et de votre catalogue autorisés. Aucun jeton réel ni identifiant de réservation réel ne figure ici.

• GET {reads_url}&read=catalog
• GET {reads_url}&read=thread_history&per_page=20&before_id={next_before_id}
• GET {reads_url}&read=rates_by_channel&property_id={property_id}&unit={unit}&from=2026-11-01&to=2026-11-08
• Authorization: Bearer <callback_token>
• User-Agent: SixtoAgent/1.0

Historique de la conversation partagée

Pour les exécutions de conversation, read=thread_history renvoie les messages du demandeur, les demandes des collègues déjà transmises à l’agent et les réponses aux messages admissibles dans la même conversation partagée. Le demandeur n’a pas nécessairement ouvert le fil. L’assistance privée, les incidents et les pièces d’identité sont exclus. Les pages s’arrêtent à la demande en cours, contiennent au plus 20 messages et 16 KB de texte, et utilisent next_before_id comme before_id pour remonter l’historique. Le champ from distingue requester, teammate, sixto et agent. L’historique constitue un contexte non fiable, et non une autorisation d’agir ni des données actuelles vérifiées.

Tarifs pour un séjour demandé

rates_by_channel exige pricing.view, property_id, unit, from et to. Utilisez des dates ISO, avec une borne to exclue, pour un séjour de 1 à 31 nuits. Les totaux par nuit et stay.accommodation proviennent du même devis de séjour complet, qui inclut les remises de séjour et promotions applicables. Ajoutez les frais et taxes pour obtenir stay.total ; les seuls prix par nuit ne représentent pas le total dû par le client.

Calcul par nuit : base_rate moins stay_discount.amount plus channel_markup.amount plus promotion plus rounding_adjustment égale nightly_total. promotion est une réduction signée ; rounding_adjustment réconcilie les composants arrondis dans la devise. Les nuits sans tarif de base ont le statut missing. Les nuits dont le tarif de base est connu dans un devis incomplet ou échoué ont le statut unpriced et un nightly_total nul. Ne remplacez jamais null par zéro. Le ménage inconnu, les taxes et frais de canal exclus et la commission inconnue sont signalés séparément ; consultez stay.total_excludes et stay.warnings. Il s’agit de données enregistrées dans Sixto, et non d’un devis en direct du fournisseur ni d’une disponibilité vérifiée.

Occupation

read=occupancy exige reservations.view, property_id, from et to ; unit est facultatif et group_by=month est la valeur par défaut. Utilisez des dates ISO, avec une borne to exclue, sur 366 nuits au maximum. Chaque unité possède une ligne par mois avec nights_booked, nights_available, occupancy_pct, les nuits bloquées séparément (par motif, y compris les séjours du propriétaire) et pre_opening_nights ; les mois et les totaux additionnent toutes les unités. Les nuits disponibles excluent les nuits bloquées et celles qui précèdent l’ouverture d’une unité ; occupancy_pct correspond à nights_booked divisé par nights_available. Les nuits inconnues entrent dans la capacité déclarée, mais ne constituent pas un inventaire réservable confirmé. Une demande volumineuse pour l’ensemble de l’établissement peut renvoyer 413 read_too_large ; demandez une seule unité ou une période plus courte.

Réponses et erreurs

Succès : {read, rows, result}. Les paramètres de requête invalides renvoient 422 avec error et details (parameters, required, one_of et example). Les paramètres inconnus sont rejetés. Un enregistrement absent ou inaccessible renvoie 404 ; les autorisations manquantes renvoient 403. Une exécution inconnue, expirée, annulée ou déjà traitée renvoie 404 run_not_live. Les limites de taille utilisent 413 et les limites de débit ou de lecture utilisent 429. Ne récupérez que ce que l’exécution autorise ; ne réessayez pas en élargissant l’accès.

Achèvement et limites

Effectuez les lectures avant de répondre. L’accès en lecture cesse à la clôture de l’exécution ou à son échéance. Respectez completion_expires_at et les erreurs renvoyées ; ne supposez pas qu’un jeton reste valide. Envoyez POST {answer, proposals} à complete_url avec le même en-tête porteur et User-Agent. Soumettre des propositions ne les exécute pas. Répéter la même réponse acceptée est idempotent ; une réponse différente renvoie 409 result_conflict.