> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taliuphq.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Connecteur IA Catalog Builder
> Reliez Taliup HQ à votre assistant IA pour transformer une photo de menu, un PDF ou un chiffrier non standard en ébauche de catalogue révisable.
Le **connecteur IA** vous permet de remettre le menu d'un marchand à votre propre assistant IA — photo, PDF, capture d'écran ou chiffrier de n'importe quelle forme — et de lui faire construire une ébauche de catalogue Taliup. L'ébauche aboutit dans [Catalog Builder](/fr-CA/taliup-hq/admin/catalog-builder) dans Taliup HQ, où vous la révisez et la publiez comme d'habitude.
C'est la réponse au marchand qui vous envoie la photo d'un menu imprimé.
## Comment ça fonctionne
Votre assistant IA fait la lecture. Taliup HQ fait l'écriture.
Le fichier reste dans votre assistant. Il n'est jamais téléversé vers Taliup.
Il récupère le format de catalogue ainsi que les catalogues, attributs, taxes et étiquettes existants du marchand afin de les réutiliser au lieu de créer des doublons.
Il envoie des données structurées à Taliup HQ et reçoit un lien de révision, ainsi que tout ce qui a échoué à la validation pour pouvoir se corriger.
Exactement comme pour une construction par chiffrier.
Le connecteur peut lire les données de catalogue d'un marchand et déposer des ébauches. Il **ne peut pas** publier, annuler ni supprimer quoi que ce soit. Toute modification d'un catalogue actif passe par l'écran de révision dans Taliup HQ, par une personne.
## Ce que ça coûte
Rien du côté de Taliup. La lecture est faite par votre propre assistant IA, sur votre propre abonnement. Il vous faut donc un forfait qui prend en charge les connecteurs personnalisés.
## Connecter votre assistant
Il vous faut l'URL du connecteur, affichée dans l'onglet **Catalog Builder** de n'importe quel marchand. C'est la même URL pour tous les marchands — vous choisissez le marchand dans la conversation, pas dans le connecteur.
Ouvrez l'onglet **Catalog Builder** d'un marchand et cliquez sur **Copy** sur la carte du connecteur.
Dans Claude, allez à **Settings** → **Connectors** → **Add custom connector**, et collez l'URL.
Claude vous envoie vers une page de connexion Taliup HQ. Connectez-vous avec votre compte Taliup HQ habituel, vérifiez ce que le connecteur a le droit de faire, puis cliquez sur **Authorize**.
Le connecteur Taliup HQ Catalog Builder apparaît maintenant dans votre liste de connecteurs et ses outils sont disponibles en conversation.
Sur les forfaits Team et Enterprise, seul un propriétaire peut ajouter un connecteur pour l'organisation, sous **Organization settings** → **Connectors**. Une fois ajouté, chaque membre l'autorise individuellement avec son propre compte Taliup HQ.
Le connecteur vous autorise **vous**, pas votre organisation. Il ne voit que les marchands que vous pouviez déjà ouvrir dans Taliup HQ et hérite de votre portée ISO. Un compte non administrateur qui l'autorise n'obtient aucun outil.
## Construire un menu
Joignez le menu du marchand à une nouvelle conversation et demandez ce que vous voulez. Par exemple :
```text theme={null}
Build a Taliup menu for Bistro Lafayette from the attached PDF.
```
Nommez le marchand dans le message — c'est ainsi que l'assistant sait pour quel compte construire. La carte du connecteur dans Taliup HQ affiche une phrase toute faite contenant déjà le nom du marchand : vous pouvez la copier depuis la fiche que vous consultez.
Une invite enregistrée nommée **Build menu from source** est disponible dans la liste d'invites de votre assistant. Elle guide l'assistant à travers toute la séquence et constitue la façon la plus fiable de commencer.
L'assistant nomme le marchand qu'il a retenu, ou vous demande lequel si plusieurs correspondent. À la fin, il répond avec un lien de révision et un sommaire de ce qu'il a déposé.
### Obtenir une bonne ébauche
Dites d'emblée ce que vous voulez. « Only pages 1 and 2 », « this is the brunch menu », « add it to the existing Dinner Menu catalog » et « taxes are already set up, don't create any » fonctionnent tous et vous évitent un aller-retour de correction.
L'assistant reçoit la consigne de convertir les menus comme Taliup s'y attend :
| Dans le menu | Dans Taliup |
| -------------------------------------------------- | -------------------------------------------------------- |
| Le menu lui-même | Un catalogue |
| Une section ou un titre | Une catégorie, dans l'ordre imprimé |
| Un article | Un produit |
| « Choose your size », suppléments, accompagnements | Un attribut avec des valeurs |
| Un article au prix selon le format | Un prix de base plus un attribut Size portant les écarts |
| « Market price » ou un prix vide | Un article à prix personnalisé |
| Un service minuté, comme un massage de 60 minutes | Un service avec une durée |
Il lui est demandé de ne pas inventer d'articles ni de prix, de ne pas traduire les noms, et de signaler ce qui est ambigu plutôt que de deviner. Ces notes apparaissent en haut de l'écran de révision.
### Construire à partir du site web du marchand
Si le marchand publie son menu sur son propre site, vous pouvez diriger l'assistant vers la page plutôt que de courir après une photo :
```text theme={null}
Build a Taliup menu for Bistro Lafayette from https://bistrolafayette.example/menu
```
L'assistant récupère la page via Taliup, qui en renvoie le texte lisible, et construit l'ébauche à partir de là. Rien de la page n'atteint le catalogue du marchand tant que vous n'avez pas publié.
Taliup ne récupère une page que si toutes ces conditions sont réunies :
| Règle | Détail |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `https` uniquement | Le `http` simple est refusé |
| Une adresse publique | Les adresses internes, de bouclage et de réseau privé sont refusées, et chaque redirection est revérifiée |
| Un domaine autorisé | Le domaine doit être ajouté par qui exploite Taliup HQ. Un domaine couvre ses sous-domaines, avec correspondance sur la limite du point : un sosie comme `exemple.com.evil.test` est donc refusé |
| Une page web | Un menu publié en PDF ou en image est refusé — joignez-le plutôt à la conversation |
N'utilisez pas une fiche de plateforme de livraison — Uber Eats, DoorDash, SkipTheDishes. Ces prix sont majorés pour couvrir la commission de la plateforme : un catalogue bâti là-dessus surfacture les clients au comptoir et au PDV du marchand. Ces domaines ne sont pas autorisés, et ne devraient pas l'être.
Beaucoup de sites de restaurants affichent leur menu en JavaScript, et certains le publient en image. Taliup signale qu'une page récupérée ne contient presque aucun prix, et l'assistant a pour consigne de le dire plutôt que d'inventer des articles. Le cas échéant, envoyez plutôt une capture d'écran ou le PDF.
#### Photos des articles
Une page récupérée renvoie aussi les photos qu'elle contient, placées à côté de l'article auquel elles appartiennent, pour que l'assistant associe la bonne image au bon plat.
Deux traitements sont appliqués automatiquement :
* **Les éléments décoratifs sont écartés** — logos, boutons de réseaux sociaux, flèches, pixels de suivi, et tout ce que la page déclare elle-même sous 60 pixels.
* **Les vignettes sont remplacées par une copie à la bonne taille.** Les créateurs de sites servent la photo à la taille affichée sur leur page, souvent 150 pixels de côté, ce qui est trop petit pour une tuile de PDV. Taliup demande plutôt une copie d'au plus 1 200 pixels de large, et réduit après téléchargement tout ce qui dépasse encore. Les fichiers d'origine font souvent plusieurs mégaoctets, et chaque caisse les paie à chaque chargement du catalogue.
Les images sont téléchargées et réhébergées sur le stockage de Taliup à la publication : le catalogue du marchand ne dépend donc pas du maintien en ligne de son ancien site. Rien dans le catalogue ne pointe jamais vers le site du marchand ni vers son CDN.
L'assistant ne doit utiliser que les URL d'images renvoyées par la récupération. Une adresse construite ou devinée ne peut pas être téléchargée, et le sommaire de publication le signalera. Si vous avez demandé les images et n'en avez obtenu aucune, c'est que la page n'en contenait aucune de lisible : demandez plutôt une capture d'écran que de le laisser improviser.
Certains sites servent leurs photos parfaitement à votre navigateur et refusent les serveurs de Taliup — Wix en fait partie. Taliup le vérifie avant la publication et vous le dit, plutôt que d'échouer quarante téléchargements après coup. Le cas échéant, ajoutez les photos dans l'écran de révision avec **Upload a file instead** : votre navigateur récupère ce que le serveur ne peut pas, et la photo aboutit exactement au même endroit. Voir [Photos des articles](/fr-CA/taliup-hq/admin/catalog-builder) sur la page Catalog Builder.
### Corriger une ébauche déposée
Si la validation signale des problèmes, l'assistant peut les corriger et redéposer sans votre intervention. Vous pouvez aussi lui demander de changer quelque chose après coup — « make all the salads tax exempt », « the wine list should be its own catalog » — tant que vous n'avez pas lancé la publication.
Si vous modifiez l'ébauche dans Taliup HQ en même temps, celui qui enregistre en second est averti que l'ébauche a changé et doit recharger. Terminez à un endroit avant de passer à l'autre.
## Sécurité
| Enjeu | Traitement |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Connexion | OAuth. Votre assistant ne voit jamais votre mot de passe Taliup HQ, et vous pouvez révoquer l'accès en tout temps |
| Portée | Le connecteur ne voit que les marchands de votre portée ISO, et seulement ceux ayant la fonction Catalog |
| Écritures | Aucun outil ne peut publier, annuler ou supprimer. Au maximum, il dépose une ébauche à réviser |
| Fichiers du marchand | Les pièces jointes restent dans votre assistant IA. Seule l'ébauche structurée atteint Taliup |
| Contenu des menus | Le texte d'un menu téléversé, ou d'une page récupérée, est traité comme des données. Les instructions cachées dans un document ou une page web sont ignorées |
| Récupération de pages web | `https` seulement, adresses publiques seulement, domaines autorisés seulement, revérifiés à chaque redirection, avec une réponse plafonnée en taille |
| Taille | Les ébauches surdimensionnées sont refusées, afin qu'une mauvaise extraction ne puisse pas inonder un catalogue |
## Dépannage
Le connecteur est désactivé dans cet environnement. Voir la section de configuration de la page [Catalog Builder](/fr-CA/taliup-hq/admin/catalog-builder).
Le compte utilisé pour autoriser n'a pas accès à l'administration Taliup HQ. Déconnectez le connecteur et reconnectez-vous avec votre compte administrateur.
Il ne voit que les marchands de votre portée ISO ayant la fonction Catalog activée. Vérifiez les deux sur la fiche **Entities** du marchand, puis demandez à l'assistant de lister les marchands qu'il voit.
Le domaine n'est pas sur la liste d'autorisation, ou aucun domaine n'y figure. Le message de l'assistant nomme l'hôte refusé. Demandez à qui exploite Taliup HQ de l'ajouter à `MENU_FETCH_ALLOWED_DOMAINS`. En attendant, collez le texte du menu dans la conversation ou joignez une capture d'écran.
Le menu est probablement dessiné en JavaScript, ou publié en PDF ou en image : il n'y a donc aucun texte à lire sur la page. Joignez plutôt le PDF ou une capture d'écran.
Consultez le sommaire de publication : il compte les photos séparément et en donne la raison. La plus courante est que le site qui héberge les images refuse les requêtes des serveurs de Taliup, même si elles s'affichent dans votre navigateur. Ajoutez ces photos dans l'écran de révision avec **Upload a file instead**.
Les menus longs ou peu contrastés peuvent être lus partiellement. Demandez à l'assistant quelles pages il a utilisées, puis faites-lui redéposer la section manquante. Une photo nette d'une page vaut mieux qu'une photo floue de six.
## Voir aussi
* [Catalog Builder](/fr-CA/taliup-hq/admin/catalog-builder)
* [Bulk Import](/fr-CA/taliup-hq/merchant/catalogs/bulk-import)
* [Entités](/fr-CA/taliup-hq/admin/entities)