Documentation d'Inngame

Ajoutez un chat de support à votre jeu, répondez aux joueurs depuis votre inbox, Telegram ou Discord, et laissez des agents IA vous aider par l'API.

Démarrage UnityInstaller le paquet, renseigner la clé de l'app, ouvrir le chat. Environ 15 minutes. SDK iOSPaquet Swift pour les apps SwiftUI et UIKit (iOS 16+). SDK webUne balise script pour les jeux HTML5 et les apps web. Identité des joueursJoueurs anonymes, JWT signés et tickets Steam. Agents, MCP et CLILe support piloté depuis Claude Code, Cursor ou Codex. API REST et webhooksRoutes, droits des clés, événements signés. IntégrationsTelegram, Discord, Steam, GitHub, paiements, push, abonnements, webhooks.

Mise en place en cinq étapes

Créez votre compte. Connectez-vous sur app.inngame.app avec Google, GitHub ou un lien par e-mail. Vous obtenez une organisation et 14 jours d'essai.
Créez une app par jeu (ou par plateforme, si vous préférez des inbox séparées). Chaque app a une clé d'app publique (app_…) et un secret d'identité privé.
Installez le SDK dans votre jeu : Unity pour les jeux, Swift pour les apps iOS, une balise script pour les jeux web. Ou collez la sortie de npx inngame init unity dans votre agent de code (installation en un prompt).
Choisissez où l'équipe répond : l'inbox web marche tout de suite ; branchez Telegram ou Discord si vous le souhaitez.
Décidez du rôle de l'IA (Réglages → Apps → votre app → IA) : désactivée, brouillons ou réponses seule. Importez d'abord votre FAQ pour qu'elle ait de quoi répondre.

Notions

Notion	Ce que c'est
Organisation	Votre studio. Elle regroupe les membres (Admin ou Membre), les apps, les clés d'API, les webhooks et l'abonnement.
App	Un jeu ou une app. Elle a ses propres réglages : apparence, mode de l'IA, traduction, modération, FAQ, intégrations.
Joueur	Une personne qui joue à votre jeu (« end user » dans l'API). Anonyme au départ sur un appareil, il peut être identifié pour que son historique le suive d'un appareil à l'autre.
Conversation	Le fil entre un joueur et votre équipe. Un fil ouvert par joueur et par app ; on peut le fermer, le mettre en attente, le rouvrir, l'étiqueter et l'assigner.
Message	Du joueur, de l'équipe, de l'IA, ou note interne (jamais montrée au joueur). Il porte ses traductions, ses pièces jointes, une carte éventuelle et, pour les messages du joueur, le contexte du jeu.
Carte	Un message interactif : demande d'avis, offre, lien, écran du jeu, objet à récupérer, feuille de remboursement Apple, restauration des achats, note de satisfaction.

Clés et secrets

Clé	Forme	Où la mettre
Clé d'app	`app_…`	Dans le build du jeu. Publique : elle permet seulement à un appareil d'ouvrir un chat pour cette app.
Secret d'identité	chaîne aléatoire	Sur le serveur du jeu uniquement. Il signe les JWT qui vérifient les joueurs. Renouvelable depuis les réglages de l'app.
Clé d'API	`ig_sk_…`	Pour les agents, les scripts, la CLI et le MCP. Droits `read`, `reply` ou `all`. Affichée une seule fois. Détails.
Secret de webhook	`whsec_…`	Sur le serveur qui reçoit les webhooks, pour vérifier les signatures.

Adresse de base

Le service hébergé répond sur :

https://app.inngame.app

L'API REST est sous /v1, les routes du SDK sous /v1/sdk et le serveur MCP sur /mcp. Les SDK et la CLI utilisent cette adresse par défaut ; vous pouvez la changer (InngameOptions.BaseUrl dans Unity, baseURL: en Swift, baseUrl dans le SDK web, INNGAME_URL pour la CLI).

L'ancienne adresse, https://inngame.meffysto.workers.dev, reste servie pour l'API, les routes du SDK, le temps réel, les webhooks et le serveur MCP : les jeux et intégrations qui l'utilisent n'ont rien à changer. Les SDK 0.2.1 et antérieurs l'utilisent encore par défaut ; à partir de 0.2.2, c'est https://app.inngame.app.