> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopware 6

> Laissez votre assistant répondre aux questions sur les produits et les commandes de votre boutique Shopware 6.

Laissez votre assistant répondre aux questions sur les produits et les commandes de votre boutique Shopware 6. Un appelant demande : « Ma commande 10023 est-elle déjà en route ? » L’assistant lit le statut de la commande, du paiement et de la livraison dès qu’il sait qui appelle. Il lit aussi les produits avec leur prix et leur stock. Il fonctionne avec Shopware 6.4 ou ultérieur et ne modifie jamais le statut, le paiement ni la livraison d’une commande. La seule écriture est un commentaire interne facultatif pour votre équipe (désactivé par défaut).

## Connecter votre boutique

1. Dans Shopware, ouvrez **Paramètres → Système → Intégrations** et choisissez **Ajouter une intégration**. Donnez-lui un nom tel que « Assistant téléphonique » et copiez l’**ID de la clé d’accès** (il commence par `SWIA`) et la **clé d’accès secrète**. Shopware n’affiche la clé secrète qu’une seule fois.
2. Attribuez à l’intégration un rôle avec accès en affichage dans l’éditeur de rôles de Shopware sous **Commandes**, **Catalogues → Produits**, **Catalogues → Catégories** et **Paramètres → Devises**. Ajoutez l’affichage de la configuration système si l’assistant doit connaître le nom de votre boutique. L’accès en écriture à commande n’est nécessaire que pour les [notes de demande](#demandes-pour-votre-équipe).
3. Ouvrez **Agent Tools → Marketplace → Shopware 6**. Saisissez l’adresse de la boutique, l’ID de la clé d’accès et la clé d’accès secrète. Utilisez une clé d’intégration, pas un mot de passe d’administrateur ni une clé de canal de vente (`SWSC…`).
4. Choisissez **Ajouter**. La connexion et l’accès en lecture sont vérifiés avant l’enregistrement. Associez ensuite la connexion à votre assistant.

L’adresse de la boutique est son adresse HTTPS publique, par exemple `https://shop.example.com`. Si vous collez l’adresse d’administration, l’assistant retire `/admin`.

## Ce que l’assistant peut faire

Activé par défaut :

* Rechercher des produits actifs par nom et lire le prix, le stock et la présence de variantes.
* Lister vos catégories de produits pour affiner une recherche.
* Lire le statut d’une commande, y compris le paiement et la livraison, une fois l’appelant vérifié.
* Retrouver les dernières commandes d’un appelant par adresse e-mail ou par son numéro de téléphone.

Optionnel, à choisir sous **Modifier** :

* Laisser à votre équipe une demande d’annulation sur une commande.
* Laisser à votre équipe une demande de retour ou d’échange sur une commande.

L’assistant ne lit jamais à voix haute les numéros de suivi, les adresses ou les données d’autres clients.

## Confidentialité des commandes

L’assistant ne donne les détails d’une commande qu’à la personne concernée. Il lui faut l’une de ces deux preuves :

* **Le numéro de téléphone.** Le numéro d’où l’appelant téléphone correspond au numéro de la commande (adresse de facturation ou de livraison). L’assistant a aussi besoin du numéro de commande.
* **Un second élément.** Le numéro de commande plus l’adresse e-mail de la commande ou le code postal de livraison.

Si un élément est faux, la réponse est toujours la même : aucun enregistrement ne correspond à ces informations. L’assistant ne dit jamais si une commande existe. Après trois tentatives erronées dans une conversation, il arrête de vérifier. Le numéro de commande seul ne suffit jamais.

Quand plusieurs clients utilisent le même numéro, le numéro n’identifie pas l’appelant. L’assistant demande alors le numéro de commande et l’adresse e-mail ou le code postal de livraison, même si l’appelant donne le numéro de commande. Si l’appelant masque son numéro ou s’il n’y a pas de numéro (chat web), l’assistant demande le second élément.

## Statut de la commande, du paiement et de la livraison

L’assistant exprime chaque statut avec des mots :

| Élément | Ce que l’appelant entend |
| - | - |
| Commande | reçue, en cours, terminée, annulée |
| Paiement | pas encore payée, paiement en cours, payée, partiellement payée, paiement autorisé, paiement échoué, rappel de paiement envoyé, remboursée, partiellement remboursée, paiement annulé, paiement pas encore confirmé |
| Livraison | pas encore expédiée, expédiée, partiellement expédiée, retournée, partiellement retournée, livraison annulée |

Il indique aussi la date de la commande, les produits avec leurs quantités, le total et le mode d’expédition. Pour le suivi, il dit seulement si un numéro de suivi existe. Il ne lit pas le numéro.

## Demandes pour votre équipe

Les demandes d’annulation et de retour ou d’échange sont désactivées par défaut. Quand vous les activez, l’assistant répète le numéro de commande et le motif, attend un oui clair et ajoute un bloc au **commentaire interne** de la commande :

```text theme={null}
CANCELLATION REQUEST (Votre marque)
Reason: Ordered twice by mistake
Identity check: caller phone number matched the order
Callback number: +49 151 2345678
Ref: 3fa91c07
```

Rien d’autre ne change : le statut de la commande reste le même, aucun remboursement n’a lieu et aucune étiquette n’est créée. L’assistant demande à Shopware de ne pas exécuter de flux pour cette modification, de sorte que le client ne reçoit pas d’e-mail. Votre équipe lit le commentaire dans la commande et décide.

* Une demande d’annulation est possible tant que la commande est ouverte ou en cours et non expédiée.
* Une demande de retour ou d’échange est possible pour les commandes terminées ou expédiées.
* Une deuxième demande du même type pour la même commande ne crée pas de seconde note.

Le rôle de l’intégration a besoin de l’accès en écriture à commande. L’assistant vérifie à la connexion que le champ du commentaire interne existe. Si votre boutique n’a pas encore de commande, cette vérification ne voit pas le champ ; reconnectez-vous après la première commande.

La note elle-même est rédigée en anglais pour que votre équipe la lise de façon uniforme. Le nom indiqué est celui de votre marque.

## Reconnaître les appelants

Lors d’un appel téléphonique, l’assistant peut saluer l’appelant par son prénom et connaître sa dernière commande avant même qu’il parle. Shopware enregistre les numéros de téléphone tels qu’ils ont été saisis. L’assistant cherche donc les six derniers chiffres du numéro de l’appelant, puis compare les numéros avec exactitude. Un numéro enregistré avec des espaces au milieu de ces chiffres, comme `0151 123 45678`, n’est pas trouvé ainsi. L’appelant peut toujours donner le numéro de commande avec l’adresse e-mail ou le code postal de livraison.

## Paramètres

Deux paramètres facultatifs figurent dans le formulaire de connexion :

* **ID du canal de vente :** limite les réponses sur les produits à ceux visibles dans ce canal de vente. Laissez vide pour tous les produits actifs.
* **Fuseau horaire de la boutique :** définit le fuseau horaire des dates de commande. Vide signifie Europe/Berlin.

Pour modifier plus tard un paramètre, l’adresse ou les clés, modifiez la connexion dans **Automatisations → Connexions** ou supprimez l’outil et reconnectez-le.

## Tester sans risque

Testez avec un produit de test et votre propre numéro de téléphone. Un appel de test lit votre vraie boutique. Si vous avez activé les notes de demande, un test écrit une vraie note sur une vraie commande : utilisez une commande de test et supprimez la note ensuite.

## Canaux

Lors d’un appel téléphonique, l’assistant connaît le numéro de l’appelant. Dans les canaux sans numéro de téléphone, comme le chat web, il demande toujours le numéro de commande plus l’adresse e-mail ou le code postal de livraison.

## Automatisations

Connectez **Shopware 6** dans **Automatisations → Connexions**, ou importez sa connexion Agent Tools. Chaque outil est disponible comme action. Une automatisation déclenchée par un appel ou une conversation par texte (SMS, WhatsApp) connaît le numéro de l’interlocuteur grâce à cet appel lui-même. Les autres exécutions (webhook, planification) n’ont pas d’appelant : **Statut de la commande** y exige donc l’adresse e-mail ou le code postal de livraison, et **Dernières commandes de l’appelant** répond que le numéro n’est pas disponible.

## API, MCP, CLI & SDK

`POST /api/v1/tools/integrations/shopware6` · MCP `connect_integration` · CLI `famulor connect-integration shopware6`.

`client.api.connectIntegration` nécessite `famulor-sdk` 0.2.12 ou ultérieur. Mettez à jour la CLI avec `npm install --global famulor` avant d’utiliser `connect-integration`.

```bash theme={null}
famulor connect-integration shopware6 --fields "{\"shop_url\":\"https://shop.example.com\",\"access_key_id\":\"SWIA...\",\"secret_access_key\":\"$SHOPWARE_SECRET\"}"
```

```typescript theme={null}
import { Famulor } from 'famulor-sdk';

const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY });
const { data: tool } = await client.api.connectIntegration({
  path: { provider: 'shopware6' },
  body: {
    fields: {
      shop_url: 'https://shop.example.com',
      access_key_id: 'SWIA...',
      secret_access_key: process.env.SHOPWARE_SECRET,
    },
  },
});
console.log(tool.id);
```

## Dépannage

* **L’adresse ne mène pas à l’API d’administration Shopware 6 :** la boutique est antérieure à 6.4 ou l’adresse est incorrecte. Utilisez l’adresse publique de la boutique, sans `/api`.
* **Le rôle de l’intégration ne l’autorise pas :** ouvrez l’intégration dans Shopware et ajoutez l’accès en lecture manquant. Le message ne nomme aucune entité ; vérifiez produit, catégorie, commande, adresse de commande, livraison de commande, transaction de commande et devise.
* **Shopware a refusé l’ID de la clé d’accès ou la clé secrète :** créez une nouvelle intégration et saisissez sa paire de clés. Une clé de canal de vente ne fonctionne pas.
* **Trop de connexions :** Shopware limite les connexions par intégration. Patientez quelques minutes. L’assistant réutilise sa connexion pendant environ neuf minutes.
* **La boutique répond par une page web :** un pare-feu ou un plugin de sécurité bloque les requêtes API. Autorisez les requêtes vers `/api/` pour l’intégration.

[Documentation de l’API d’administration Shopware](https://developer.shopware.com/docs/concepts/api/admin-api.html)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.