# Permettre aux visiteurs de chercher dans votre boutique par photo

> Un visiteur envoie une photo et votre agent intoCHAT affiche des produits similaires de votre boutique connectée sous forme de fiches produits : comment l'activer, ce que voient les visiteurs, limites par offre et confidentialité.

Avec **Search by photo**, un visiteur peut envoyer une photo et demander « Vous avez quelque chose comme ça ? ». L'agent regarde la photo, cherche dans votre [boutique connectée](/fr/docs/connect-your-store) et affiche les produits les plus proches sous forme de fiches produits sous sa réponse, avec les noms, les prix, les images et les liens de votre propre boutique.

## Ce qu'il vous faut

- Une boutique connectée avec une recherche de produits. Connectez-la avec **Connect your website** dans l'onglet **Actions** ; voir [Connecter votre boutique](/fr/docs/connect-your-store). Shopify, WooCommerce, Magento, VTEX, les sites WordPress avec un type de contenu catalogue et les autres sites web dotés d'une page de recherche fonctionnent tous. Un site connecté uniquement avec **Browse products** n'a pas de recherche, et les articles et pages d'un blog ne constituent pas un catalogue : aucun des deux ne peut donc être exploré par photo.
- **Let visitors attach files** activé, dans l'onglet [Appearance](/fr/docs/appearance#pieces-jointes-des-visiteurs). Les visiteurs envoient les photos avec le trombone : sans lui, personne ne peut en envoyer.
- L'offre Starter ou supérieure. Avec l'offre Free, la carte affiche **Included from the Starter plan** et l'interrupteur est grisé.

## L'activer ou le désactiver

1. Ouvrez votre agent et allez dans l'onglet **Actions**. La carte **Search by photo** apparaît sous vos actions dès qu'une boutique est connectée.
2. L'interrupteur est activé par défaut à partir de Starter. Désactivez-le si vous ne voulez pas que l'agent cherche dans votre boutique à partir de photos. Le réglage est enregistré dès que vous le basculez.
3. Essayez-le dans le **Playground** : joignez la photo d'un article que vous vendez et demandez si vous l'avez.

La carte vous rappelle aussi quand les pièces jointes des visiteurs sont désactivées, et affiche les limites de votre offre et, tant que la recherche par photo fonctionne, le nombre de recherches effectuées par l'agent aujourd'hui.

Les modifications de l'interrupteur sont conservées dans l'[historique des réglages](/fr/docs/settings-history).

## Ce qui se passe quand un visiteur envoie une photo

1. L'agent décide si le visiteur veut cet article ou quelque chose de semblable. Il a pour consigne de ne pas traiter ainsi la photo d'une livraison endommagée ou une question sur une commande. C'est le modèle d'IA qui en décide : il peut donc arriver qu'il lance une recherche là où vous ne l'auriez pas fait, ou qu'il demande ce que le visiteur veut dire.
2. La photo est décrite par le modèle d'IA : le type de produit, ses couleurs principales, sa matière, son style, toute marque imprimée dessus, et trois courtes expressions de recherche. Si le visiteur a précisé de quel article il parle, comme « la lampe à gauche », la description porte sur cet article.
3. La recherche de votre propre boutique est lancée avec ces expressions et le type de produit, jusqu'à quatre recherches.
4. Chaque produit renvoyé est comparé à la description : son titre, son type de produit, ses étiquettes, sa marque et sa description. Les produits qui ne correspondent pas assez bien sont écartés, même quand la recherche de votre boutique les a renvoyés.
5. Jusqu'à 6 produits apparaissent sous forme de fiches sous la réponse, la meilleure correspondance en premier, avec un titre comme « 3 produits semblables à votre photo » dans la langue du widget. L'agent les présente brièvement dans sa réponse. Si la réponse nomme aussi d'autres produits de votre boutique, ils suivent les correspondances de la photo, et le nombre habituel de produits remplace le titre.

Si rien dans votre boutique ne correspond, l'agent le dit clairement. Il suggère des noms de catégories trouvés dans les résultats de votre boutique, s'il y en a, ou demande au visiteur de décrire ce qu'il cherche. Il ne nomme pas de produits qu'il n'a pas trouvés.

Seule une photo envoyée avec le message en cours est utilisée pour la recherche, la première si le message en contient plusieurs. Les photos des messages précédents ne sont pas réutilisées. Une réponse lance au plus une recherche par photo.

## Les produits ne sont jamais inventés

Les fiches sont construites à partir de ce que votre boutique a renvoyé : le nom du produit, le prix et le prix soldé, l'image, la disponibilité et le lien exactement tels que votre boutique les a envoyés. Le texte de l'agent ne peut ni ajouter un produit, ni modifier un prix, ni inventer un lien. Ce sont les mêmes [fiches produits](/fr/docs/connect-your-store#fiches-produits) que pour toute autre recherche de produits : chaque fiche ouvre donc la page produit dans un nouvel onglet.

## Sans boutique connectée

Quand l'agent ne peut pas chercher dans un catalogue par photo, parce qu'aucune boutique n'est connectée, que l'interrupteur est désactivé ou que votre offre ne l'inclut pas, l'agent voit tout de même la photo. Il dit ce qu'il voit si cela aide et répond à partir de vos connaissances et de vos actions. Il a pour consigne de ne jamais inventer de produits, de prix, de liens ni de disponibilité.

## Limites

| | Free | Starter | Pro | Enterprise |
| --- | --- | --- | --- | --- |
| Recherches par photo par agent et par jour | Aucune | 50 | 200 | 1 000 |
| Recherches par photo par conversation | Aucune | 5 | 5 | 5 |

- La limite journalière repart à zéro à minuit UTC et compte toutes les conversations de l'agent, y compris les chats du Playground.
- Quand une limite est atteinte, l'agent indique au visiteur qu'il ne peut pas chercher par photo pour le moment et propose de chercher si le visiteur décrit l'article avec des mots.
- Les photos suivent les limites des [pièces jointes des visiteurs](/fr/docs/appearance#pieces-jointes-des-visiteurs) : images jusqu'à 4 Mo, pas dans les chats temporaires.
- La recherche par photo n'est pas une action et ne compte pas dans la limite de 25 actions.

## Coûts

- Une recherche par photo ne consomme pas de message supplémentaire. Le message du visiteur compte de la même façon, avec ou sans recherche ; voir [Offres et limites](/fr/docs/plans-and-limits).
- Chaque recherche représente une requête supplémentaire au modèle d'IA pour décrire la photo, plus les recherches dans votre boutique.
- Une réponse avec recherche par photo prend quelques secondes de plus, car l'agent attend les résultats avant de répondre.

## Confidentialité

- La photo est envoyée à OpenAI avec le message du visiteur, comme toute pièce jointe de visiteur, puis une fois de plus pour la décrire en vue de la recherche. Elle ne sert qu'à répondre à ce message.
- La photo reste là où sont conservées les pièces jointes des visiteurs : de façon privée avec la conversation, affichée dans votre transcription et supprimée avec la conversation. Elle n'est jamais ajoutée aux connaissances de votre agent.
- Le modèle d'IA a pour consigne d'ignorer les personnes sur la photo : il ne décrit ni n'identifie jamais une personne, et ne regarde que l'article. Il a aussi pour consigne de ne pas recopier les données personnelles qu'il peut lire, comme des noms ou des numéros sur un document.
- Les compteurs de la carte n'enregistrent que le fait qu'une recherche a eu lieu et son issue, jamais quoi que ce soit provenant de la photo.

## Clics et compteurs

La carte **Search by photo** affiche les 30 derniers jours : combien de recherches par photo l'agent a effectuées et combien de fois les visiteurs ont cliqué sur une fiche produit ainsi trouvée. Les clics sont comptés dans le widget de chat, pas dans le Playground, ni dans les chats temporaires.

Dans l'onglet **Conversations**, **Why this answer** sous une réponse liste « Search by photo » sous **Actions called**, avec **Succeeded** ou **Failed**. Voir [Conversations et stats](/fr/docs/conversations-and-dashboard#why-this-answer).

## Étapes suivantes

- Connectez d'abord votre boutique : [Connecter votre boutique](/fr/docs/connect-your-store).
- Activez le trombone : [Apparence](/fr/docs/appearance#pieces-jointes-des-visiteurs).
- Comparez les offres : [Offres et limites](/fr/docs/plans-and-limits).