नवीन Nuvemshop आणि Tiendanube उत्पादने Instagram, TikTok आणि Facebook वर आपोआप पोस्ट करा
Nuvemshop किंवा Tiendanube ॲपचा product/created वेबहुक प्रत्येक नवीन उत्पादन easyCoexistence द्वारे Instagram, TikTok आणि Facebook वर पोस्ट करू शकतो: n8n किंवा एक छोटी स्क्रिप्ट उत्पादन मिळवते, मुख्य फोटो Instagram साठी JPEG मध्ये बदलते आणि मजकूर, फोटो व लिंक easyCoexistence च्या posts एपीआयकडे पाठवते. ती प्रत्येक नेटवर्कच्या अधिकृत एपीआयद्वारे लगेच किंवा नंतर प्रकाशित होते. Claude विनंतीनुसार Nuvemshop च्या स्वतःच्या कनेक्टरसह उत्पादने पोस्ट करतो.
पुन्हा प्रयत्न करण्यापूर्वी Nuvemshop वेबहुकच्या 2XX उत्तरासाठी किती वेळ थांबते, 48 तासांत 16 प्रयत्नांपर्यंत.
उत्पादन वेबहुकमध्ये फील्ड असतात: टाइमस्टॅम्प आणि उत्पादनाचा तपशील नाही, म्हणून उत्पादन GET /products/{id} ने वाचले जाते.
HMAC-SHA256 स्वाक्षरी असलेला हेडर, जो प्रत्येक वेबहुकसोबत येतो आणि ॲपच्या client secret ने तयार होतो, स्टोअरच्या ॲक्सेस टोकनने नाही.
ऑप्टिमायझेशननंतर Nuvemshop उत्पादनाच्या इमेज ज्या फॉरमॅटमध्ये देऊ शकते, त्याचे रूपांतर बंद करण्यासाठी एपीआय पर्याय नाही.
Nuvemshop च्या हेल्प सेंटरने दिलेला पत्ता, ज्यावर स्वतःचा 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 सह ॲप तयार करा, जो उत्पादनाच्या इमेज आणि व्हेरिएंट्सही कव्हर करतो, आणि ते तुमच्या स्टोअरमध्ये इन्स्टॉल करा. तुमच्या redirect URL वर पाठवलेला authorization code 5 मिनिटे वैध असतो आणि https://www.tiendanube.com/apps/authorize/token वर अॅक्सेस टोकन आणि स्टोअरचा ID असलेला user_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 वर्कफ्लो प्रत्येक उत्पादनासोबत काय करतो?
उत्तर देणे, पडताळणी, वाचन, रूपांतर आणि पोस्ट. Webhook नोड Raw Body चालू आणि Respond set to Immediately सेट करून Nuvemshop च्या 3 सेकंदांच्या आत उत्तर देतो. Extract From File नोड बॉडीचे मजकुरात रूपांतर करतो, Crypto नोड SHA256 आणि HEX सह ॲपच्या client secret वापरून त्याचा Hmac काढतो, आणि If नोड निकाल x-linkedstore-hmac-sha256 हेडरच्या बरोबर असेल तरच पुढे जाऊ देतो.
मग HTTP Request नोड स्टोअरच्या टोकनसह GET /products/{{ $json.id }} वाचतो. If नोड दृश्यमानता visible आणि images रिकामे नसेल तेव्हा पुढे जातो, आणि Remove Duplicates नोड, Remove Items Processed in Previous Executions वर सेट केलेला, आधी पोस्ट झालेले उत्पादन वगळतो, कारण Nuvemshop एकच सूचना दोनदा पाठवू शकते. Instagram साठी HTTP Request नोड मुख्य इमेज फाइल म्हणून डाउनलोड करतो, Edit Image नोड Format म्हणून jpeg वापरून तिचा आकार बदलतो, आणि HTTP Request नोड ती n8n Binary File म्हणून POST /api/v1/media वर पाठवतो, जो media_id परत करतो. प्रत्येक खात्यासाठी एक HTTP Request POST /api/v1/channels/<account_id>/posts ला कॉल करतो.
n8n शिवाय स्क्रिप्ट उत्पादने कशी पोस्ट करते?
एका छोट्या वेब एंडपॉइंटसह. एक Python स्क्रिप्ट स्वाक्षरी कच्च्या बॉडीविरुद्ध ॲपच्या client secret सह तपासते, लगेच 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 च्या हेल्प सेंटरमध्ये MCP वर आधारित AI कनेक्टरचे वर्णन आहे, जो Claude सोबत, ChatGPT च्या connectors द्वारे आणि Cursor सारख्या एडिटर्ससोबत चालतो; Claude मध्ये तो कस्टम कनेक्टर म्हणून https://admin-mcp.nuvemshop.com.br येथे जोडला जातो, आणि त्याची वाचन टूल्स उत्पादने, ऑर्डर आणि ग्राहक शोधतात. उदाहरणार्थ विचारा: “उद्यापासून 10am São Paulo वेळेनुसार आमची पाच नवीन उत्पादने 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 ॲपच्या client secret ने, कच्च्या बॉडीवर स्वाक्षरी करते, म्हणून बॉडी पार्स होण्यापूर्वी HMAC काढा.
- उत्पादन तयार होताच ते पोस्ट करणे. ते लपलेले किंवा फोटोशिवाय सुरू होऊ शकते, म्हणून दृश्यमानता आणि इमेजेस तपासा, product/updated देखील ऐका आणि प्रत्येक उत्पादन एकदाच पोस्ट करा.
easyCoexistence तुमच्या स्टोअरला आणि त्याला चालवणाऱ्या AI एजंट्सना Instagram, TikTok, Facebook आणि आणखी चॅनेल्सवर ग्राहकांपर्यंत पोहोच देते, प्रत्येक त्याच्या अधिकृत एपीआयद्वारे: n8n आणि तुमच्या स्क्रिप्ट्ससाठी posts एपीआय आणि मीडिया अपलोड, Claude आणि ChatGPT साठी Nuvemshop च्या स्वतःच्या बरोबरीने एक MCP कनेक्टर, आणि 90 दिवसांपर्यंत आधी प्रकाशित करणारी रांग, प्रत्येक कनेक्शन 24/7 मॉनिटर केलेले. प्रति कनेक्शन प्रति महिना US$ 9 ते US$ 0.75, कनेक्शन वाढवाल तसे कमी होत, पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
Tiendanube स्टोअरसोबत हे काम करते का?
होय. Nuvemshop आणि Tiendanube एकच एपीआय सामायिक करतात: डॉक्समधील प्रत्येक tiendanube.com पत्त्याचा nuvemshop.com.br वर समान पत्ता आहे, आणि एपीआय api.tiendanube.com आणि api.nuvemshop.com.br दोन्हीवर उत्तर देते.
उत्पादन सवलतीत गेल्यावर ते पुन्हा पोस्ट करता येईल का?
होय. product/updated देखील ऐका आणि variants चे promotional_price शेवटी पोस्ट केलेल्या किंमतीशी तुलना करा; सूचनेत उत्पादनाचा ID असतो, तपशील नसतो, म्हणून प्रत्येक वेळी उत्पादन वाचा.
Nuvemshop चे स्वतःचे Instagram आणि Facebook चॅनेल काय करते?
ते Nuvemshop च्या हेल्प सेंटरनुसार, ॲडमिनमधील Canais de venda मधून, Instagram आणि Facebook वर विक्रीसाठी स्टोअरचा कॅटलॉग, Pixel आणि शॉप Meta शी जोडते. हा फ्लो प्रत्येक नवीन उत्पादनासाठी फीड पोस्ट प्रकाशित करतो.
Nuvemshop उत्पादने पोस्ट करण्यासाठी easyCoexistence चा खर्च किती?
प्रति कनेक्शन प्रति महिना US$ 9 ते US$ 0.75, कनेक्शन वाढतील तसे कमी होत, प्रत्येक नेटवर्कवर सारखाच. posts एपीआय, मीडिया अपलोड आणि MCP कनेक्टर समाविष्ट आहेत, पहिले 3 दिवस मोफत.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: