Nuvemshop र Tiendanube का नयाँ उत्पादहरू Instagram, TikTok र Facebook मा स्वतः पोस्ट गर्नुहोस्
Nuvemshop वा Tiendanube एपको product/created वेबहुकले easyCoexistence मार्फत हरेक नयाँ उत्पादलाई Instagram, TikTok र Facebook मा पोस्ट गर्न सक्छ। n8n वा एउटा छोटो स्क्रिप्टले उत्पादको विवरण ल्याउँछ, मुख्य फोटोलाई Instagram का लागि JPEG मा बदल्छ, र पाठ, फोटो र लिङ्क easyCoexistence को posts API मा पठाउँछ। API ले प्रत्येक नेटवर्कको आधिकारिक API मार्फत अहिले वा पछि प्रकाशित गर्छ। Claude ले अनुरोधमा Nuvemshop को आफ्नै कनेक्टरमार्फत उत्पादहरू पोस्ट गर्छ।
Nuvemshop ले वेबहुकको 2XX उत्तरका लागि कति पर्खन्छ र 48 घण्टाभित्र अधिकतम 16 पटक पुनः प्रयास गर्छ।
Nuvemshop को उत्पादको वेबहुकमा कुन फिल्डहरू आउँछन्, समय चिह्न समावेश हुन्छ तर उत्पादको विवरण हुँदैन, त्यसैले उत्पादलाई GET /products/{id} ले पढिन्छ।
हरेक वेबहुकको HMAC-SHA256 हस्ताक्षर बोक्ने हेडर, जसलाई एपको क्लाइन्ट सिक्रेटले बनाइन्छ, स्टोरको एक्सेस टोकनले होइन।
Nuvemshop ले अप्टिमाइजेसनपछि उत्पादका तस्बिर कुन फर्म्याटमा दिन सक्छ, र यो रूपान्तरण बन्द गर्ने कुनै API विकल्प छैन।
Nuvemshop को हेल्प सेन्टरले Claude मा कस्टम कनेक्टरका रूपमा आफ्नो MCP कनेक्टर थप्ने ठेगाना।
TikTok फोटो पोस्टले स्वीकार गर्ने सबैभन्दा ठूलो तस्बिर, वा 1920 × 1080, JPG वा WebP मा, 20 MB सम्मको।
नयाँ Nuvemshop उत्पादले कसरी पोस्ट बन्छ?
एप, वेबहुक र प्रति खातामा एउटा कल मार्फत। Nuvemshop का वेबहुकहरू एपका हुन्छन्, त्यसैले read_products स्कोपसहित एउटा एप बनाउनुहोस्, आफ्नो स्टोरमा इन्स्टल गर्नुहोस्, र तपाईंको n8n वर्कफ्लो वा सर्भरलाई इंगित गर्ने product/created का लागि वेबहुक दर्ता गर्नुहोस्। सूचनामा स्टोर ID, घटना र उत्पादको ID हुन्छ, उत्पादको विवरण हुँदैन, त्यसैले वर्कफ्लोले GET /products/{id} ले उत्पादलाई पढ्छ, त्यो देखिने र फोटो भएको छ कि छैन जाँच गर्छ, र प्रत्येक खाताका लागि easyCoexistence को posts API मा एउटा अनुरोध पठाउँछ: Instagram र TikTok का लागि फोटो पोस्ट, Facebook का लागि लिङ्क पोस्ट। easyCoexistence ले प्रत्येकलाई नेटवर्कको आधिकारिक API मार्फत प्रकाशित गर्छ, तुरुन्तै वा तपाईंले सेट गरेको publish_at मा।
Nuvemshop एप र यसको वेबहुक कसरी सेटअप गर्ने?
एकपटक, Partners Portal र टर्मिनलबाट। Nuvemshop वा Tiendanube partner का रूपमा दर्ता गर्नुहोस्, 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 को 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 Duplicates नोड (Remove Items Processed in Previous Executions मा सेट) ले पहिले पोस्ट भइसकेको उत्पादलाई हटाउँछ, किनभने 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 मार्फत प्रति भुजा अधिकतम 1080 पिक्सेलको JPEG मा बदल्छ, जुन 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 मा कस्टम कनेक्टरका रूपमा थपिन्छ, र यसका पढ्ने टुलहरूले उत्पादहरू, अर्डरहरू र ग्राहकहरू खोज्छन्। उदाहरणका लागि सोध्नुहोस्: “भोलिदेखि साओ पाउलो समयअनुसार बिहान 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 गणना गर्नुहोस्।
- उत्पादको सिर्जना हुने बित्तिकै पोस्ट गर्नु। यो लुकेको वा फोटोबिनै सुरु हुन सक्छ, त्यसैले visibility र images जाँच गर्नुहोस्, product/updated पनि सुन्नुहोस्, र प्रत्येक उत्पादलाई एकपटक मात्र पोस्ट गर्नुहोस्।
easyCoexistence ले तपाईंको स्टोर, र त्यसलाई चलाउने AI एजेन्टहरूलाई Instagram, TikTok, Facebook र अन्य च्यानलहरूमा ग्राहकसम्म पुग दिन्छ, प्रत्येक आफ्नो आधिकारिक API मार्फत: n8n र तपाईंका स्क्रिप्टका लागि posts API र मिडिया अपलोड, Claude र ChatGPT का लागि Nuvemshop को आफ्नै कनेक्टरसँगै एउटा MCP कनेक्टर, र 90 दिनसम्म अगाडिसम्मका पोस्ट तालिकाबद्ध गर्ने क्यु, जसमा हरेक कनेक्सन 24/7 निगरानीमा हुन्छ। प्रति कनेक्सन प्रति महिना US$ 9 देखि US$ 0.75 सम्म, कनेक्सन थप्दै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
Tiendanube स्टोरहरूसँग काम गर्छ?
हो। Nuvemshop र Tiendanube ले एउटै API साझा गर्छन्: docs मा हरेक tiendanube.com ठेगानाको समान ठेगाना nuvemshop.com.br मा पनि छ, र API ले api.tiendanube.com र api.nuvemshop.com.br दुवैमा प्रतिक्रिया दिन्छ।
सेल सुरु हुँदा उत्पादलाई फेरि पोस्ट गर्न सकिन्छ?
हो। product/updated पनि सुन्नुहोस् र भेरियन्टको promotional_price लाई अन्तिम पोस्ट गरिएको मूल्यसँग तुलना गर्नुहोस्; सूचनामा उत्पादको ID हुन्छ, विवरण हुँदैन, त्यसैले हरेक पटक उत्पादलाई पढ्नुहोस्।
Nuvemshop को आफ्नै Instagram र Facebook च्यानलले के गर्छ?
यसले स्टोरको क्याटलग, Pixel र शपलाई Instagram र Facebook मा बेच्नका लागि Meta सँग जोड्छ, जसरी Nuvemshop को हेल्प सेन्टरले वर्णन गर्छ, प्रशासकभित्रको Canais de venda बाट। यो प्रवाहले हरेक नयाँ उत्पादका लागि फिड पोस्ट प्रकाशित गर्छ।
Nuvemshop उत्पादहरू पोस्ट गर्न easyCoexistence को मूल्य कति हो?
प्रति कनेक्सन प्रति महिना US$ 9 देखि US$ 0.75 सम्म, कनेक्सन थप्दै जाँदा घट्दै, प्रत्येक नेटवर्कमा उस्तै। posts API, मिडिया अपलोड र MCP कनेक्टर समावेश छन्, पहिलो 3 दिन निःशुल्क।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको