Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Julkaise uudet Nuvemshop- ja Tiendanube-tuotteet automaattisesti Instagramiin, TikTokiin ja Facebookiin

Nuvemshopin tai Tiendanuben sovelluksen product/created-webhook voi julkaista jokaisen uuden tuotteen Instagramiin, TikTokiin ja Facebookiin easyCoexistencen kautta: n8n tai lyhyt skripti hakee tuotteen, muuntaa sen pääkuvan JPEG-muotoon Instagramia varten ja lähettää tekstin, kuvan ja linkin easyCoexistencen posts-rajapintaan. Rajapinta julkaisee jokaisen verkoston virallisen API:n kautta, heti tai myöhemmin. Claude julkaisee tuotteita pyynnöstä Nuvemshopin oman liittimen avulla.

3 seconds

Kuinka kauan Nuvemshop odottaa 2XX-vastausta webhookiin ennen uudelleenyritystä, enintään 16 yritystä 48 tunnin sisällä.

store_id, event, id

Nuvemshopin tuotteen webhookin kentät: aikaleima ilman tuotetietoja, joten tuote luetaan GET /products/{id}-kutsulla.

x-linkedstore-hmac-sha256

Header, jossa kunkin webhookin HMAC-SHA256-allekirjoitus on, avaimena sovelluksen client secret eikä kaupan access token.

WebP

Kuvamuoto, jossa Nuvemshop voi tarjota tuotekuvat optimoinnin jälkeen, eikä API:ssa ole asetusta muunnoksen poistamiseen.

admin-mcp.nuvemshop.com.br

Osoite, jonka Nuvemshopin ohjekeskus antaa oman MCP-liittimensä lisäämiseen Claudeen mukautettuna liittimenä.

1080 × 1920

Suurin kuva, jonka TikTok-kuvajulkaisu hyväksyy: 1920 × 1080, JPG- tai WebP-muodossa, enintään 20 MB.

Miten uusi Nuvemshop-tuote muuttuu julkaisuksi?

Sovelluksen, webhookin ja yhden kutsun kautta tilikohtaisesti. Nuvemshopin webhookit kuuluvat sovellukseen, joten luo se read_products-oikeudella, asenna kauppaasi ja rekisteröi webhook product/created-tapahtumalle, joka osoittaa n8n-työnkulkuusi tai palvelimeesi. Ilmoitus sisältää kaupan ID:n, tapahtuman ja tuotteen ID:n mutta ei tuotetietoja, joten työnkulku lukee tuotteen GET /products/{id}-kutsulla, tarkistaa että se on näkyvissä ja että siinä on kuva, ja lähettää yhden pyynnön jokaiselle tilille easyCoexistencen posts-rajapintaan: kuvajulkaisun Instagramiin ja TikTokiin sekä linkkijulkaisun Facebookiin. easyCoexistence julkaisee jokaisen verkoston virallisen API:n kautta heti tai asettamasi publish_at-ajan mukaan.

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

Miten Nuvemshop-sovellus ja sen webhook asennetaan?

Kerran, Partners Portalista ja terminaalista. Rekisteröidy Nuvemshopin tai Tiendanuben kumppaniksi, luo sovellus Apps-kohdassa read_products-oikeudella, joka kattaa myös tuotekuvat ja muunnelmat, ja asenna se kauppaasi. Valtuutuskoodi, joka lähetetään uudelleenohjausosoitteeseesi, on voimassa 5 minuuttia ja vaihdetaan osoitteessa https://www.tiendanube.com/apps/authorize/token access tokeniin ja user_id:hen, joka on kaupan ID. Token ei vanhene ennen kuin saat uuden kyseiselle sovellukselle ja kaupalle tai sovellus poistetaan. Rekisteröi sitten webhook POST /webhooks -kutsulla. Jokainen pyyntö kantaa Authorization: Bearer -otsaketta tokenin kanssa ja User-Agent-otsaketta, joka nimeää sovelluksesi ja yhteystiedon, muuten Nuvemshop vastaa virheellä 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" }'

Mitä n8n-työnkulku tekee jokaiselle tuotteelle?

