API Soutien

Réception JSON anonyme de même origine pour le formulaire de contact du site. Exige l’en-tête Origin du site et une clé Idempotency-Key de 20 à 128 lettres, chiffres, traits d’union ou traits de soulignement. Ne crée aucun compte ni aucune session. Enregistre le message et le courriel de réponse avant d’en accuser réception; le service d’assistance les transmet au canal Slack d’assistance configuré.

Le courriel fourni par le visiteur est une coordonnée, jamais une preuve d’identité. Les nouvelles tentatives identiques reçoivent le même accusé de réception sans nouvelle livraison; un corps modifié avec la même clé entraîne idempotency_mismatch.

Au maximum 10 nouveaux messages par adresse IP cliente par heure (IPv6 regroupées par /64), 3 par courriel par jour et 200 au total par heure; toutes les requêtes partagent une limite de 120 par IP par minute. Retry-After fait autorité. Les messages restent en attente en cas d’échec de livraison; les enregistrements livrés expirent après 30 jours.

Disponibilité et heures pour tout projet actif. chat_allowed est vrai pour chaque projet actif, y compris Standard. human_available est vrai lorsqu’une personne peut se joindre au clavardage sur demande (Education, Premium et Enterprise) ; Standard et Plus ont la documentation et l’assistance par IA. staffed indique si le personnel est dans ses heures en ce moment. Luna répond tout de suite sur tous les forfaits.

Conversations du projet, les plus récentes en premier, au maximum 100. Les comptes de non-lus du personnel sont par personne ou agent authentifié.

Disponible sur tous les forfaits ; Luna répond en premier, tout de suite. Là où une personne peut se joindre (human_available dans l’état du soutien), une demande en ce sens met Luna en pause pour le personnel ; sur Standard et Plus, elle est ignorée et Luna répond. Contrôlé avant stockage ou Slack.

Un message d’ouverture de moins de 8 caractères ou 3 mots retourne submission_too_short ; un message qui n’est pas une question ou un problème retourne submission_unclear ; spam, texte avec trop de liens, injection de prompt et texte non sécurisé retournent submission_rejected. Le texte rejeté n’est ni conservé ni envoyé à Luna, et le détail du problème ne le répète jamais.

Le texte en forme d’identifiants autre que les identifiants ScreenRig (jetons porteurs, clés cloud et API, clés privées) est remplacé par [caviardé] avant stockage ; le matériel d’identifiants ScreenRig renvoie invalid_request. Une nouvelle conversation démarre un fil Slack ; les suivis restent dans ce fil. Les requêtes avec la même clé rejouent pendant 24 heures, refus inclus.

Messages dans la conversation du projet, séquence ascendante, au maximum 100. Continuer après la dernière séquence de message pour la pagination des conversations plus anciennes. La lecture ne reconnaît pas l’état non lu du personnel.

Ajoute un message client à une conversation ouverte. Un suivi n’a pas de longueur minimale et n’est jamais refusé comme peu clair seul (« merci », « oui ») ; il est filtré pour la sécurité, l’injection d’invite et le spam de liens, refusé avec submission_rejected, et le texte en forme d’identifiants est traité comme pour une nouvelle conversation.

Le texte rejeté n’est pas conservé, et un refus est rejoué sous la même clé pendant 24 heures.

Reconnaissance monotone des messages par séquence pour ce lecteur. Impossible de reconnaître au-delà de la conversation last_sequence.

Terminer cette conversation de projet et annuler les réponses IA en attente. Répétable ; conserve l’historique. Le personnel peut la rouvrir dans Slack.

Messages d’assistance du projet sur tous les forfaits sous forme de SSE reprenables. event est support.message ; id est la séquence d’assistance du projet, data est SupportMessage. after a priorité sur Last-Event-ID. Le curseur 0 rejoue l’historique. Les messages du personnel, du client et de l’IA sont distingués par rôle. Les flux revalident les identifiants et l’accès actif au projet.

Aucune capture d’écran ni donnée d’identification n’est envoyée.