InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Nieuwe Nuvemshop- en Tiendanube-producten automatisch posten op Instagram, TikTok en Facebook

De webhook product/created van een Nuvemshop- of Tiendanube-app kan elk nieuw product via easyCoexistence op Instagram, TikTok en Facebook plaatsen: n8n of een kort script haalt het product op, zet de hoofdfoto voor Instagram om naar JPEG en stuurt tekst, foto en link naar de posts-API van easyCoexistence, die via de officiële API van elk netwerk publiceert, meteen of later. Claude plaatst producten op verzoek met de eigen connector van Nuvemshop.

3 seconds

Hoelang Nuvemshop wacht op een 2XX-antwoord op een webhook voordat het opnieuw probeert, tot 16 pogingen binnen 48 uur.

store_id, event, id

De velden die een productwebhook van Nuvemshop meestuurt, met een tijdstempel en zonder productdetails, zodat het product wordt gelezen met GET /products/{id}.

x-linkedstore-hmac-sha256

De header met de HMAC-SHA256-handtekening van elke webhook, ondertekend met het clientgeheim van de app, niet met het token van de winkel.

WebP

Het formaat waarin Nuvemshop productafbeeldingen na optimalisatie mogelijk aanbiedt, zonder API-optie om de conversie uit te schakelen.

admin-mcp.nuvemshop.com.br

Het adres dat het Helpcenter van Nuvemshop geeft om de eigen MCP-connector als aangepaste connector aan Claude toe te voegen.

1080 × 1920

De grootste afbeelding die een TikTok-fotopost aanneemt, of 1920 × 1080, als JPG of WebP tot 20 MB.

Hoe wordt een nieuw Nuvemshop-product een post?

Via een app, een webhook en één aanroep per account. De webhooks van Nuvemshop horen bij een app, dus maak er een aan met de scope read_products, installeer die in je winkel en registreer een webhook voor product/created die naar je n8n-workflow of server wijst. De melding bevat het winkel-ID, de gebeurtenis en het ID van het product, zonder productdetails. De workflow leest het product daarom met GET /products/{id}, controleert of het zichtbaar is en een foto heeft, en stuurt per account één verzoek naar de posts-API van easyCoexistence: een fotopost voor Instagram en TikTok, een linkpost voor Facebook. easyCoexistence publiceert elk verzoek via de officiële API van het netwerk, meteen of op de publish_at die je instelt.

1product/createdNuvemshop's webhook, signed
2GET /products/{id}Name, images, variants, canonical_url
3Checkvisibility visible, at least one image
4Posts APIOne call per account, now or later

Hoe stel je de Nuvemshop-app en de webhook in?

Eenmalig, via het Partners Portal en een terminal. Registreer je als partner van Nuvemshop of Tiendanube, maak een app aan onder Apps met read_products, wat ook productafbeeldingen en varianten dekt, en installeer die in je winkel. De autorisatiecode die naar je redirect-URL wordt gestuurd, is 5 minuten geldig en wordt bij https://www.tiendanube.com/apps/authorize/token ingewisseld voor een token en een user_id, het ID van de winkel. Het token verloopt niet totdat je voor die app en winkel een nieuw token krijgt of de app wordt verwijderd. Registreer daarna de webhook met POST /webhooks. Elk verzoek bevat Authorization: Bearer met het token en een User-Agent met de naam van je app en een contactgegeven, anders antwoordt Nuvemshop met 400.

Register the product/created webhook
curl -X POST "https://api.nuvemshop.com.br/2025-03/<STORE_ID>/webhooks" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "User-Agent: Product posts (you@example.com)" \
  -H "Content-Type: application/json" \
  -d '{ "event": "product/created", "url": "https://n8n.example.com/webhook/nuvemshop-products" }'

Wat doet de n8n-workflow met elk product?

Antwoorden, verifiëren, lezen, converteren en posten. Een Webhook-node met Raw Body aan en Respond ingesteld op Immediately antwoordt binnen de 3 seconden van Nuvemshop. Een Extract From File-node zet de body om in tekst, een Crypto-node berekent de Hmac met SHA256 en HEX, ondertekend met het clientgeheim van de app, en een If-node laat de run alleen doorgaan wanneer het resultaat gelijk is aan de header x-linkedstore-hmac-sha256.

Een HTTP Request-node leest daarna GET /products/{{ $json.id }} met het token van de winkel. Een If-node gaat door wanneer visibility gelijk is aan visible en images niet leeg is, en een Remove Duplicates-node ingesteld op Remove Items Processed in Previous Executions laat een product dat al is geplaatst vallen, omdat Nuvemshop dezelfde melding twee keer kan sturen. Voor Instagram downloadt een HTTP Request-node de hoofdafbeelding als bestand, een Edit Image-node verkleint die met jpeg als Format, en een HTTP Request-node stuurt die als n8n Binary File naar POST /api/v1/media, wat een media_id teruggeeft. Eén HTTP Request per account roept daarna POST /api/v1/channels/<account_id>/posts aan.