Vastaa, varmistaa, lukee, muuntaa ja julkaisee. Webhook-solmu, jossa Raw Body on päällä ja Respond on asetettuna arvoon Immediately, vastaa Nuvemshopin 3 sekunnin rajan sisällä. Extract From File -solmu muuntaa rungon tekstiksi, Crypto-solmu laskee sen HMAC-tiivisteen (SHA256, HEX) sovelluksen client secretillä, ja If-solmu jatkaa vain, jos tulos vastaa x-linkedstore-hmac-sha256-otsaketta.

HTTP Request -solmu lukee GET /products/{{ $json.id }} -kutsulla kaupan tokenilla. If-solmu jatkaa, kun visibility-kentän arvo on visible ja images ei ole tyhjä, ja Remove Duplicates -solmu, joka on asetettu Remove Items Processed in Previous Executions -tilaan, pudottaa jo julkaistun tuotteen, koska Nuvemshop voi lähettää saman ilmoituksen kahdesti. Instagramia varten HTTP Request -solmu lataa pääkuvan tiedostona, Edit Image -solmu muuntaa sen koon Format-kentässä jpeg-muotoon ja HTTP Request -solmu lähettää sen n8n Binary Fileena POST /api/v1/media -kutsulla, joka palauttaa media_id:n. Jokainen tili saa oman HTTP Request -kutsunsa POST /api/v1/channels/<account_id>/posts.

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

Miten skripti julkaisee tuotteet ilman n8n:ää?

Pienellä web-päätepisteellä. Alla oleva Python-koodi tarkistaa allekirjoituksen raakaan runkoon sovelluksen client secretillä, vastaa heti 200:lla ja tekee loput taustalla: se lukee tuotteen, ohittaa tuotteen, joka ei ole näkyvissä tai jolta puuttuu kuva, ja muuntaa pääkuvan Pillow-kirjastolla JPEG-tiedostoksi, jonka pisin sivu on enintään 1080 pikseliä, mitä sekä Instagram että TikTok hyväksyvät. Se lataa tiedoston POST /media-kutsulla, julkaisee sen Instagramiin ja TikTokiin ja tekee linkkijulkaisun Facebookiin. Jokainen kutsu kantaa Idempotency-Key-otsaketta, joka muodostuu tuotteesta ja tilistä ja jonka easyCoexistence huomioi, ja tallennetut ID:t estävät toistuvan ilmoituksen julkaisemasta kahdesti.

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}"})

Miten Claude ja ChatGPT julkaisevat tuotteita pyynnöstä?

Nuvemshopin oman liittimen avulla easyCoexistencen rinnalla. Nuvemshopin ohjekeskus kuvaa MCP-pohjaisen tekoälyliittimen, joka toimii Claudessa, ChatGPT:ssä liittimiensä kautta ja editoreissa kuten Cursorissa. Claudessa se lisätään mukautettuna liittimenä osoitteeseen https://admin-mcp.nuvemshop.com.br, ja sen lukutyökalut hakevat tuotteet, tilaukset ja asiakkaat. Pyydä esimerkiksi: ”Julkaise uusimmat viisi tuotettamme TikTokiin huomenna kello 10 São Paulon aikaa, yksi tunnissa, ja kuvateksti jokaiselle.” Avustaja lukee tuotteet, kirjoittaa kuvatekstit ja ajastaa jokaisen julkaisun scheduled_at-kentällä. Se toimii pyynnöstä eikä seuraa kauppaa keskustelujen välillä, joten yöllä lisätyt tuotteet menevät ulos webhookin kautta.

Mitä kukin verkosto hyväksyy tuotejulkaisussa?

