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.

Paramètres :
  • platformobligatoire, shopify
  • domainobligatoire, 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 (shopify par 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 ».

Paramètres :
  • project_idobligatoire
  • statuspending|accepted|rejected
  • product_external_id
  • page
  • per_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), from et to (obligatoires, YYYY-MM-DD, 400 jours maximum), days (obligatoire, jusqu’à 400 entrées avec day, referrer, orders et revenue).

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_id et title obligatoires, handle, product_type, vendor, tags, collections et url facultatifs), country_code et language_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 ».

Corps (JSON) :
  • project_idobligatoire
  • idsobligatoire, 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 ».

Corps (JSON) :
  • project_idobligatoire
  • idsobligatoire, jusqu’à 100 ID de suggestions