> ## 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.

# Application Shopify Famulor

> Connectez un espace Famulor existant et utilisez l’assistance vocale dans Shopify Admin.

L’application **Famulor AI Agent** relie une boutique Shopify à un espace de travail Famulor existant. Le propriétaire installe l’application, l’ouvre dans Shopify Admin et confirme la liaison. Aucun secret API ni saisie manuelle du domaine n’est nécessaire.

L’application Shopify n’entraîne aucun frais supplémentaire. Votre abonnement Famulor et les frais d’utilisation existants s’appliquent. Un compte Famulor existant est nécessaire.

## Connecter l’espace

1. Ouvrez **Famulor AI Agent** dans Shopify Admin en tant que propriétaire.
2. Cliquez sur **Connect Famulor workspace** et connectez-vous à Famulor dans le nouvel onglet.
3. Sélectionnez un espace où vous êtes propriétaire ou administrateur, puis **Connect store**.
4. Revenez dans Shopify Admin et cliquez sur **Refresh**.

Le lien expire après cinq minutes et ne peut être utilisé qu’une fois. Recommencez dans Shopify Admin s’il expire. Seul le propriétaire peut consulter les données de l’espace connecté dans l’application.

## Ajouter les outils

Ouvrez **Famulor Tools** depuis Shopify Admin. Configurez la connexion native et attribuez les tâches dans les réglages Tools et Assistant existants. L’assistant peut rechercher les produits actuels, consulter stocks et politiques et lire le statut après vérification exacte du client.

Les outils de **demande** d’annulation, de remboursement et d’adresse enregistrent des demandes pour le marchand sans modifier les commandes. Les modifications gérées sont des actions distinctes soumises aux prérequis ci-dessous.

## Consulter l’activité

**Store activity** affiche les actions et conversations attribuées à cette boutique, sans exposer celles d’autres boutiques ou espaces. Ouvrez une conversation pour lire sa transcription et écouter un enregistrement disponible.

Gérez les boutiques dans Famulor sous **Automations → Connections → Shopify app connections**. La déconnexion bloque l’accès des outils à cette boutique. Désinstallez l’application dans Shopify pour révoquer l’accès.

## API, MCP, CLI et SDK

La liaison initiale exige l’accord du propriétaire dans Shopify Admin. Les identifiants propriétaire/administrateur peuvent ensuite gérer la boutique.

| Tâche | API REST | Outil MCP | Commande CLI |
| - | - | - | - |
| Boutiques | `GET /api/v1/shopify/installations` | `list_shopify_installations` | `famulor list-shopify-installations` |
| Actions | `GET /api/v1/shopify/actions` | `list_shopify_actions` | `famulor list-shopify-actions` |
| Ajouter des outils | `POST /api/v1/shopify/installations/{id}/tools` | `provision_shopify_assistant_tools` | `famulor provision-shopify-assistant-tools STORE_ID --assistant-id ASSISTANT_ID --actions lookup_order` |
| Historique | `GET /api/v1/shopify/installations/{id}/history` | `list_shopify_history` | `famulor list-shopify-history STORE_ID` |
| Demandes | `GET /api/v1/shopify/installations/{id}/requests` | `list_shopify_support_requests` | `famulor list-shopify-support-requests STORE_ID` |
| Résolution | `PATCH /api/v1/shopify/installations/{id}/requests` | `resolve_shopify_support_request` | `famulor resolve-shopify-support-request STORE_ID --request-id REQUEST_ID --status completed` |
| Conversation | `GET /api/v1/shopify/installations/{id}/calls/{callId}` | `get_shopify_call` | `famulor get-shopify-call STORE_ID CALL_ID` |
| Rapports de confidentialité | `GET /api/v1/shopify/installations/{id}/privacy-exports` | `list_shopify_privacy_exports` | `famulor list-shopify-privacy-exports STORE_ID` |
| Rapport de confidentialité | `GET /api/v1/shopify/installations/{id}/privacy-exports/{exportId}` | `get_shopify_privacy_export` | `famulor get-shopify-privacy-export STORE_ID EXPORT_ID` |
| Déconnecter | `DELETE /api/v1/shopify/installations/{id}` | `disconnect_shopify_installation` | `famulor disconnect-shopify-installation STORE_ID` |

La lecture utilise `integrations:read`. Les outils exigent aussi `assistants:write`, l’historique `calls:read`. Les modifications utilisent `integrations:write`.

```ts theme={null}
import { Famulor } from "famulor-sdk";
const famulor = new Famulor({ apiKey: process.env.FAMULOR_API_KEY! });
const stores = await famulor.shopify.installations();
const actions = await famulor.shopify.actions();
const activity = await famulor.shopify.history(stores.data[0].id);
```

