नए Nuvemshop और Tiendanube प्रोडक्ट Instagram, TikTok और Facebook पर अपने-आप पोस्ट करें
Nuvemshop या Tiendanube ऐप का product/created वेबहुक हर नया प्रोडक्ट easyCoexistence के ज़रिए Instagram, TikTok और Facebook पर पोस्ट कर सकता है: n8n या एक छोटी स्क्रिप्ट प्रोडक्ट लाती है, उसकी मुख्य फ़ोटो को Instagram के लिए JPEG में बदलती है, और टेक्स्ट, फ़ोटो व लिंक easyCoexistence के posts एपीआई को भेजती है, जो हर नेटवर्क के आधिकारिक एपीआई से अभी या बाद में पब्लिश करता है। Claude अनुरोध पर Nuvemshop के अपने कनेक्टर से प्रोडक्ट पोस्ट करता है।
किसी वेबहुक के 2XX जवाब का Nuvemshop कितनी देर इंतज़ार करता है, इससे पहले कि दोबारा कोशिश करे: 48 घंटों के भीतर 16 प्रयास तक।
Nuvemshop के प्रोडक्ट वेबहुक में जो फ़ील्ड होते हैं, उनमें टाइमस्टैम्प है और प्रोडक्ट का कोई विवरण नहीं, इसलिए प्रोडक्ट GET /products/{id} से पढ़ा जाता है।
वह हेडर जिसमें हर वेबहुक का HMAC-SHA256 सिग्नेचर होता है, जो स्टोर के एक्सेस टोकन से नहीं, बल्कि ऐप के क्लाइंट सीक्रेट से बनता है।
वह फ़ॉर्मैट जिसमें Nuvemshop ऑप्टिमाइज़ेशन के बाद प्रोडक्ट इमेज दे सकता है, और इस रूपांतरण को बंद करने का कोई एपीआई विकल्प नहीं है।
वह पता जो Nuvemshop का Help Center बताता है, जिससे अपना MCP कनेक्टर Claude में कस्टम कनेक्टर के रूप में जोड़ा जाए।
TikTok फ़ोटो पोस्ट जो सबसे बड़ी इमेज लेती है, वह 1920 × 1080 है, JPG या WebP में, 20 MB तक।
नया Nuvemshop प्रोडक्ट पोस्ट में कैसे बदलता है?
एक ऐप, एक वेबहुक और हर खाते के लिए एक कॉल से। Nuvemshop के वेबहुक एक ऐप से जुड़े होते हैं, इसलिए read_products स्कोप के साथ एक ऐप बनाएँ, उसे अपने स्टोर में इंस्टॉल करें, और product/created के लिए एक वेबहुक रजिस्टर करें जो आपके n8n वर्कफ़्लो या सर्वर की ओर इशारा करे। सूचना में स्टोर ID, इवेंट और प्रोडक्ट का ID होता है, बिना प्रोडक्ट के विवरण के, इसलिए वर्कफ़्लो GET /products/{id} से प्रोडक्ट पढ़ता है, जाँचता है कि वह दिखने वाला है और उसमें फ़ोटो है, और हर खाते के लिए easyCoexistence के posts एपीआई को एक अनुरोध भेजता है: Instagram और TikTok के लिए फ़ोटो पोस्ट, Facebook के लिए लिंक पोस्ट। easyCoexistence हर पोस्ट को नेटवर्क के आधिकारिक एपीआई से पब्लिश करता है, तुरंत या उस publish_at पर जो आपने सेट किया है।
Nuvemshop ऐप और उसका वेबहुक कैसे सेट करें?
एक बार, Partners Portal और टर्मिनल से। Nuvemshop या Tiendanube पार्टनर के रूप में रजिस्टर करें, Apps के अंतर्गत read_products के साथ एक ऐप बनाएँ, जिसमें प्रोडक्ट इमेज और वेरिएंट भी शामिल हैं, और उसे अपने स्टोर में इंस्टॉल करें। आपके रीडायरेक्ट यूआरएल पर भेजा गया ऑथराइज़ेशन कोड 5 मिनट तक वैध रहता है, और इसे https://www.tiendanube.com/apps/authorize/token पर एक्सेस टोकन और user_id के बदले में दिया जाता है, जो स्टोर का ID है। यह टोकन तब तक समाप्त नहीं होता जब तक उस ऐप और स्टोर के लिए नया टोकन न लिया जाए या ऐप अनइंस्टॉल न हो। फिर POST /webhooks से वेबहुक रजिस्टर करें। हर अनुरोध में Authorization: Bearer टोकन के साथ और एक User-Agent होना चाहिए जिसमें आपके ऐप और संपर्क का नाम हो, वरना Nuvemshop 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" }'n8n वर्कफ़्लो हर प्रोडक्ट के साथ क्या करता है?
जवाब देता है, जाँचता है, पढ़ता है, बदलता है और पोस्ट करता है। Raw Body चालू और Respond को Immediately पर सेट किया गया वेबहुक नोड Nuvemshop की 3 सेकंड की सीमा के भीतर जवाब देता है। Extract From File नोड बॉडी को टेक्स्ट में बदलता है, Crypto नोड उसका Hmac SHA256 और HEX में हिसाब लगाता है, ऐप के क्लाइंट सीक्रेट से, और If नोड तभी आगे बढ़ने देता है जब नतीजा x-linkedstore-hmac-sha256 हेडर के बराबर हो।
फिर एक HTTP Request नोड स्टोर के टोकन से GET /products/{{ $json.id }} पढ़ता है। एक If नोड तभी आगे बढ़ता है जब visibility visible हो और images खाली न हो, और Remove Items Processed in Previous Executions पर सेट Remove Duplicates नोड उस प्रोडक्ट को हटा देता है जो पहले पोस्ट हो चुका है, क्योंकि Nuvemshop एक ही सूचना दो बार भेज सकता है। Instagram के लिए एक HTTP Request नोड मुख्य इमेज को फ़ाइल के रूप में डाउनलोड करता है, Edit Image नोड उसे jpeg फ़ॉर्मैट में रीसाइज़ करता है, और एक HTTP Request नोड उसे n8n Binary File के रूप में POST /api/v1/media पर भेजता है, जो media_id लौटाता है। हर खाते के लिए एक HTTP Request POST /api/v1/channels/<account_id>/posts को कॉल करता है।
स्क्रिप्ट n8n के बिना प्रोडक्ट कैसे पोस्ट करती है?
एक छोटे वेब एंडपॉइंट से। नीचे का Python कोड ऐप के क्लाइंट सीक्रेट से कच्ची बॉडी पर सिग्नेचर जाँचता है, तुरंत 200 जवाब देता है और बाकी काम बैकग्राउंड में करता है: वह प्रोडक्ट पढ़ता है, जो दिखने वाला नहीं है या जिसमें फ़ोटो नहीं है उसे छोड़ देता है, और मुख्य फ़ोटो को Pillow से ऐसी JPEG में बदलता है जिसकी हर तरफ़ अधिकतम 1080 पिक्सल हो, जिसे Instagram और TikTok दोनों स्वीकार करते हैं। वह फ़ाइल को POST /media पर अपलोड करता है, उसे Instagram और TikTok पर पोस्ट करता है, और Facebook पर लिंक पोस्ट बनाता है। हर कॉल के साथ एक Idempotency-Key जाता है, जो प्रोडक्ट और खाते से बनती है और जिसका easyCoexistence सम्मान करता है, और पोस्ट किए गए ID की एक सूची दोहराई गई सूचना को दोबारा पोस्ट होने से रोकती है।
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}"})Claude और ChatGPT अनुरोध पर प्रोडक्ट कैसे पोस्ट करते हैं?
easyCoexistence के अपने कनेक्टर के साथ-साथ Nuvemshop का अपना कनेक्टर। Nuvemshop का Help Center एक AI कनेक्टर का वर्णन करता है जो MCP पर बना है और Claude के साथ काम करता है, ChatGPT के साथ उसके कनेक्टर के ज़रिए, और Cursor जैसे एडिटर्स के साथ; Claude में इसे https://admin-mcp.nuvemshop.com.br पर कस्टम कनेक्टर के रूप में जोड़ा जाता है, और इसके रीड टूल प्रोडक्ट, ऑर्डर और ग्राहकों को देखते हैं। उदाहरण के लिए पूछें: "कल सुबह 10 बजे साओ पाउलो के समय से हमारे पाँच नए प्रोडक्ट TikTok पर पोस्ट करो, हर घंटे एक, और हर एक के लिए कैप्शन के साथ।" सहायक प्रोडक्ट पढ़ता है, कैप्शन लिखता है, और scheduled_at के साथ हर पोस्ट शेड्यूल करता है। यह तब काम करता है जब उसे कहा जाए, और चैट के बीच स्टोर पर नज़र नहीं रखता, इसलिए रात में जोड़े गए प्रोडक्ट वेबहुक के ज़रिए जाते हैं।
हर नेटवर्क प्रोडक्ट पोस्ट में क्या स्वीकार करता है?
हर नेटवर्क के नियम, और easyCoexistence की अपनी जाँचें, पोस्ट भेजने या शेड्यूल करने के समय लागू होती हैं, इसलिए जो प्रोडक्ट नहीं जा सकता वह तुरंत अस्वीकार हो जाता है:
- Instagram: केवल JPEG इमेज, इसलिए WebP या PNG प्रोडक्ट फ़ोटो को पहले बदलें; कई फ़ोटो से कैरोसेल बनता है। पोस्ट में लिंक फ़ील्ड नहीं होता, इसलिए प्रोडक्ट का पता कैप्शन में टेक्स्ट के रूप में जाता है।
- TikTok: 1 से 35 JPG या WebP इमेज वाली फ़ोटो पोस्ट, हर इमेज 1080 × 1920 या 1920 × 1080 पिक्सल और 20 MB तक, 90 अक्षरों का शीर्षक, और प्रति खाता प्रति दिन 15 फ़ोटो पोस्ट।
- Facebook: प्रोडक्ट के
canonical_urlपर लिंक पोस्ट, जिसका प्रीव्यू Facebook पेज के Open Graph टैग से बनाता है, या एक फ़ोटो जिसके टेक्स्ट में पता हो। - easyCoexistence के ज़रिए मीडिया: HTTPS लिंक या POST /media से
media_id, 30 MB तक की इमेज, जो पोस्ट शेड्यूल होने पर कॉपी होती है। - कैप्शन: Nuvemshop का नाम और विवरण pt या es जैसी भाषा से कुंजी वाली ऑब्जेक्ट हैं, और विवरण HTML है, इसलिए एक भाषा चुनें और टैग हटा दें।
कैसे कॉन्फ़िगर करें
- 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.
आम गड़बड़ियाँ
- पोस्ट जाने के बाद Nuvemshop को जवाब देना। वह 2XX के लिए 3 सेकंड इंतज़ार करता है और फिर दोबारा कोशिश करता है, 48 घंटों में 16 बार तक, इसलिए पहले जवाब दें, फिर पोस्ट करें।
- Instagram को Nuvemshop द्वारा दी गई प्रोडक्ट फ़ोटो भेजना। Nuvemshop पता किसी भी एक्सटेंशन पर हो WebP दे सकता है, और Instagram केवल JPEG पब्लिश करता है, इसलिए फ़ाइल का Content-Type जाँचें और उसे बदलें।
- स्टोर के एक्सेस टोकन से सिग्नेचर जाँचना। Nuvemshop ऐप के क्लाइंट सीक्रेट से, कच्ची बॉडी पर साइन करता है, इसलिए बॉडी पार्स होने से पहले HMAC की गणना करें।
- प्रोडक्ट बनते ही पोस्ट करना। वह छिपा हुआ या बिना फ़ोटो के शुरू हो सकता है, इसलिए दिखने और इमेज की जाँच करें, product/updated को भी सुनें, और हर प्रोडक्ट एक बार पोस्ट करें।
easyCoexistence आपके स्टोर को, और उसे चलाने वाले AI एजेंटों को, Instagram, TikTok, Facebook और अन्य चैनलों पर ग्राहकों तक पहुँच देता है, हर एक अपने आधिकारिक एपीआई के ज़रिए: n8n और आपकी स्क्रिप्ट के लिए posts एपीआई और मीडिया अपलोड, Claude और ChatGPT के लिए एक MCP कनेक्टर जो Nuvemshop के अपने कनेक्टर के साथ चलता है, और एक क्यू जो 90 दिन आगे तक पब्लिश करता है, हर कनेक्शन की 24/7 निगरानी के साथ। US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह, कनेक्शन जोड़ने पर घटते हुए, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या यह Tiendanube स्टोर के साथ काम करता है?
हाँ। Nuvemshop और Tiendanube एक ही एपीआई साझा करते हैं: docs में हर tiendanube.com पता nuvemshop.com.br पर एक जैसा होता है, और एपीआई api.tiendanube.com और api.nuvemshop.com.br दोनों पर जवाब देता है।
क्या प्रोडक्ट सेल पर जाने पर उसे दोबारा पोस्ट किया जा सकता है?
हाँ। product/updated को भी सुनें और वेरिएंट के promotional_price की तुलना उस कीमत से करें जो आपने आखिरी बार पोस्ट की थी; सूचना में प्रोडक्ट का ID होता है, विवरण नहीं, इसलिए हर बार प्रोडक्ट पढ़ें।
Nuvemshop का अपना Instagram और Facebook चैनल क्या करता है?
यह स्टोर के कैटलॉग, Pixel और शॉप को Instagram और Facebook पर बेचने के लिए Meta से जोड़ता है, जैसा कि Nuvemshop का Help Center बताता है, एडमिन में Canais de venda से। यह फ़्लो हर नए प्रोडक्ट के लिए एक फ़ीड पोस्ट पब्लिश करता है।
Nuvemshop प्रोडक्ट पोस्ट करने के लिए easyCoexistence की लागत कितनी है?
US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह, कनेक्शन जोड़ने पर घटते हुए, हर नेटवर्क पर एक जैसी। posts एपीआई, मीडिया अपलोड और MCP कनेक्टर शामिल हैं, पहले 3 दिन मुफ़्त।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित