In een commercetools-landschap zit productcontent verdeeld over product types, varianten, assets en een ERP of DAM ernaast. Photopilot koppelt aan jullie project en vult per product de attributen uit jullie product types voor doelgroep, kleur, materiaal en Web only, plus description, metaTitle en metaDescription als LocalizedString per taal en beelden per variant.
01
Wat Photopilot uit jullie commercetools-project haalt
Photopilot werkt met de product projections van jullie project, dus precies wat gepubliceerd is. Per product komen de key, naam en beschrijving per taal mee, plus de master variant en varianten met SKU en attributen zoals EAN, kleur en materiaal. Bestaande images en assets zijn het uitgangspunt. Elke ronde filtert op lastModifiedAt, zodat alleen gewijzigde producten worden opgepakt.
02
Varianten, kleuren en product types
Omdat commercetools kleur en maat meestal als variantattributen in een product type vastlegt, matcht Photopilot beelden op SKU, product key en EAN. Een kleurcode uit jullie attributen gebruiken we om beelden per kleur te groeperen, zodat elke kleur zijn eigen set krijgt en maten dezelfde beelden delen. Werken jullie met meerdere product types voor bijvoorbeeld kleding, schoenen en accessoires, dan krijgt elk type zijn eigen beeldregels. Zo blijft de koppeling ook kloppen als het datamodel later groeit.
03
Wat Photopilot produceert
Leveranciersbeelden en studiofoto's krijgen automatisch de juiste achtergrond, uitsnede en verhouding voor jullie voorkanten. Waar beelden ontbreken maakt Photopilot ghost mannequin-beelden, AI-modelfoto's of met Iris als AI creative director complete campagnebeelden. Materialen en wassymbolen worden herkend en vormen de basis voor productteksten en SEO-teksten in elke taal die jullie project voert. Het contentteam keurt alles goed voordat het wordt vrijgegeven.
04
Rechtstreeks in jullie commercetools-project
Photopilot vult doelgroep, kleur, materiaal en Web only als enum- of lenum-attribuut volgens de attribute definitions van jullie product types, zodat de waarden binnen de toegestane keuzes blijven. Description, metaTitle en metaDescription gaan als LocalizedString per locale; de slug blijft staan. Beelden komen per variant in vaste volgorde als images, met alt-teksten.
05
Wat het team dagelijks ziet
Per variant laat Photopilot zien of er voldoende beelden zijn, welke teksten nog wachten op goedkeuring en wat al is geleverd. Nieuwe producten uit het project verschijnen vanzelf in de werklijst, zodat niemand handmatig hoeft bij te houden wat er bij is gekomen. Met autopilot kunnen terugkerende stappen, zoals vrijstaand maken en uitsnijden, zonder handwerk doorlopen. Rapportages tonen per merk of categorie hoe compleet de content is.
06
Opzetten in een paar stappen
Jullie maken in de Merchant Center een API-client aan met rechten op producten en delen de project key, de API- en auth-URL en client-ID en secret. Daarna leggen we samen vast welke attributen Photopilot vult en welke enum-waarden bij jullie filters horen. De eerste ronde draaien we tegen jullie eigen project, zodat de mapping meteen klopt. Een development-traject is daarvoor niet nodig.
commercetools in het kort
Wat er wordt uitgewisseld
Photopilot vult in commercetools description, metaTitle en metaDescription als LocalizedString, en attributen op jullie product types voor doelgroep, kleur, materiaal en Web only. Beelden zet Photopilot per product in de afgesproken volgorde.
Hoe vaak
Standaard elke twee uur, alleen met de producten die sinds de vorige ronde zijn gewijzigd. Goedgekeurde teksten en attributen volgen direct na goedkeuring.
Wat je aanlevert
De project key en een API-client met client-ID en secret en rechten op producten en product types.
Goed om te weten
De koppeling is gebouwd op de officiële commercetools-API. We testen hem eerst samen op jullie project.
Laat verkoopklare content automatisch in je webshop landen
300.000+artikelen verwerkt
9,5M+leveranciersbeelden geïndexeerd
~3.200foto's per dag automatisch bewerkt
FAQ
Veelgestelde vragen
Hoe koppel ik commercetools aan Photopilot?
Maak in de Merchant Center een API-client met rechten op producten en deel de project key, API-URL, auth-URL, client-ID en secret. Photopilot draait daarna een eerste ronde op jullie project.
Werkt Photopilot met gepubliceerde of staged producten in commercetools?
Photopilot gaat uit van de gepubliceerde product projections, dus de data die ook op de voorkant staat, en zet wijzigingen klaar om te publiceren.
Werkt Photopilot met varianten en kleurattributen in commercetools?
Ja. Photopilot werkt met de master variant en varianten met SKU en attributen, en groepeert beelden per kleur. Maten van dezelfde kleur delen zo één beeldset.
Hoe komen beelden van Photopilot in commercetools terecht?
Photopilot zet de goedgekeurde beelden als images op de juiste variant, met een vaste volgorde, zodat de verwerking voorspelbaar blijft.
Maakt Photopilot productteksten in meerdere talen voor commercetools?
Ja, per taal die jullie project gebruikt maakt Photopilot productteksten, metaTitle, metaDescription en alt-teksten, en zet ze in de gelokaliseerde velden.
Moet ons development-team iets bouwen voor Photopilot en commercetools?
Nee. Een API-client met de juiste rechten is genoeg; Photopilot werkt met de standaard-API van commercetools.
Kan ik content goedkeuren voordat het naar commercetools gaat?
Ja. Beelden, teksten en attributen staan eerst ter beoordeling in Photopilot en gaan pas na goedkeuring naar commercetools. Je ziet per variant wat er nieuw of gewijzigd is.
Wat als een commercetools-product nog geen beelden heeft?
Dan verschijnt het in het overzicht met ontbrekende beelden. Photopilot kan op basis van een eenvoudige productfoto AI-modelfoto's, een ghost mannequin of een packshot maken, die je daarna zelf goedkeurt.
Hoe vaak synchroniseert Photopilot met commercetools?
Standaard elke twee uur, gefilterd op lastModifiedAt, dus alleen gewijzigde producten. Grote catalogi blijven zo licht om bij te houden.
Welke attributen vult Photopilot in commercetools?
Attributen op jullie product types voor doelgroep en kleur (lenum), materiaal (ltext) en Web only (boolean), in elke locale van het project.
Wijzigt Photopilot de slug?
Nee, de slug blijft staan. Photopilot vult description, metaTitle en metaDescription.
Wint wat al in commercetools staat?
Jullie kiezen per kenmerk wie wint: de bron of Photopilot. Wijkt Photopilot af, dan zie je een waarschuwing bij het artikel.
Hoe vaak leest Photopilot uit commercetools?
Standaard elke twee uur, met alleen de producten die in het project zijn gewijzigd.
Wat heeft Photopilot nodig om commercetools te koppelen?
De project key en een API-client met client-ID en secret en lees- en schrijfrechten op producten.