కొత్త Nuvemshop మరియు Tiendanube ఉత్పత్తులను Instagram, TikTok మరియు Facebook లో స్వయంచాలకంగా పోస్ట్ చేయండి
Nuvemshop లేదా Tiendanube యాప్ యొక్క product/created వెబ్హుక్ ప్రతి కొత్త ఉత్పత్తిని easyCoexistence ద్వారా Instagram, TikTok, Facebook లో పోస్ట్ చేయగలదు: n8n లేదా ఒక చిన్న స్క్రిప్ట్ ఉత్పత్తిని తీసుకువస్తుంది, దాని ప్రధాన ఫోటోను Instagram కోసం JPEG గా మారుస్తుంది, మరియు టెక్స్ట్, ఫోటో, లింక్ను easyCoexistence యొక్క posts API కి పంపుతుంది. అది ప్రతి నెట్వర్క్ యొక్క అధికారిక API ద్వారా ఇప్పుడు లేదా తర్వాత ప్రచురిస్తుంది. Claude అభ్యర్థనపై Nuvemshop యొక్క స్వంత కనెక్టర్తో ఉత్పత్తులను పోస్ట్ చేస్తుంది.
Nuvemshop వెబ్హుక్కు 2XX ప్రతిస్పందన కోసం మళ్లీ ప్రయత్నించే ముందు ఎంతసేపు వేచి ఉంటుంది, 48 గంటల్లో 16 ప్రయత్నాల వరకు.
ఉత్పత్తి వెబ్హుక్లో ఉండే ఫీల్డ్లు: టైమ్స్టాంప్ మరియు ఉత్పత్తి వివరాలు లేకుండా, కాబట్టి ఉత్పత్తిని GET /products/{id} తో చదవాలి.
ప్రతి వెబ్హుక్ యొక్క HMAC-SHA256 సంతకం ఉన్న హెడర్, యాప్ యొక్క క్లయింట్ సీక్రెట్తో కీ చేయబడింది, స్టోర్ యొక్క యాక్సెస్ టోకెన్తో కాదు.
ఆప్టిమైజేషన్ తర్వాత Nuvemshop ఉత్పత్తి చిత్రాలను అందించే ఫార్మాట్, ఈ మార్పిడిని ఆపివేయడానికి API ఎంపిక లేకుండా.
Nuvemshop హెల్ప్ సెంటర్ తన స్వంత MCP కనెక్టర్ను Claude కు కస్టమ్ కనెక్టర్గా జోడించడానికి ఇచ్చే చిరునామా.
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 భాగస్వామిగా నమోదు చేసుకోండి, Apps కింద read_products తో యాప్ను సృష్టించండి (ఇది ఉత్పత్తి చిత్రాలు మరియు వేరియంట్లను కూడా కవర్ చేస్తుంది), మరియు మీ స్టోర్లో ఇన్స్టాల్ చేయండి. మీ redirect URL కు పంపిన అధికార కోడ్ 5 నిమిషాలు మాత్రమే చెల్లుతుంది, మరియు https://www.tiendanube.com/apps/authorize/token వద్ద యాక్సెస్ టోకెన్ మరియు user_id కోసం మార్చుకోబడుతుంది. 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 కి సెట్ చేసిన Webhook నోడ్ 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 నోడ్ దాన్ని Format గా 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 తో దాని కనెక్టర్ల ద్వారా, మరియు Cursor వంటి ఎడిటర్లతో. Claude లో దీన్ని https://admin-mcp.nuvemshop.com.br వద్ద కస్టమ్ కనెక్టర్గా జోడిస్తారు, మరియు దాని రీడ్ టూల్స్ ఉత్పత్తులు, ఆర్డర్లు మరియు కస్టమర్లను వెతుకుతాయి. ఉదాహరణకు ఇలా అడగండి: "మా ఐదు కొత్త ఉత్పత్తులను రేపటి నుండి ఉదయం 10 గంటలకు 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కు లింక్ పోస్ట్, పేజీ యొక్క Open Graph ట్యాగ్ల నుండి Facebook నిర్మించే ప్రివ్యూతో, లేదా టెక్స్ట్లో చిరునామాతో ఒక ఫోటో. - 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 ను పంచుకుంటాయి: డాక్స్లోని ప్రతి tiendanube.com చిరునామాకు nuvemshop.com.br పై ఒకేలాంటిది ఉంటుంది, మరియు API api.tiendanube.com మరియు api.nuvemshop.com.br రెండింటిలోనూ ప్రతిస్పందిస్తుంది.
ఉత్పత్తి తగ్గింపు ధరకు వెళ్లినప్పుడు మళ్లీ పోస్ట్ చేయగలదా?
అవును. product/updated ను కూడా వినండి మరియు వేరియంట్ల promotional_price ను మీరు చివరిసారి పోస్ట్ చేసిన దానితో పోల్చండి. నోటీసులో ఉత్పత్తి ID ఉంటుంది, వివరాలు కాదు, కాబట్టి ప్రతిసారీ ఉత్పత్తిని చదవండి.
Nuvemshop యొక్క స్వంత Instagram మరియు Facebook ఛానెల్ ఏమి చేస్తుంది?
Nuvemshop హెల్ప్ సెంటర్ వివరించినట్లుగా, అడ్మిన్లోని Canais de venda నుండి, స్టోర్ యొక్క కేటలాగ్, Pixel మరియు షాప్ను Instagram మరియు Facebook లో అమ్మడానికి Meta కు కనెక్ట్ చేస్తుంది. ఈ ఫ్లో ప్రతి కొత్త ఉత్పత్తికి ఫీడ్ పోస్ట్ను ప్రచురిస్తుంది.
Nuvemshop ఉత్పత్తులను పోస్ట్ చేయడానికి easyCoexistence ఎంత ఖర్చవుతుంది?
ప్రతి కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, కనెక్షన్లు జోడించినప్పుడు తగ్గుతుంది, ప్రతి నెట్వర్క్లోనూ ఒకే ధర. posts API, మీడియా అప్లోడ్ మరియు MCP కనెక్టర్ చేర్చబడ్డాయి, మొదటి 3 రోజులు ఉచితం.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