Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Automatski objavljujte nove proizvode iz Nuvemshopa i Tiendanube na Instagram, TikTok i Facebook

Webhook product/created iz aplikacije Nuvemshop ili Tiendanube može objaviti svaki novi proizvod na Instagram, TikTok i Facebook putem easyCoexistence: n8n ili kratka skripta dohvaća proizvod, pretvara njegovu glavnu fotografiju u JPEG za Instagram i šalje tekst, fotografiju i poveznicu na API za objave easyCoexistence, koji objavljuje putem službenog API-ja svake mreže, odmah ili kasnije. Claude objavljuje proizvode na zahtjev pomoću vlastitog konektora Nuvemshopa.

3 seconds

Koliko dugo Nuvemshop čeka odgovor 2XX na webhook prije ponovnog pokušaja, do 16 pokušaja unutar 48 sati.

store_id, event, id

Polja koja Nuvemshopov webhook za proizvod sadrži, uz vremensku oznaku i bez pojedinosti o proizvodu, pa se proizvod čita pomoću GET /products/{id}.

x-linkedstore-hmac-sha256

Zaglavlje s HMAC-SHA256 potpisom svakog webhooka, ključ je klijentska tajna aplikacije, a ne pristupni token trgovine.

WebP

Format u kojem Nuvemshop može poslužiti slike proizvoda nakon optimizacije, bez opcije u API-ju za isključivanje pretvorbe.

admin-mcp.nuvemshop.com.br

Adresa koju Nuvemshopov Help Center navodi za dodavanje vlastitog MCP konektora Claudeu kao prilagođeni konektor.

1080 × 1920

Najveća slika za objavu s fotografijama na TikToku je 1920 × 1080, kao JPG ili WebP do 20 MB.

Kako novi proizvod iz Nuvemshopa postaje objava?

Kroz aplikaciju, webhook i jedan poziv po računu. Webhookovi Nuvemshopa pripadaju aplikaciji, pa je napravite s opsegom read_products, instalirajte je u svojoj trgovini i registrirajte webhook za product/created koji upućuje na vaš n8n workflow ili poslužitelj. Obavijest sadrži ID trgovine, događaj i ID proizvoda, bez pojedinosti o proizvodu, pa workflow čita proizvod pomoću GET /products/{id}, provjerava je li vidljiv i ima li fotografiju te šalje jedan zahtjev po računu API-ju za objave easyCoexistence: objavu s fotografijom za Instagram i TikTok, objavu s poveznicom za Facebook. easyCoexistence objavljuje svaku putem službenog API-ja mreže, odmah ili u publish_at koju postavite.

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

Kako postavljate aplikaciju Nuvemshop i njezin webhook?

Jednom, iz Partners Portala i terminala. Registrirajte se kao Nuvemshop ili Tiendanube partner, napravite aplikaciju u odjeljku Apps s read_products, koji obuhvaća i slike proizvoda i varijante, te je instalirajte u svojoj trgovini. Autorizacijski kôd poslan na vaš URL za preusmjeravanje vrijedi 5 minuta i razmjenjuje se na https://www.tiendanube.com/apps/authorize/token za pristupni token i user_id, ID trgovine; token ne istječe dok ne dobijete novi za tu aplikaciju i trgovinu ili dok se aplikacija ne deinstalira. Zatim registrirajte webhook pomoću POST /webhooks. Svaki zahtjev nosi Authorization: Bearer s tokenom i User-Agent s imenom vaše aplikacije i kontaktom, inače Nuvemshop odgovara s 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" }'

Što n8n workflow radi sa svakim proizvodom?

Odgovara, provjerava, čita, pretvara i objavljuje. Webhook čvor s uključenim Raw Body i Respond postavljenim na Immediately odgovara unutar Nuvemshopovih 3 sekunde. Čvor Extract From File pretvara tijelo u tekst, čvor Crypto računa njegov Hmac pomoću SHA256 i HEX, s klijentskom tajnom aplikacije kao ključem, a čvor If nastavlja izvođenje samo ako je rezultat jednak zaglavlju x-linkedstore-hmac-sha256.

Zatim čvor HTTP Request čita GET /products/{{ $json.id }} s tokenom trgovine. Čvor If nastavlja kad je visibility jednak visible i images nije prazan, a čvor Remove Duplicates postavljen na Remove Items Processed in Previous Executions odbacuje proizvod koji je već objavljen, jer Nuvemshop može poslati istu obavijest dvaput. Za Instagram čvor HTTP Request preuzima glavnu sliku kao datoteku, čvor Edit Image mijenja joj veličinu uz jpeg kao Format, a čvor HTTP Request šalje je kao n8n Binary File na POST /api/v1/media, što vraća media_id. Jedan HTTP Request po računu zatim poziva 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

Kako skripta objavljuje proizvode bez n8n-a?

Pomoću malog web endpointa. Python u nastavku provjerava potpis naspram sirovog tijela s klijentskom tajnom aplikacije, odmah odgovara 200 i ostatak obavlja u pozadini: čita proizvod, preskače onaj koji nije vidljiv ili nema fotografiju te glavnu fotografiju pretvara pomoću Pillow u JPEG najviše 1080 piksela po stranici, što prihvaćaju i Instagram i TikTok. Datoteku učitava na POST /media, objavljuje je na Instagramu i TikToku, a na Facebooku objavljuje objavu s poveznicom. Svaki poziv nosi Idempotency-Key napravljen od proizvoda i računa, koji easyCoexistence poštuje, a skup objavljenih ID-jeva sprječava da ponovljena obavijest objavi dvaput.

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

