Application Shopify Famulor

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

Ouvrez Famulor AI Agent dans Shopify Admin en tant que propriétaire.
Cliquez sur Connect Famulor workspace et connectez-vous à Famulor dans le nouvel onglet.
Sélectionnez un espace où vous êtes propriétaire ou administrateur, puis Connect store.
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.

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 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`

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`

const payments = await famulor.shopify.associatedRevenue(storeId);

Automatisation

Intégrations

Application Shopify Famulor

Connecter l’espace

Ajouter les outils

Consulter l’activité

API, MCP, CLI et SDK

Plugin Shopify natif (Bêta)

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

Paiements nets associés

​Connecter l’espace

​Ajouter les outils

​Consulter l’activité

​API, MCP, CLI et SDK

​Plugin Shopify natif (Bêta)

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

​Paiements nets associés

Connecter l’espace

Ajouter les outils

Consulter l’activité

API, MCP, CLI et SDK

Plugin Shopify natif (Bêta)

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

Paiements nets associés