Automatski objavljujte nove proizvode iz Nuvemshop i Tiendanube na Instagram, TikTok i Facebook
Webhook za product/created u aplikaciji Nuvemshop ili Tiendanube može da objavi svaki novi proizvod na Instagram, TikTok i Facebook preko easyCoexistence: n8n ili kratka skripta preuzima proizvod, pretvara njegovu glavnu fotografiju u JPEG za Instagram i šalje tekst, fotografiju i link na posts API easyCoexistence, koji objavljuje preko zvaničnog API-ja svake mreže, odmah ili kasnije. Claude objavljuje proizvode na zahtev preko sopstvenog konektora Nuvemshop.
Koliko Nuvemshop čeka odgovor 2XX na webhook pre ponovnog slanja, do 16 pokušaja u roku od 48 sati.
Polja koja nosi webhook za proizvod Nuvemshop, sa vremenskom oznakom i bez podataka o proizvodu, pa se proizvod čita preko GET /products/{id}.
Zaglavlje u kom je HMAC-SHA256 potpis svakog webhooka, sa ključem klijentske tajne aplikacije, a ne tokenom za pristup prodavnice.
Format u kom Nuvemshop može da isporučuje slike proizvoda posle optimizacije, bez API opcije da se konverzija isključi.
Adresa koju Centar za pomoć Nuvemshop navodi za dodavanje sopstvenog MCP konektora u Claude kao prilagođeni konektor.
Najveća slika koju prima objava fotografija na TikToku, odnosno 1920 × 1080, kao JPG ili WebP do 20 MB.
Kako novi proizvod iz Nuvemshop postaje objava?
Kroz aplikaciju, webhook i jedan poziv po nalogu. Webhookovi Nuvemshop pripadaju aplikaciji, pa napravite jednu sa dozvolom read_products, instalirajte je u svojoj prodavnici i registrujte webhook za product/created koji pokazuje na vaš n8n tok ili server. Obaveštenje sadrži ID prodavnice, događaj i ID proizvoda, bez podataka o proizvodu, pa tok čita proizvod preko GET /products/{id}, proverava da je vidljiv i da ima fotografiju i šalje jedan zahtev po nalogu na posts API easyCoexistence: objavu sa fotografijom za Instagram i TikTok, objavu sa linkom za Facebook. easyCoexistence objavljuje svaku preko zvaničnog API-ja te mreže, odmah ili u publish_at koji podesite.
Kako podešavate aplikaciju Nuvemshop i njen webhook?
Jednom, iz Partners Portala i terminala. Registrujte se kao Nuvemshop ili Tiendanube partner, napravite aplikaciju u odeljku Apps sa dozvolom read_products, koja pokriva i slike proizvoda i varijante, i instalirajte je u svojoj prodavnici. Autorizacioni kod koji stigne na vaš URL za preusmeravanje važi 5 minuta i razmenjuje se na https://www.tiendanube.com/apps/authorize/token za pristupni token i user_id, ID prodavnice; token ne ističe dok ne dobijete novi za tu aplikaciju i prodavnicu ili dok se aplikacija ne deinstalira. Zatim registrujte webhook pomoću POST /webhooks. Svaki zahtev nosi Authorization: Bearer sa tokenom i User-Agent sa imenom vaše aplikacije i kontaktom, inače Nuvemshop odgovara sa 400.
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" }'Šta n8n tok radi sa svakim proizvodom?
Odgovara, proverava, čita, konvertuje i objavljuje. Webhook čvor sa uključenim Raw Body i Respond postavljenim na Immediately odgovara u okviru 3 sekunde koliko Nuvemshop dozvoljava. Čvor Extract From File pretvara telo u tekst, Crypto čvor računa njegov Hmac sa SHA256 i HEX, sa ključem klijentske tajne aplikacije, a If čvor dozvoljava da tok nastavi samo ako je rezultat jednak zaglavlju x-linkedstore-hmac-sha256.
Zatim HTTP Request čvor čita GET /products/{{ $json.id }} sa tokenom prodavnice. If čvor nastavlja kad je visibility jednako 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 da pošalje isto obaveštenje dvaput. Za Instagram HTTP Request čvor preuzima glavnu sliku kao fajl, čvor Edit Image menja veličinu sa jpeg kao Format, a HTTP Request čvor je šalje kao n8n Binary File na POST /api/v1/media, koji vraća media_id. Jedan HTTP Request po nalogu zatim poziva POST /api/v1/channels/<account_id>/posts.
Kako skripta objavljuje proizvode bez n8n?
Uz mali veb endpoint. Python kod ispod proverava potpis nad sirovim telom sa klijentskom tajnom aplikacije, odmah odgovara sa 200 i ostatak radi u pozadini: čita proizvod, preskače onaj koji nije vidljiv ili nema fotografiju i konvertuje glavnu fotografiju pomoću Pillow u JPEG najviše 1080 piksela po stranici, što prihvataju i Instagram i TikTok. Šalje tu datoteku na POST /media, objavljuje je na Instagramu i TikToku i pravi objavu sa linkom na Facebooku. Svaki poziv nosi Idempotency-Key napravljen od proizvoda i naloga, koji easyCoexistence poštuje, a skup objavljenih ID-jeva sprečava da se ponovljeno obaveštenje objavi dvaput.
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 zahtev?
Sopstvenim konektorom Nuvemshop uz easyCoexistence. Centar za pomoć Nuvemshop opisuje AI konektor zasnovan na MCP-u koji radi sa Claudeom, sa ChatGPT-jem preko njegovih konektora i sa uređivačima kao što je Cursor; u Claudeu se dodaje kao prilagođeni konektor na https://admin-mcp.nuvemshop.com.br, a njegovi alati za čitanje pretražuju proizvode, porudžbine i kupce. Pitajte, na primer: „Objavite naših pet najnovijih proizvoda na TikToku od sutra u 10 sati po vremenu São Paula, jedan na sat, sa opisom za svaki.” Asistent čita proizvode, piše opise i zakazuje svaku objavu pomoću scheduled_at. Radi kad ga zamolite i ne prati prodavnicu između razgovora, pa proizvodi dodati preko noći idu kroz webhook.
Šta svaka mreža prihvata u objavi proizvoda?
Pravila svake mreže, uz sopstvene provere easyCoexistence, primenjuju se kad se objava pošalje ili zakaže, pa se proizvod koji ne može da se objavi odmah odbija:
- Instagram: samo JPEG slike, pa prvo pretvorite WebP ili PNG fotografiju proizvoda; više fotografija pravi karusel. Objava nema polje za link, pa se adresa proizvoda stavlja u opis kao tekst.
- TikTok: objave fotografija 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 fotografija po nalogu dnevno.
- Facebook: objava sa linkom na
canonical_urlproizvoda, sa pregledom koji Facebook pravi iz Open Graph oznaka stranice, ili jedna fotografija sa adresom u tekstu. - Mediji preko easyCoexistence: HTTPS link ili
media_idiz POST /media, sa slikama do 30 MB, koji se kopiraju kad se objava zakaže. - Opisi: naziv i opis proizvoda Nuvemshop su objekti po jeziku, kao pt ili es, a opis je HTML, pa izaberite jedan jezik i uklonite oznake.
Kako da podesite
- 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.
- 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.
- 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.
Česte greške
- Odgovaranje Nuvemshopu tek posle objavljivanja. Nuvemshop čeka 3 sekunde na 2XX, zatim ponovo šalje do 16 puta u 48 sati, pa prvo odgovorite, a objavljujte posle.
- Slanje Instagramu fotografije proizvoda onako kako je Nuvemshop isporučuje. Nuvemshop može da isporuči WebP bez obzira na ekstenziju adrese, a Instagram objavljuje samo JPEG, pa proverite Content-Type datoteke i konvertujte je.
- Provera potpisa tokenom za pristup prodavnice. Nuvemshop potpisuje klijentskom tajnom aplikacije, nad sirovim telom, pa računajte HMAC pre nego što se telo parsira.
- Objavljivanje proizvoda čim je kreiran. Može da počne kao skriven ili bez fotografija, zato proverite vidljivost i slike, slušajte i product/updated i objavite svaki proizvod samo jednom.
easyCoexistence daje vašoj prodavnici i AI agentima koji njome upravljaju doseg do kupaca na Instagramu, TikToku, Facebooku i još kanala, svakom preko zvaničnog API-ja: posts API i otpremanje medija za n8n i vaše skripte, jedan MCP konektor za Claude i ChatGPT uz sopstveni Nuvemshop konektor, i red koji objavljuje do 90 dana unapred, uz praćenje svake veze 24/7. US$ 9 do US$ 0,75 po vezi mesečno, što pada kako dodajete veze, uz prva 3 dana besplatno.
Često postavljana pitanja
Da li radi sa Tiendanube prodavnicama?
Da. Nuvemshop i Tiendanube dele jedan API: svaka adresa tiendanube.com u dokumentaciji ima istovetnu na nuvemshop.com.br, a API odgovara i na api.tiendanube.com i na api.nuvemshop.com.br.
Može li ponovo da objavi proizvod kad ide na popust?
Može. Slušajte i product/updated i uporedite promotional_price varijanti sa onom koju ste poslednji put objavili; obaveštenje nosi ID proizvoda, a ne njegove podatke, pa proizvod čitajte svaki put.
Šta radi sopstveni Instagram i Facebook kanal Nuvemshop?
Povezuje katalog, Pixel i shop sa Metom za prodaju na Instagramu i Facebooku, kako opisuje Centar za pomoć Nuvemshop, iz odeljka Canais de venda u admin panelu. Ovaj tok objavljuje objavu u feedu za svaki novi proizvod.
Koliko košta easyCoexistence za objavljivanje Nuvemshop proizvoda?
US$ 9 do US$ 0,75 po vezi mesečno, što pada kako dodajete veze, isto na svakoj mreži. Posts API, otpremanje medija i MCP konektor su uključeni, uz prva 3 dana besplatno.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na