Le [connecteur avec votre propre application](/fr/automations/shopify) reste disponible. Il possède une connexion et des capacités distinctes de l’application native.

## Plugin Shopify natif (Bêta)

Activez les fonctionnalités bêta du workspace. Ouvrez **Tools → Agent Connectors** ou **Automations → Connections**, puis connectez **Shopify AI Agent App (Beta)**. Les deux utilisent la même connexion. Créez ou choisissez un assistant dans **Assistants**, puis attribuez les outils Shopify dans **Tools**. Utilisez les réglages Famulor existants pour les connaissances, SMS, transferts, rappels, téléphonie et campagnes.

Produits, variantes, prix et stocks sont lus en direct dans Shopify, sans import de catalogue dans Famulor. Prix et stocks sont des instantanés ; le checkout calcule le total final. Les commandes privées exigent une référence exacte, un e-mail correspondant et le code postal de livraison. Le numéro appelant seul ne suffit pas.

Les demandes à traiter par le marchand restent distinctes des modifications Shopify. Brouillons, e-mails de facture, annulations, adresses et retours exigent activation du marchand, permissions et environnement téléphonique compatible. Les modifications de clients/commandes existants exigent aussi une vérification privée et une confirmation explicite liée à l’action préparée. Les prérequis manquants bloquent l’exécution. Aucune annulation ne rembourse automatiquement ; un brouillon ne débite pas le client. Les retours dépendent des livraisons et des règles du marchand ; les échanges peuvent nécessiter son intervention. La connexion ne garantit ni audiences de relance, ni accès aux abonnements, ni revenu incrémental.

| REST API | MCP | CLI |
| - | - | - |
| `GET /api/v1/shopify/setup` | `get_shopify_setup` | `famulor get-shopify-setup` |
| `PATCH /api/v1/shopify/installations/{id}/capabilities` | `update_shopify_capabilities` | `famulor update-shopify-capabilities STORE_ID --enabled-capabilities voice_checkout --expected-version VERSION` |

```ts theme={null}
const setup = await famulor.shopify.setup();
await famulor.shopify.updateCapabilities(storeId, { enabled_capabilities: ["voice_checkout"], expected_version: setup.data.capabilities!.version });
```

## Audiences téléphoniques externes (Bêta)

Dans Campaign Settings, choisissez une connexion Shopify ou Klaviyo éligible et un segment source actuel. Les campagnes locales gardent leur comportement. Shopify prend en charge segments sélectionnés/VIP, reconquête, renouvellement, checkout abandonné et le scénario de paiement échoué pris en charge. Klaviyo prend actuellement en charge uniquement les segments sélectionnés. Choisissez le produit à renouveler dans le sélecteur en direct. Reconquête et renouvellement exigent l’historique ancien. Un paiement échoué désigne une commande réelle impayée, non annulée, avec preuves complètes d’échec, sans paiement réussi/en attente ultérieur ni commande plus récente ; abonnements et checkouts non enregistrés sont exclus.

Appels téléphoniques uniquement, suivi sur Off. Avant chaque tentative, Famulor vérifie segment actuel, scénario, téléphone et autorisation positive explicite de marketing vocal. Abonnement e-mail/SMS, numéro appelant et absence de suppression ne suffisent pas. Sans preuve, le destinataire est exclu. Horaires, suppression, tentatives et capacité restent applicables. La configuration ne peut plus changer après le début des exécutions.

Associez un JSON faisant autorité via espace de noms et clé (espace de noms obligatoire pour Shopify). Il doit inclure `subject_ref` et `phone` actuels, `channel: "voice"`, `purpose: "marketing"`, `granted: true`, `revoked: false`, `granted_at` non futur, `evidence_ref` et `source_revision` actuelle. Famulor conserve références opérationnelles et états, sans copie de clients, commandes ou catalogue.

## Paiements nets associés

Actualisez les paiements associés dans l’activité Shopify existante. Famulor lit l’état actuel des paiements, remboursements et annulations uniquement depuis les références d’appels enregistrées. Les brouillons convertis sont résolus en commandes ; chaque commande compte une fois et revient à la première association d’appel de la boutique, avec ID d’appel pour départager. Les filtres de campagne s’appliquent ensuite. Les totaux décimaux exacts restent séparés par devise de boutique. Heure, remboursements, annulations et observations partielles sont affichés. Références manquantes, accès indisponible et historique ancien/limité ne sont pas des revenus nuls. Il s’agit d’une association, pas d’un revenu incrémental ou causal.

| REST | MCP | CLI |
| - | - | - |
| `GET /api/v1/shopify/installations/{id}/revenue` | `get_shopify_associated_revenue` | `famulor get-shopify-associated-revenue STORE_ID` |

```ts theme={null}
const payments = await famulor.shopify.associatedRevenue(storeId);
```


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