Nuvemshop மற்றும் Tiendanube புதிய தயாரிப்புகளை Instagram, TikTok மற்றும் Facebook-இல் தானாக பதிவிடுங்கள்
Nuvemshop அல்லது Tiendanube செயலியின் product/created வெப்ஹூக், easyCoexistence வழியாக ஒவ்வொரு புதிய தயாரிப்பையும் Instagram, TikTok மற்றும் Facebook-இல் பதிவிட முடியும். n8n அல்லது ஒரு சிறிய ஸ்கிரிப்ட் தயாரிப்பை எடுத்து, அதன் முதன்மைப் படத்தை Instagram-க்காக JPEG ஆக மாற்றி, உரை, படம் மற்றும் இணைப்பை easyCoexistence-இன் posts API-க்கு அனுப்புகிறது. அது ஒவ்வொரு நெட்வொர்க்கின் அதிகாரப்பூர்வ API வழியாக, இப்போதோ பின்னரோ வெளியிடுகிறது. Claude, Nuvemshop-இன் சொந்த கனெக்டர் மூலம் கோரிக்கையின் பேரில் தயாரிப்புகளைப் பதிவிடுகிறது.
2XX பதிலுக்காக Nuvemshop வெப்ஹூக்கிற்கு எவ்வளவு நேரம் காத்திருக்கிறது, அதன் பிறகு 48 மணி நேரத்திற்குள் 16 முறை வரை மீண்டும் முயல்கிறது.
Nuvemshop தயாரிப்பு வெப்ஹூக் கொண்டு செல்லும் புலங்கள்: நேர முத்திரை மட்டும், தயாரிப்பு விவரங்கள் இல்லை; எனவே தயாரிப்பு GET /products/{id} மூலம் படிக்கப்படுகிறது.
ஒவ்வொரு வெப்ஹூக்கின் HMAC-SHA256 கையொப்பத்தைக் கொண்ட தலைப்பு, செயலியின் client secret கொண்டு சாவியிடப்படுகிறது; கடையின் access டோக்கன் கொண்டு அல்ல.
மேம்படுத்தலுக்குப் பின் Nuvemshop தயாரிப்புப் படங்களை வழங்கக்கூடிய வடிவம்; மாற்றத்தை நிறுத்த API விருப்பம் இல்லை.
Claude-இல் custom connector ஆக அதன் சொந்த MCP connector-ஐச் சேர்க்க Nuvemshop Help Center வழங்கும் முகவரி.
TikTok புகைப்பதிவுக்கு எடுக்கப்படும் மிகப்பெரிய படம் 1920 × 1080; JPG அல்லது WebP வடிவில், 20 MB வரை.
புதிய Nuvemshop தயாரிப்பு எவ்வாறு பதிவாகிறது?
ஒரு செயலி, ஒரு வெப்ஹூக், ஒவ்வொரு கணக்குக்கும் ஓர் அழைப்பு மூலம். Nuvemshop-இன் வெப்ஹூக்குகள் ஒரு செயலிக்கு உரியவை; எனவே read_products அனுமதியுடன் ஒன்றை உருவாக்கி, உங்கள் கடையில் நிறுவி, product/created-க்கு உங்கள் n8n பணிப்பாய்வு அல்லது சர்வரைச் சுட்டும் வெப்ஹூக்கைப் பதிவு செய்யுங்கள். அறிவிப்பில் கடையின் 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-க்கு அனுப்பப்படும் authorization code 5 நிமிடங்கள் மட்டுமே செல்லுபடியாகும்; அதை https://www.tiendanube.com/apps/authorize/token-இல் பரிமாறி access டோக்கன் மற்றும் 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 node, Nuvemshop-இன் 3 வினாடி வரம்பிற்குள் பதில் அளிக்கிறது. ஒரு Extract From File node உடலை உரையாக மாற்றுகிறது, ஒரு Crypto node SHA256 மற்றும் HEX உடன் HMAC-ஐக் கணக்கிடுகிறது, செயலியின் client secret கொண்டு சாவியிடப்படுகிறது, ஒரு If node முடிவு x-linkedstore-hmac-sha256 தலைப்புக்குச் சமமாக இருக்கும்போது மட்டுமே ஓட்டத்தைத் தொடர அனுமதிக்கிறது.
ஒரு HTTP Request node கடையின் டோக்கனுடன் GET /products/{{ $json.id }}-ஐப் படிக்கிறது. தெரிவுநிலை visible ஆகவும் images காலியாக இல்லாமலும் இருக்கும்போது ஒரு If node தொடர்கிறது; Remove Duplicates node, அதை Remove Items Processed in Previous Executions என அமைத்திருந்தால், ஏற்கனவே பதிவிடப்பட்ட தயாரிப்பை நீக்குகிறது; ஏனெனில் Nuvemshop ஒரே அறிவிப்பை இரண்டு முறை அனுப்பலாம். Instagram-க்கு, ஒரு HTTP Request node முதன்மைப் படத்தை கோப்பாகப் பதிவிறக்குகிறது, ஒரு Edit Image node Format என jpeg-ஐ வைத்து அளவை மாற்றுகிறது, பிறகு ஒரு HTTP Request node அதை n8n Binary File ஆக POST /api/v1/media-க்கு அனுப்புகிறது, அது media_id-ஐத் திருப்பித் தருகிறது. ஒவ்வொரு கணக்குக்கும் ஒரு HTTP Request POST /api/v1/channels/<account_id>/posts-ஐ அழைக்கிறது.
n8n இல்லாமல் ஒரு ஸ்கிரிப்ட் தயாரிப்புகளை எவ்வாறு பதிவிடுகிறது?
ஒரு சிறிய வெப் எண்ட்பாயிண்ட் மூலம். கீழே உள்ள Python, செயலியின் client secret கொண்டு raw body-க்கு எதிராக கையொப்பத்தைச் சரிபார்க்கிறது, உடனே 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 Help Center, MCP அடிப்படையிலான ஒரு AI கனெக்டரை விவரிக்கிறது; அது Claude-உடன் வேலை செய்கிறது, ChatGPT அதன் கனெக்டர்கள் வழியாகவும், Cursor போன்ற எடிட்டர்களுடனும் வேலை செய்கிறது. Claude-இல் அது https://admin-mcp.nuvemshop.com.br என்ற முகவரியில் custom connector ஆகச் சேர்க்கப்படுகிறது, அதன் படிக்கும் கருவிகள் தயாரிப்புகள், ஆர்டர்கள், வாடிக்கையாளர்களைத் தேடுகின்றன. உதாரணமாகக் கேளுங்கள்: "நாளை காலை 10 மணிக்கு சாவ் பாவுலோ நேரப்படி, ஒரு மணி நேர இடைவெளியில், எங்கள் புதிய ஐந்து தயாரிப்புகளை TikTok-இல் பதிவிடுங்கள், ஒவ்வொன்றுக்கும் ஒரு தலைப்புடன்." உதவியாளர் தயாரிப்புகளைப் படித்து, தலைப்புகளை எழுதி, ஒவ்வொரு பதிவையும் scheduled_at உடன் திட்டமிடுகிறது. கேட்கும்போது மட்டுமே செயல்படுகிறது; அரட்டைகளுக்கு இடையே கடையைக் கண்காணிப்பதில்லை, எனவே இரவில் சேர்க்கப்படும் தயாரிப்புகள் வெப்ஹூக் வழியாகவே செல்கின்றன.
ஒவ்வொரு நெட்வொர்க்கும் தயாரிப்புப் பதிவில் எதை ஏற்கின்றன?
ஒவ்வொரு நெட்வொர்க்கின் விதிகளும், easyCoexistence-இன் சொந்தச் சரிபார்ப்புகளும் சேர்ந்து, பதிவு அனுப்பப்படும் அல்லது திட்டமிடப்படும் போது பொருந்தும்; எனவே வெளியிட முடியாத தயாரிப்பு உடனே நிராகரிக்கப்படும்:
- Instagram: JPEG படங்கள் மட்டுமே; எனவே WebP அல்லது PNG தயாரிப்புப் படத்தை முதலில் மாற்றுங்கள்; பல படங்கள் ஒரு carousel ஆகும். பதிவில் link புலம் இல்லை, எனவே தயாரிப்பின் முகவரி தலைப்பில் உரையாக வைக்கப்படும்.
- 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-ஐச் சரிபார்த்து மாற்றுங்கள்.
- கடையின் access டோக்கனுடன் கையொப்பத்தைச் சரிபார்ப்பது. Nuvemshop செயலியின் client secret கொண்டு, raw body மீது கையொப்பமிடுகிறது; எனவே body பகுப்பாய்வு செய்வதற்கு முன்பே HMAC-ஐக் கணக்கிடுங்கள்.
- தயாரிப்பு உருவாக்கப்பட்ட அந்த நொடியிலேயே பதிவிடுவது. அது மறைந்த நிலையில் அல்லது படங்கள் இல்லாமல் தொடங்கலாம்; எனவே தெரிவுநிலையையும் படங்களையும் சரிபாருங்கள், product/updated-ஐயும் கேளுங்கள், ஒவ்வொரு தயாரிப்பையும் ஒரு முறை மட்டும் பதிவிடுங்கள்.
easyCoexistence, உங்கள் கடைக்கும் அதை இயக்கும் AI முகவர்களுக்கும், Instagram, TikTok, Facebook மற்றும் பிற சேனல்களில் வாடிக்கையாளர்களைச் சென்றடையும் வசதியை வழங்குகிறது; ஒவ்வொன்றும் அதன் அதிகாரப்பூர்வ API வழியாக: n8n மற்றும் உங்கள் ஸ்கிரிப்ட்களுக்கு ஒரு posts API மற்றும் media upload; 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-ஐயும் கேளுங்கள், கடைசியாக நீங்கள் பதிவிட்ட விலையுடன் variants-இன் promotional_price-ஐ ஒப்பிடுங்கள்; அறிவிப்பு தயாரிப்பின் ID-ஐக் கொண்டிருக்கும், விவரங்களை அல்ல, எனவே ஒவ்வொரு முறையும் தயாரிப்பைப் படியுங்கள்.
Nuvemshop-இன் சொந்த Instagram மற்றும் Facebook சேனல் என்ன செய்கிறது?
அது கடையின் catalog, Pixel மற்றும் shop-ஐ Instagram மற்றும் Facebook-இல் விற்பனைக்காக Meta-உடன் இணைக்கிறது; Nuvemshop Help Center விவரிப்பது போல், நிர்வாகத்தில் Canais de venda-இலிருந்து. இந்த ஓட்டம் ஒவ்வொரு புதிய தயாரிப்புக்கும் ஒரு feed பதிவை வெளியிடுகிறது.
Nuvemshop தயாரிப்புகளைப் பதிவிட easyCoexistence-க்கு எவ்வளவு செலவாகும்?
ஒரு இணைப்புக்கு மாதத்திற்கு US$ 9 முதல் US$ 0.75 வரை, நீங்கள் இணைப்புகளைச் சேர்க்கும்போது குறைகிறது; ஒவ்வொரு நெட்வொர்க்கிலும் ஒரே விலை. posts API, media upload மற்றும் MCP கனெக்டர் சேர்க்கப்பட்டுள்ளன; முதல் 3 நாட்கள் இலவசம்.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: