Postează automat produsele noi din Nuvemshop și Tiendanube pe Instagram, TikTok și Facebook
Webhook-ul product/created al unei aplicații Nuvemshop sau Tiendanube poate posta fiecare produs nou pe Instagram, TikTok și Facebook prin easyCoexistence: n8n sau un script scurt preia produsul, convertește fotografia principală în JPEG pentru Instagram și trimite textul, fotografia și linkul către API-ul de postări al easyCoexistence, care publică prin API-ul oficial al fiecărei rețele, acum sau mai târziu. Claude postează produse la cerere, cu conectorul propriu Nuvemshop.
Cât timp așteaptă Nuvemshop un răspuns 2XX la un webhook înainte să reîncerce, până la 16 încercări în 48 de ore.
Câmpurile pe care le transmite un webhook de produs Nuvemshop, cu o marcă temporală și fără detalii despre produs, astfel încât produsul se citește cu GET /products/{id}.
Antetul care conține semnătura HMAC-SHA256 a fiecărui webhook, cheia fiind secretul clientului aplicației, nu token-ul de acces al magazinului.
Formatul în care Nuvemshop poate servi imaginile produselor după optimizare, fără nicio opțiune API pentru dezactivarea conversiei.
Adresa pe care o indică Centrul de ajutor Nuvemshop pentru adăugarea propriului conector MCP în Claude ca tip de conector personalizat.
Cea mai mare imagine acceptată de o postare foto TikTok, 1920 × 1080, în JPG sau WebP de până la 20 MB.
Cum devine un produs nou din Nuvemshop o postare?
Printr-o aplicație, un webhook și un apel per cont. Webhook-urile Nuvemshop aparțin unei aplicații, așa că creați una cu scope-ul read_products, instalați-o în magazin și înregistrați un webhook pentru product/created care indică spre fluxul n8n sau serverul dumneavoastră. Notificarea conține ID-ul magazinului, evenimentul și ID-ul produsului, fără detalii despre produs, așa că fluxul citește produsul cu GET /products/{id}, verifică dacă este vizibil și are o fotografie și trimite o cerere per cont către API-ul de postări al easyCoexistence: o postare foto pentru Instagram și TikTok, o postare cu link pentru Facebook. easyCoexistence publică fiecare dintre ele prin API-ul oficial al rețelei, imediat sau la publish_at pe care îl setați.
Cum configurați aplicația Nuvemshop și webhook-ul ei?
O singură dată, din Partners Portal și dintr-un terminal. Înregistrați-vă ca partener Nuvemshop sau Tiendanube, creați o aplicație din secțiunea Apps cu read_products, care acoperă și imaginile și variantele produselor, și instalați-o în magazin. Codul de autorizare trimis la URL-ul de redirecționare este valabil 5 minute și se schimbă la https://www.tiendanube.com/apps/authorize/token cu un token de acces și cu un user_id, adică ID-ul magazinului. Token-ul nu expiră până nu se obține unul nou pentru aplicația și magazinul respective sau până când aplicația este dezinstalată. Apoi înregistrați webhook-ul cu POST /webhooks. Fiecare cerere transmite Authorization: Bearer cu token-ul și un User-Agent care numește aplicația și un contact, altfel Nuvemshop răspunde cu 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" }'Ce face fluxul n8n cu fiecare produs?
Răspunde, verifică, citește, convertește și postează. Un nod Webhook cu Raw Body activat și Respond setat pe Immediately răspunde în limita de 3 secunde a Nuvemshop. Un nod Extract From File transformă corpul în text, un nod Crypto calculează HMAC cu SHA256 și HEX, cheia fiind secretul clientului aplicației, iar un nod If lasă execuția să continue doar dacă rezultatul este egal cu antetul x-linkedstore-hmac-sha256.
Un nod HTTP Request citește apoi GET /products/{{ $json.id }} cu token-ul magazinului. Un nod If continuă când visibility este visible și images nu este gol, iar un nod Remove Duplicates setat pe Remove Items Processed in Previous Executions elimină un produs deja postat, deoarece Nuvemshop poate trimite aceeași notificare de două ori. Pentru Instagram, un nod HTTP Request descarcă imaginea principală ca fișier, un nod Edit Image o redimensionează cu jpeg ca Format, iar un nod HTTP Request o trimite ca n8n Binary File către POST /api/v1/media, care returnează un media_id. Câte un nod HTTP Request per cont apelează POST /api/v1/channels/<account_id>/posts.
Cum postează un script produse fără n8n?
Cu un endpoint web simplu. Scriptul Python de mai jos verifică semnătura față de corpul brut, cu secretul clientului aplicației, răspunde imediat cu 200 și face restul în fundal: citește produsul, omite unul care nu este vizibil sau nu are fotografie, iar fotografia principală o convertește cu Pillow într-un JPEG de cel mult 1080 pixeli pe latură, format pe care Instagram și TikTok îl acceptă amândouă. Încarcă acel fișier în POST /media, îl postează pe Instagram și TikTok și face o postare cu link pe Facebook. Fiecare apel poartă un Idempotency-Key format din produs și din cont, pe care easyCoexistence îl respectă, iar un set de ID-uri postate împiedică o notificare repetată să posteze de două ori.
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}"})Cum postează Claude și ChatGPT produse la cerere?
Cu conectorul propriu Nuvemshop, alături de cel al easyCoexistence. Centrul de ajutor Nuvemshop descrie un conector AI construit pe MCP, care funcționează cu Claude, cu ChatGPT prin conectorii săi și cu editoare precum Cursor. În Claude se adaugă ca tip de conector personalizat la https://admin-mcp.nuvemshop.com.br, iar instrumentele sale de citire caută produse, comenzi și clienți. Cereți, de exemplu: „Postează cele mai noi cinci produse ale noastre pe TikTok începând de mâine, la ora 10 dimineața, ora São Paulo, câte unul pe oră, cu o legendă pentru fiecare.” Asistentul citește produsele, scrie legendele și programează fiecare postare cu scheduled_at. Acționează când i se cere și nu urmărește magazinul între conversații, așa că produsele adăugate peste noapte pleacă prin webhook.
Ce acceptă fiecare rețea într-o postare cu produs?
Regulile fiecărei rețele, plus verificările proprii ale easyCoexistence, se aplică la trimiterea sau programarea postării, așa că un produs care nu poate pleca este refuzat pe loc:
- Instagram: doar imagini JPEG, deci convertiți întâi o fotografie de produs WebP sau PNG; mai multe fotografii formează un carusel. O postare nu are câmp pentru link, așa că adresa produsului intră în legendă, ca text.
- TikTok: postări foto de la 1 la 35 de imagini JPG sau WebP, fiecare de până la 1080 × 1920 sau 1920 × 1080 pixeli și 20 MB, un titlu de 90 de caractere și 15 postări foto pe cont pe zi.
- Facebook: o postare cu link către
canonical_urlal produsului, cu previzualizarea construită de Facebook din etichetele Open Graph ale paginii, sau o fotografie cu adresa în text. - Media prin easyCoexistence: un link HTTPS sau un
media_idde la POST /media, cu imagini de până la 30 MB, copiate când se programează postarea. - Legende: numele și descrierea produsului sunt obiecte indexate după limbă, precum pt sau es, iar descrierea este HTML, deci alegeți o singură limbă și eliminați etichetele.
Cum să îl configurați
- 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.
Greșeli frecvente
- Răspunsul către Nuvemshop vine după ce au plecat postările. Aceasta așteaptă 3 secunde un răspuns 2XX, apoi reîncearcă de până la 16 ori în 48 de ore, deci răspundeți mai întâi și postați după aceea.
- Trimiterea către Instagram a fotografiei produsului așa cum o servește Nuvemshop. Nuvemshop poate livra WebP indiferent de terminația adresei, iar Instagram publică doar JPEG, deci verificați Content-Type al fișierului și convertiți-l.
- Verificarea semnăturii cu token-ul de acces al magazinului. Nuvemshop semnează cu secretul clientului aplicației, peste corpul brut, deci calculați HMAC înainte ca corpul să fie analizat.
- Postarea unui produs în clipa în care este creat. Acesta poate porni ascuns sau fără fotografii, așa că verificați vizibilitatea și imaginile, ascultați și product/updated și postați fiecare produs o singură dată.
easyCoexistence oferă magazinului și agenților AI care îl administrează acces la clienți pe Instagram, TikTok, Facebook și alte canale, fiecare prin API-ul său oficial: un API de postări și încărcare media pentru n8n și scripturile proprii, un conector MCP pentru Claude și ChatGPT alături de cel Nuvemshop și o coadă care publică până la 90 de zile înainte, cu fiecare conexiune monitorizată 24/7. De la US$ 9 până la US$ 0,75 per conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Funcționează cu magazinele Tiendanube?
Da. Nuvemshop și Tiendanube au un singur API: fiecare adresă tiendanube.com din documentație are una identică pe nuvemshop.com.br, iar API-ul răspunde atât pe api.tiendanube.com, cât și pe api.nuvemshop.com.br.
Poate fi postat din nou un produs când intră în reducere?
Da. Ascultați și product/updated și comparați promotional_price al variantelor cu cel postat ultima dată; notificarea conține ID-ul produsului, nu detaliile lui, așa că citiți produsul de fiecare dată.
Ce face canalul propriu Nuvemshop pentru Instagram și Facebook?
Conectează catalogul, Pixel-ul și magazinul la Meta pentru vânzare pe Instagram și Facebook, așa cum descrie Centrul de ajutor Nuvemshop, din Canais de venda din admin. Acest flux publică o postare în feed pentru fiecare produs nou.
Cât costă easyCoexistence pentru postarea produselor Nuvemshop?
De la US$ 9 până la US$ 0,75 per conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, același pe fiecare rețea. API-ul de postări, încărcarea media și conectorul MCP sunt incluse, cu primele 3 zile gratuite.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la