Kako Claude i ChatGPT objavljuju proizvode na zahtjev?

Vlastitim konektorom Nuvemshopa uz easyCoexistence. Help Center Nuvemshopa opisuje AI konektor izgrađen na MCP-u koji radi s Claudeom, s ChatGPT-jem preko njegovih konektora i s uređivačima poput Cursora; u Claudeu se dodaje kao prilagođeni konektor na https://admin-mcp.nuvemshop.com.br, a njegovi alati za čitanje traže proizvode, narudžbe i kupce. Zatražite, na primjer: »Objavi pet najnovijih proizvoda na TikTok od sutra u 10 sati po vremenu u São Paulu, jedan na sat, s opisom za svaki.« Asistent čita proizvode, piše opise i zakazuje svaku objavu pomoću scheduled_at. Djeluje kad ga zatražite i ne prati trgovinu između razgovora, pa proizvodi dodani preko noći odlaze putem webhooka.

Što prihvaća svaka mreža u objavi proizvoda?

Pravila svake mreže, uz vlastite provjere easyCoexistence, primjenjuju se pri slanju ili zakazivanju objave, pa proizvod koji ne može otići biva odmah odbijen:

  • Instagram: samo JPEG slike, pa prvo pretvorite WebP ili PNG fotografiju proizvoda; više fotografija čini karusel. Objava nema polje za poveznicu, pa se adresa proizvoda stavlja u opis kao tekst.
  • TikTok: objave s fotografijama od 1 do 35 JPG ili WebP slika, svaka do 1080 × 1920 ili 1920 × 1080 piksela i 20 MB, naslov od 90 znakova i 15 objava s fotografijama po računu dnevno.
  • Facebook: objava s poveznicom na canonical_url proizvoda, s pregledom koji Facebook gradi iz Open Graph oznaka stranice, ili jedna fotografija s adresom u tekstu.
  • Mediji kroz easyCoexistence: HTTPS poveznica ili media_id iz POST /media, sa slikama do 30 MB, kopirani pri zakazivanju objave.
  • Opisi: naziv i opis Nuvemshopa su objekti s ključem po jeziku, poput pt ili es, a opis je HTML, pa odaberite jedan jezik i uklonite oznake.

Kako ga postaviti

  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.

Uobičajene pogreške

  • Odgovaranje Nuvemshopu nakon što objave izađu. Čeka 3 sekunde na 2XX, a zatim ponavlja pokušaj do 16 puta u 48 sati, pa prvo odgovorite, a objave šaljite poslije.
  • Slanje Instagramu fotografije proizvoda kako je Nuvemshop poslužuje. Nuvemshop može isporučiti WebP bez obzira na to kako adresa završava, a Instagram objavljuje samo JPEG, pa provjerite Content-Type datoteke i pretvorite je.
  • Provjeravanje potpisa pristupnim tokenom trgovine. Nuvemshop potpisuje klijentskom tajnom aplikacije nad sirovim tijelom, pa HMAC izračunajte prije nego što se tijelo parsira.
  • Objavljivanje proizvoda čim je stvoren. Može početi sakriven ili bez fotografija, pa provjerite vidljivost i slike, slušajte i product/updated te svaki proizvod objavite jednom.
Radite ovo uz EasyCoexistence

easyCoexistence trgovini i AI agentima koji je vode daje doseg do kupaca na Instagramu, TikToku, Facebooku i još kanala, svakom putem njegova službenog API-ja: API za objave i učitavanje medija za n8n i vaše skripte, jedan MCP konektor za Claude i ChatGPT uz Nuvemshopov vlastiti te red koji objavljuje do 90 dana unaprijed, uz praćenje svake veze 24/7. US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, s besplatnim probnim razdobljem od 3 dana.

Često postavljana pitanja

Radi li s trgovinama Tiendanube?

Da. Nuvemshop i Tiendanube dijele jedan API: svaka adresa tiendanube.com u dokumentaciji ima istovjetnu na nuvemshop.com.br, a API odgovara i na api.tiendanube.com i na api.nuvemshop.com.br.

Može li ponovno objaviti proizvod kad ide u akciju?

Može. Slušajte i product/updated te usporedite promotional_price varijanti s onom koju ste zadnji put objavili; obavijest nosi ID proizvoda, a ne njegove pojedinosti, pa proizvod čitajte svaki put.

Što radi vlastiti Instagram i Facebook kanal Nuvemshopa?

Povezuje katalog, Pixel i trgovinu s Metom za prodaju na Instagramu i Facebooku, kako opisuje Help Center Nuvemshopa, iz Canais de venda u administraciji. Ovaj tijek objavljuje objavu u feedu za svaki novi proizvod.

Koliko košta easyCoexistence za objavu Nuvemshop proizvoda?

US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, jednako na svakoj mreži. API za objave, učitavanje medija i MCP konektor su uključeni, uz besplatno probno razdoblje od 3 dana.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na