Intégrations de boutique
Les endpoints de l’application LLM Pulse pour Shopify : associer une boutique à son projet, envoyer les commandes que les assistants d’IA ont apportées à la boutique puis les récupérer, et transformer les produits du catalogue en prompts d’acheteurs à suivre. Ils nécessitent une clé API, donc le forfait Scale ou supérieur, et ne sont pas disponibles pour les comptes dotés d’un portail en marque blanche ou d’une intégration iframe, qui reçoivent ERR_INTEGRATION_UNAVAILABLE (403).
GET/store_connection
Indique à une application de boutique si le compte de la clé API peut l’utiliser et à quel projet appartient la boutique. project est le projet actif dont le domaine est celui de la boutique, à défaut un projet dont le domaine en est un domaine parent ou un sous-domaine, sinon null. Lorsque plusieurs projets actifs correspondent à égalité, project vaut null et ambiguous vaut true. candidates liste tous les projets actifs du compte pour que l’application puisse proposer un sélecteur. Ne prend pas de project_id.
platformobligatoire,shopifydomainobligatoire, le domaine de la boutique, avec ou sans schéma
GET/ai_orders
Renvoie les commandes provenant de l’IA qu’une application de boutique a envoyées pour un projet : totaux, une ligne par assistant IA et une série quotidienne. Chaque revenue est une chaîne décimale exprimée dans la devise indiquée par currency, champ qui vaut null lorsque la période ne contient aucune commande enregistrée. Les membres de l’équipe doivent disposer de l’accès en lecture à « Trafic IA ».
- Paramètres :
project_id(obligatoire),platform(shopifypar défaut),from/to(YYYY-MM-DD ; par défaut, les 90 jours se terminant aujourd’hui ; 400 jours maximum).
GET/catalog_prompt_suggestions
Liste les prompts d’acheteur suggérés à partir du catalogue d’une boutique, du plus ancien au plus récent, avec leur statut et le produit dont chacun provient. Les membres de l’équipe doivent disposer de l’accès en lecture à « Prompts ».
project_idobligatoirestatuspending|accepted|rejectedproduct_external_idpageper_page50 par défaut, 100 maximum
PUT/ai_orders
Remplace les commandes et le chiffre d’affaires quotidiens provenant de l’IA sur une période. Envoyez dans referrer l’hôte référent brut ou le utm_source de la première visite de chaque commande : LLM Pulse le classe et ignore tout ce qui n’est pas un assistant IA, et la réponse compte les lignes enregistrées (stored) et les entrées ignorées (ignored). Toutes les lignes enregistrées de ce projet et de cette plateforme entre from et to sont remplacées : renvoyer la même période ne compte donc rien deux fois. Nécessite une clé API avec droits d’écriture ; les membres de l’équipe doivent disposer de l’accès en modification à « Trafic IA ».
- Corps (JSON) :
project_id(obligatoire),platform(obligatoire,shopify),currency(obligatoire, ISO 4217),frometto(obligatoires, YYYY-MM-DD, 400 jours maximum),days(obligatoire, jusqu’à 400 entrées avecday,referrer,ordersetrevenue).
POST/catalog_prompt_suggestions
Rédige des prompts d’acheteur pour 20 produits du catalogue au maximum et les enregistre comme suggestions en attente dans la file « Prompts suggérés » du projet. data ne contient que les nouvelles suggestions, et skipped compte les prompts que le projet avait déjà en suggestion. L’appel puise dans le même quota horaire de suggestions de prompts que l’application (ERR_QUOTA_EXCEEDED une fois le quota épuisé) ; une génération qui échoue renvoie ERR_GENERATION_FAILED (502) et peut être relancée. Nécessite une clé API avec droits d’écriture ; les membres de l’équipe doivent disposer de l’accès en création à « Prompts ».
- Corps (JSON) :
project_id(obligatoire),platform(obligatoire,shopify),products(obligatoire, de 1 à 20 objets ;external_idettitleobligatoires,handle,product_type,vendor,tags,collectionseturlfacultatifs),country_codeetlanguage_code(par défaut, ceux du projet).
POST/catalog_prompt_suggestions/accept
Lance le suivi des suggestions en attente : chacune devient un prompt, associé à un tag qui porte le nom de son produit. Les suggestions qui ne sont plus en attente sont renvoyées dans skipped, avec leur statut comme motif. Si l’ajout des nouveaux prompts dépasse la limite du forfait, l’appel renvoie ERR_LIMIT_REACHED et n’accepte rien. Nécessite une clé API avec droits d’écriture ; les membres de l’équipe doivent disposer de l’accès en création à « Prompts ».
project_idobligatoireidsobligatoire, jusqu’à 100 ID de suggestions, tous du même pays et de la même langue
POST/catalog_prompt_suggestions/reject
Marque les suggestions en attente comme rejetées. Les suggestions qui ne sont plus en attente restent inchangées, et rejected compte celles qui ont changé. Nécessite une clé API avec droits d’écriture ; les membres de l’équipe doivent disposer de l’accès en modification à « Prompts ».
project_idobligatoireidsobligatoire, jusqu’à 100 ID de suggestions