1WebhookRaw Body on, Respond Immediately
2Crypto and IfHMAC-SHA256 against the header
3HTTP RequestGET the product, then its main image
4Edit ImageResized, Format jpeg, sent to POST /media
5HTTP RequestPOST /channels/:id/posts per account

Hoe plaatst een script producten zonder n8n?

Met een klein web-endpoint. De Python hieronder controleert de handtekening tegen de ruwe body met het clientgeheim van de app, antwoordt meteen met 200 en doet de rest op de achtergrond: het leest het product, slaat een product over dat niet zichtbaar is of geen foto heeft, en converteert de hoofdfoto met Pillow naar een JPEG van maximaal 1080 pixels per zijde, wat zowel Instagram als TikTok accepteert. Het uploadt dat bestand naar POST /media, plaatst het op Instagram en TikTok en maakt een linkpost op Facebook. Elke aanroep draagt een Idempotency-Key gemaakt van het product en het account, die easyCoexistence honoreert, en een lijst met geplaatste ID's voorkomt dat een herhaalde melding dubbel wordt geplaatst.

Python: post each new Nuvemshop product (pip install flask requests pillow)
import hashlib, hmac, io, os, threading
import requests
from flask import Flask, request
from PIL import Image

NS = f"https://api.nuvemshop.com.br/2025-03/{os.environ['NS_STORE_ID']}"
NS_HEADERS = {"Authorization": f"Bearer {os.environ['NS_ACCESS_TOKEN']}",
              "User-Agent": "Product posts (you@example.com)"}
EC = "https://easycoexistence.com/api/v1"
EC_AUTH = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"}  # ec_live_...
IG, TT, FB = os.environ["IG_ACCOUNT"], os.environ["TT_ACCOUNT"], os.environ["FB_ACCOUNT"]
LANG = os.environ.get("STORE_LANG", "pt")
posted, lock = set(), threading.Lock()  # a database in production
app = Flask(__name__)