Kunkin verkoston säännöt sekä easyCoexistencen omat tarkistukset tulevat voimaan, kun julkaisu lähetetään tai ajastetaan, joten tuote, jota ei voi julkaista, hylätään heti:

  • Instagram: vain JPEG-kuvat, joten muunna WebP- tai PNG-tuotekuva ensin; useat kuvat tekevät karusellin. Julkaisussa ei ole linkkikenttää, joten tuotteen osoite menee kuvatekstiin tekstinä.
  • TikTok: kuvajulkaisut, joissa on 1–35 JPG- tai WebP-kuvaa, kukin enintään 1080 × 1920 tai 1920 × 1080 pikseliä ja 20 MB, 90 merkin otsikko ja 15 kuvajulkaisua tiliä kohden päivässä.
  • Facebook: linkkijulkaisu tuotteen canonical_url-osoitteeseen Facebookin rakentamalla esikatselulla sivun Open Graph -tageista tai yksi kuva, jonka tekstissä on osoite.
  • Media easyCoexistencen kautta: HTTPS-linkki tai media_id POST /media-kutsusta, kuvat enintään 30 MB, kopioituna kun julkaisu ajastetaan.
  • Kuvatekstit: Nuvemshopin nimi ja kuvaus ovat kielikohtaisia objekteja, kuten pt tai es, ja kuvaus on HTML, joten valitse yksi kieli ja poista tagit.

Näin otat sen käyttöön

  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.

Yleiset virheet

  • Nuvemshopille vastaaminen vasta, kun julkaisut on lähetetty. Nuvemshop odottaa 2XX-vastausta 3 sekuntia ja yrittää sitten uudelleen enintään 16 kertaa 48 tunnin sisällä, joten vastaa ensin ja julkaise vasta sen jälkeen.
  • Tuotekuvan lähettäminen Instagramiin sellaisena kuin Nuvemshop sen tarjoaa. Nuvemshop voi toimittaa WebP-kuvan osoitteen päätteestä riippumatta, ja Instagram julkaisee vain JPEG-kuvia, joten tarkista tiedoston Content-Type ja muunna se.
  • Allekirjoituksen tarkistaminen kaupan access tokenilla. Nuvemshop allekirjoittaa sovelluksen client secretillä raakaan runkoon, joten laske HMAC ennen kuin runko jäsennetään.
  • Tuotteen julkaiseminen heti luomisen jälkeen. Se voi alkaa piilotettuna tai ilman kuvia, joten tarkista visibility ja images, kuuntele myös product/updated-tapahtumaa ja julkaise kukin tuote kerran.
Näin teet tämän EasyCoexistencen avulla

easyCoexistence antaa kaupallesi ja sitä ajaville tekoälyagenteille yhteyden asiakkaisiin Instagramissa, TikTokissa, Facebookissa ja useammissa kanavissa, kukin virallisen API:n kautta: posts-rajapinta ja median lataus n8n:lle ja skripteillesi, yksi MCP-liitin Claudelle ja ChatGPT:lle Nuvemshopin oman rinnalla sekä jono, joka julkaisee 90 päivää etukäteen, ja jokaista yhteyttä valvotaan 24/7. Alkaen US$ 9 per yhteys kuukaudessa, laskien US$ 0.75:een yhteyksiä lisättäessä, ja ensimmäiset 3 päivää ovat ilmaista kokeilua.

Usein kysytyt kysymykset

Toimiiko se Tiendanube-kaupoilla?

Toimii. Nuvemshop ja Tiendanube jakavat yhden API:n: jokainen tiendanube.com-osoite dokumentaatiossa on samanlainen nuvemshop.com.br-osoite, ja API vastaa sekä osoitteessa api.tiendanube.com että api.nuvemshop.com.br.

Voiko se julkaista tuotteen uudelleen, kun se menee alennukseen?

Voi. Kuuntele myös product/updated-tapahtumaa ja vertaa muunnelmien promotional_price-hintaa viimeksi julkaistuun. Ilmoitus sisältää tuotteen ID:n, ei sen tietoja, joten lue tuote joka kerta.

Mitä Nuvemshopin oma Instagram- ja Facebook-kanava tekee?

Se yhdistää kaupan katalogin, Pixelin ja kaupan Metaan myyntiin Instagramissa ja Facebookissa, kuten Nuvemshopin ohjekeskus kuvaa, hallinnan Canais de venda -kohdasta. Tämä kulku julkaisee syötejulkaisun jokaisesta uudesta tuotteesta.

Paljonko easyCoexistence maksaa Nuvemshop-tuotteiden julkaisusta?

Alkaen US$ 9 ja laskien US$ 0.75:een per yhteys kuukaudessa, kun yhteyksiä lisätään, sama hinta kaikissa verkostoissa. Posts API, median lataus ja MCP-liitin sisältyvät, ja ensimmäiset 3 päivää ovat ilmaista kokeilua.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu