# WooCommerce

Connectez votre boutique WooCommerce pour que l'assistant vérifie le statut des commandes par téléphone, passe des commandes avec un lien de paiement et réponde à partir de votre catalogue

> Full REST + WebSocket API reference: https://api.happ.tools/reference

WooCommerce se connecte avec une clé que votre boutique délivre à HAPP après votre approbation sur votre propre site. Une fois la liaison faite, l'assistant trouve les commandes récentes d'un acheteur par numéro de téléphone, passe de nouvelles commandes avec un lien de paiement et répond aux questions sur les produits à partir de votre catalogue — y compris « vous avez ça ? » avec une photo.

## Ce que l'assistant peut faire [#what-the-assistant-can-do]

* **Statut de commande par téléphone** — trouve les commandes de l'acheteur grâce au téléphone utilisé lors du paiement et lui indique le numéro de commande, le statut, les articles, le total et le numéro de suivi lorsque votre boutique en enregistre un.
* **Passer une commande** — crée une commande dans WooCommerce avec le statut **Pending payment**, les produits et options choisis (taille, couleur), le nom, le téléphone et l'adresse de livraison de l'acheteur, et envoie à l'acheteur le lien de paiement de cette commande.
* **Réponses sur le catalogue** — connaît vos produits publiés avec prix, variantes et état du stock, et trouve un produit à partir d'une photo envoyée par l'acheteur.

## Avant de commencer [#before-you-start]

* **Boutique WooCommerce** sur WordPress, servie en **HTTPS**.
* **Compte administrateur WordPress** — vous approuvez l'accès en étant connecté.
* **Espace de travail HAPP** avec au moins un assistant configuré pour parler aux clients.
* **WooCommerce activé pour votre espace de travail** — l'intégration est activée par entreprise. Demandez au support HAPP de l'activer.

Aucun plugin n'est à installer.

## Connecter [#connect]

1. Connectez-vous à votre administration WordPress dans le même navigateur.
2. Dans HAPP, ouvrez **Intégrations** et trouvez WooCommerce sous **Ajouter un CRM**.
3. Cliquez sur **Connecter** et saisissez l'adresse de votre boutique — `your-store.com` ou le lien depuis wp-admin fonctionnent tous les deux.
4. Votre boutique ouvre l'écran « HAPP would like to connect to your store » avec un accès **Read/Write**. Cliquez sur **Approve**.
5. Vous revenez sur **Intégrations** avec WooCommerce sous **Mes intégrations**.

La clé que reçoit HAPP peut lire les produits, les clients et les commandes, et créer des commandes. Vous pouvez la voir et la révoquer dans **WooCommerce > Settings > Advanced > REST API**.

## Paramètres [#settings]

Ouvrez l'icône d'engrenage de la carte dans l'onglet **Intégrations** de l'assistant et activez ce que l'assistant peut faire.

* **Rechercher** — statut de commande par le téléphone de l'acheteur.
* **Créer** — commandes en attente de paiement avec un lien de paiement.
* **Catalogue** — recherche de produits par texte et par photo. La première synchronisation prend quelques minutes ; ensuite, le catalogue se met à jour toutes les 6 heures. Seuls les produits publiés sont synchronisés, jusqu'à 5 000.

## Limites [#limits]

* Les commandes sont créées en **Pending payment** ; WooCommerce les fait avancer quand l'acheteur paie.
* La recherche par téléphone accepte les formats usuels (`050 111 22 33`, `+380501112233`, `0501112233`). Si rien ne correspond, l'assistant vérifie vos 100 dernières commandes.
* Un numéro de suivi ne s'affiche que si votre boutique le conserve via un plugin — WooCommerce Shipment Tracking ou un plugin de transporteur qui stocke la lettre de voiture (TTN).

## Dépannage [#troubleshooting]

| Problème                                                   | Cause                                                                      | Solution                                                                          |
| ---------------------------------------------------------- | -------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| « Enter the store address as https\://… »                  | L'adresse n'est pas en HTTPS ou n'est pas un site public                   | Utilisez l'adresse `https://` de votre boutique.                                  |
| « The store address redirects to … »                       | Vous avez saisi une adresse qui redirige ailleurs (par exemple sans `www`) | Connectez-vous avec l'adresse indiquée dans le message.                           |
| « Access was not granted on the store »                    | **Deny** a été cliqué sur l'écran d'approbation                            | Cliquez à nouveau sur **Connecter** et choisissez **Approve**.                    |
| « The store did not send the key to Happ »                 | Votre site n'a pas pu joindre HAPP (pare-feu ou plugin de sécurité)        | Autorisez les requêtes sortantes vers `api.happ.tools` et réessayez.              |
| « The store refused access — reconnect WooCommerce » (401) | La clé a été révoquée ou supprimée dans WooCommerce                        | Ouvrez **Intégrations** > **WooCommerce** et cliquez à nouveau sur **Connecter**. |
| Un produit manque dans le catalogue                        | Le produit est un brouillon, privé ou au-delà de la limite de 5 000        | Publiez-le ; il apparaît après la synchronisation suivante.                       |

## Déconnecter [#disconnect]

Déconnectez la carte dans HAPP, ou révoquez la clé HAPP dans **WooCommerce > Settings > Advanced > REST API**. Les commandes déjà dans votre boutique restent intactes.

## Ensuite [#next]

* [CRM](/docs/integrations/crm) — toutes les intégrations CRM
* [Outils](/docs/agents/tools) — ce que l'assistant appelle pendant les conversations
* [Intégrations](/docs/integrations) — le catalogue complet