@app.post("/nuvemshop/products")
def product_event():
    body = request.get_data()  # the raw body, before any parsing
    sig = hmac.new(os.environ["NS_CLIENT_SECRET"].encode(), body, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(sig, request.headers.get("x-linkedstore-hmac-sha256", "")):
        return "", 401
    threading.Thread(target=post_product, args=(request.get_json()["id"],)).start()
    return "", 200  # inside Nuvemshop's 3 seconds

def jpeg_media_id(src):
    img = Image.open(io.BytesIO(requests.get(src, timeout=30).content)).convert("RGB")
    img.thumbnail((1080, 1080))
    out = io.BytesIO()
    img.save(out, "JPEG", quality=90)
    r = requests.post(f"{EC}/media", data=out.getvalue(), timeout=60,
                      headers={**EC_AUTH, "Content-Type": "image/jpeg"})
    r.raise_for_status()
    return r.json()["media_id"]

def post_product(product_id):
    p = requests.get(f"{NS}/products/{product_id}", headers=NS_HEADERS, timeout=30).json()
    if p.get("visibility") != "visible" or not p.get("images"):
        return
    with lock:
        if product_id in posted:
            return
        posted.add(product_id)
    name, url = p["name"].get(LANG, ""), p["canonical_url"]
    main = min(p["images"], key=lambda i: i["position"])["src"]
    media = [{"media_id": jpeg_media_id(main), "type": "image"}]
    for account, post in [
        (IG, {"text": f"New in the shop: {name}. {url}", "media": media}),
        (TT, {"text": f"New in the shop: {name}", "title": name[:90], "media": media}),
        (FB, {"text": f"New in the shop: {name}", "link": {"url": url}}),
    ]:
        requests.post(f"{EC}/channels/{account}/posts", json=post, timeout=60,
                      headers={**EC_AUTH, "Idempotency-Key": f"nuvemshop-{product_id}-{account}"})

Hoe plaatsen Claude en ChatGPT producten op verzoek?

Met de eigen connector van Nuvemshop naast die van easyCoexistence. Het Helpcenter van Nuvemshop beschrijft een AI-connector gebouwd op MCP die werkt met Claude, met ChatGPT via de connectors en met editors zoals Cursor; in Claude wordt hij toegevoegd als aangepaste connector op https://admin-mcp.nuvemshop.com.br, en de leestools zoeken producten, bestellingen en klanten op. Vraag bijvoorbeeld: "Plaats onze vijf nieuwste producten vanaf morgen om 10.00 uur São Paulo-tijd op TikTok, één per uur, met bij elk een bijschrift." De assistent leest de producten, schrijft de bijschriften en plant elke post in met scheduled_at. Die handelt wanneer erom wordt gevraagd en houdt de winkel niet in de gaten tussen de gesprekken door, dus producten die 's nachts worden toegevoegd, gaan via de webhook de deur uit.

Wat accepteert elk netwerk in een productpost?

De regels van elk netwerk, met de eigen controles van easyCoexistence erbovenop, gelden zodra de post wordt verzonden of ingepland, dus een product dat niet mag worden geplaatst, wordt meteen geweigerd:

  • Instagram: alleen JPEG-afbeeldingen, dus zet een WebP- of PNG-productfoto eerst om; meerdere foto's maken een carrousel. Een post heeft geen linkveld, dus het adres van het product gaat als tekst in het bijschrift.
  • TikTok: fotoposts van 1 tot 35 JPG- of WebP-afbeeldingen, elk tot 1080 × 1920 of 1920 × 1080 pixels en 20 MB, een titel van 90 tekens, en 15 fotoposts per account per dag.
  • Facebook: een linkpost naar de canonical_url van het product, met de preview die Facebook bouwt uit de Open Graph-tags van de pagina, of één foto met het adres in de tekst.
  • Media via easyCoexistence: een HTTPS-link of een media_id van POST /media, met afbeeldingen tot 30 MB, gekopieerd op het moment dat een post wordt ingepland.
  • Bijschriften: de naam en beschrijving van Nuvemshop zijn objecten per taal, zoals pt of es, en de beschrijving is HTML, dus kies één taal en verwijder de tags.

Zo stel je het in

  1. Connect the store's accountsIn the easyCoexistence dashboard, connect the Instagram account, TikTok account and Facebook Page, note each account_id, and create a Partner API key under Profile, Developers.
  2. Create the Nuvemshop appIn the Partners Portal, create an app with read_products, install it in the store, and keep its access token, client secret and the store ID.
  3. Register the webhookCall POST /webhooks with product/created and your n8n Production URL or server address, then add a test product and check the posts.

Veelgemaakte fouten

  • Nuvemshop pas antwoorden nadat de posts zijn verstuurd. Het wacht 3 seconden op een 2XX en probeert dan opnieuw, tot 16 keer binnen 48 uur, dus antwoord eerst en plaats daarna.
  • De productfoto aan Instagram sturen zoals Nuvemshop die levert. Nuvemshop kan WebP leveren ongeacht de extensie van het adres, en Instagram publiceert alleen JPEG, dus controleer het Content-Type van het bestand en converteer het.
  • De handtekening verifiëren met het token van de winkel. Nuvemshop ondertekent met het clientgeheim van de app, over de ruwe body, dus bereken de HMAC voordat de body wordt geparseerd.
  • Een product plaatsen op het moment dat het wordt aangemaakt. Het kan verborgen of zonder foto's beginnen, dus controleer visibility en images, luister ook naar product/updated en plaats elk product één keer.
Dit doen met EasyCoexistence

easyCoexistence geeft je winkel, en de AI-agenten die die beheren, bereik bij klanten op Instagram, TikTok, Facebook en meer kanalen, elk via de officiële API: een posts-API en mediauploads voor n8n en je scripts, één MCP-connector voor Claude en ChatGPT naast die van Nuvemshop, en een wachtrij die tot 90 dagen vooruit publiceert, met elke verbinding 24/7 bewaakt. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Werkt het met Tiendanube-winkels?

Ja. Nuvemshop en Tiendanube delen één API: elk tiendanube.com-adres in de documentatie heeft een identiek adres op nuvemshop.com.br, en de API antwoordt op zowel api.tiendanube.com als api.nuvemshop.com.br.

Kan het een product opnieuw plaatsen wanneer het in de aanbieding gaat?

Ja. Luister ook naar product/updated en vergelijk de promotional_price van de varianten met de prijs waarmee je het laatst hebt geplaatst; de melding bevat het ID van het product, niet de details, dus lees het product elke keer opnieuw.

Wat doet het eigen Instagram- en Facebookkanaal van Nuvemshop?

Het koppelt de catalogus, Pixel en winkel van de winkel aan Meta voor verkoop op Instagram en Facebook, zoals het Helpcenter van Nuvemshop beschrijft, via Canais de venda in het admin-paneel. Deze flow plaatst voor elk nieuw product een feedpost.

Hoeveel kost easyCoexistence voor het plaatsen van Nuvemshop-producten?

US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, op elk netwerk gelijk. De posts-API, mediauploads en de MCP-connector zijn inbegrepen, met een gratis proefperiode van 3 dagen.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op