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.
Koliko dugo Nuvemshop čeka odgovor 2XX na webhook prije ponovnog pokušaja, do 16 pokušaja unutar 48 sati.
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}.
Zaglavlje s HMAC-SHA256 potpisom svakog webhooka, ključ je klijentska tajna aplikacije, a ne pristupni token trgovine.
Format u kojem Nuvemshop može poslužiti slike proizvoda nakon optimizacije, bez opcije u API-ju za isključivanje pretvorbe.
Adresa koju Nuvemshopov Help Center navodi za dodavanje vlastitog MCP konektora Claudeu kao prilagođeni konektor.
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.
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.
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.
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.
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_urlproizvoda, s pregledom koji Facebook gradi iz Open Graph oznaka stranice, ili jedna fotografija s adresom u tekstu. - Mediji kroz easyCoexistence: HTTPS poveznica ili
media_idiz 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
- 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.
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.
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