නව Nuvemshop සහ Tiendanube නිෂ්පාදන Instagram, TikTok සහ Facebook වෙත ස්වයංක්රීයව post කරන්න
Nuvemshop හෝ Tiendanube යෙදුමක product/created webhook එකට එක් එක් නව නිෂ්පාදනය easyCoexistence හරහා Instagram, TikTok සහ Facebook වෙත post කළ හැක: n8n හෝ කෙටි script එකක් නිෂ්පාදනය ලබාගෙන, ප්රධාන ඡායාරූපය Instagram සඳහා JPEG බවට පරිවර්තනය කර, පෙළ, ඡායාරූපය සහ සබැඳිය easyCoexistence හි posts API එකට යවයි; එය එක් එක් network එකේ official API හරහා, දැන් හෝ පසුව, ප්රකාශයට පත් කරයි. Claude, Nuvemshop හි තමන්ගේම connector එක සමඟ ඉල්ලීමෙන් නිෂ්පාදන post කරයි.
නැවත උත්සාහ කිරීමට පෙර Nuvemshop webhook එකකට 2XX පිළිතුරක් සඳහා බලා සිටින කාලය, පැය 48ක් තුළ උත්සාහ 16 දක්වා.
Nuvemshop product webhook එක රැගෙන යන ක්ෂේත්ර, කාල මුද්රාව සහිතව, නිෂ්පාදන විස්තර නැතිව, එබැවින් නිෂ්පාදනය GET /products/{id} මගින් කියවයි.
එක් එක් webhook එකේ HMAC-SHA256 අත්සන රැගෙන එන header එක, යෙදුමේ client secret සමඟ යතුරු ගසා ඇත, store එකේ access token එකෙන් නොවේ.
Nuvemshop optimization කිරීමෙන් පසු නිෂ්පාදන ඡායාරූප සැපයිය හැකි format එක, පරිවර්තනය ක්රියාවිරහිත කිරීමට API විකල්පයක් නොමැතිව.
Nuvemshop Help Center මගින් Claude වෙත custom connector ලෙස තමන්ගේම MCP connector එක එකතු කිරීමට දෙන ලිපිනය.
TikTok photo post එකකට ගත හැකි විශාලතම රූපය, හෝ 1920 × 1080, JPG හෝ WebP ආකාරයෙන්, MB 20 දක්වා.
නව Nuvemshop නිෂ්පාදනය post එකක් වන්නේ කෙසේද?
යෙදුමක්, webhook එකක් සහ එක් ගිණුමකට එක් request එකක් හරහා. Nuvemshop හි webhooks යෙදුමකට අයත් වන නිසා, read_products scope එක සහිතව එකක් සාදා, ඔබේ store එකේ ස්ථාපනය කර, product/created සඳහා ඔබේ n8n workflow එකට හෝ server එකට ලක්ෂ්යගත වන webhook එකක් ලියාපදිංචි කරන්න. දැන්වීමේ store ID, event සහ නිෂ්පාදනයේ ID අඩංගු වන අතර නිෂ්පාදන විස්තර නැත, එබැවින් workflow එක GET /products/{id} සමඟ නිෂ්පාදනය කියවා, එය දෘශ්යමාන දැයි සහ ඡායාරූපයක් ඇත්දැයි පරීක්ෂා කර, එක් ගිණුමකට එක් request එකක් easyCoexistence හි posts API එකට යවයි: Instagram සහ TikTok සඳහා ඡායාරූප post එකක්, Facebook සඳහා සබැඳි post එකක්. easyCoexistence එක් එක් post එක network එකේ official API හරහා ප්රකාශයට පත් කරයි, ඒ වහාම හෝ ඔබ සකසන publish_at වේලාවේ.
Nuvemshop යෙදුම සහ එහි webhook සකසන්නේ කෙසේද?
එක් වරක්, Partners Portal එකෙන් සහ terminal එකෙන්. Nuvemshop හෝ Tiendanube partner ලෙස ලියාපදිංචි වන්න, Apps යටතේ read_products සහිත යෙදුමක් සාදන්න (මෙය නිෂ්පාදන ඡායාරූප සහ variants ද ආවරණය කරයි), එය ඔබේ store එකේ ස්ථාපනය කරන්න. ඔබේ redirect URL එකට එවන authorization කේතය මිනිත්තු 5ක් වලංගුයි, එය https://www.tiendanube.com/apps/authorize/token හි access token එකක් සහ store එකේ ID වන user_id එකක් සඳහා හුවමාරු කරයි; එම යෙදුම සහ store එක සඳහා නව එකක් ලබාගන්නා තෙක් හෝ යෙදුම ඉවත් කරන තෙක් token එක කල් ඉකුත් නොවේ. ඉන්පසු POST /webhooks සමඟ webhook එක ලියාපදිංචි කරන්න. එක් එක් request එකක් Authorization: Bearer සහ token එක, තවද ඔබේ යෙදුම සහ සම්බන්ධ තොරතුරු නම් කරන 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 workflow එක එක් නිෂ්පාදනයක් සමඟ කරන්නේ කුමක්ද?
පිළිතුරු දෙයි, සත්යාපනය කරයි, කියවයි, පරිවර්තනය කරයි සහ post කරයි. Raw Body සක්රිය කර Respond එක Immediately ලෙස සකසන Webhook node එක, Nuvemshop හි තත්පර 3ක් ඇතුළත පිළිතුරු දෙයි. Extract From File node එක body එක text බවට හරවයි, Crypto node එක එහි Hmac SHA256 සහ HEX සමඟ ගණනය කරයි, යෙදුමේ client secret සමඟ යතුරු ගසා, සහ If node එක, ප්රතිඵලය x-linkedstore-hmac-sha256 header එකට සමාන වූ විට පමණක් run එක ඉදිරියට යාමට ඉඩ දෙයි.
HTTP Request node එක store එකේ token සමඟ GET /products/{{ $json.id }} කියවයි. visibility visible වන සහ images හිස් නොවන විට ඉදිරියට යන If node එක, සහ Remove Items Processed in Previous Executions ලෙස සකසූ Remove Duplicates node එක, දැනටමත් post කළ නිෂ්පාදනයක් ඉවත් කරයි, මන්ද Nuvemshop එකම දැන්වීම දෙවරක් යැවිය හැකි නිසා. Instagram සඳහා HTTP Request node එක ප්රධාන රූපය file එකක් ලෙස බාගන්නා අතර, 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 අමතයි.
script එකක් n8n නොමැතිව නිෂ්පාදන post කරන්නේ කෙසේද?
කුඩා web endpoint එකකින්. පහත Python, යෙදුමේ client secret සමඟ raw body එකට එරෙහිව අත්සන පරීක්ෂා කර, වහාම 200 පිළිතුරු දී, ඉතිරි දේ පසුබිමේදී කරයි: එය නිෂ්පාදනය කියවයි, දෘශ්යමාන නොවන හෝ ඡායාරූපයක් නැති එකක් මඟ හරියි, සහ ප්රධාන ඡායාරූපය Pillow මගින් එක් පැත්තක පික්සල් 1080ට නොඉක්මවන JPEG එකකට පරිවර්තනය කරයි, එය Instagram සහ TikTok යන දෙකම පිළිගනී. එය POST /media වෙත upload කර, Instagram සහ TikTok වෙත post කර, Facebook හි සබැඳි post එකක් සාදයි. එක් එක් request එක Idempotency-Key එකක් රැගෙන යයි (නිෂ්පාදනයෙන් සහ ගිණුමෙන් සාදන ලද), easyCoexistence එය ගෞරව කරයි, සහ post කළ ID කට්ටලයක් නැවත දැන්වීමක් දෙවරක් post වීම වළක්වයි.
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 ඉල්ලීම මත නිෂ්පාදන post කරන්නේ කෙසේද?
Nuvemshop හි තමන්ගේම connector එක, easyCoexistence හි එක අසලින්. Nuvemshop Help Center විස්තර කරන්නේ MCP මත ගොඩනගන AI connector එකක් Claude සමඟ ක්රියා කරන බව, ChatGPT හි connectors හරහා සහ Cursor වැනි editors සමඟ; Claude හි එය https://admin-mcp.nuvemshop.com.br හි custom connector එකක් ලෙස එකතු කරන අතර, එහි read tools නිෂ්පාදන, ඇණවුම් සහ පාරිභෝගිකයන් සොයයි. උදාහරණයක් ලෙස ඇසන්න: "Post our five newest products to TikTok from tomorrow at 10am São Paulo time, one an hour, with a caption for each." සහායකයා නිෂ්පාදන කියවා, caption එක ලියා, scheduled_at සමඟ එක් එක් post එක කාලසටහන් කරයි. එය ඉල්ලූ විට ක්රියා කරයි, chat අතර store එක නැරඹීම් නොකරයි, එබැවින් රාත්රියේ එකතු කළ නිෂ්පාදන webhook හරහා යයි.
එක් එක් network එක නිෂ්පාදන post එකක් පිළිගන්නේ කුමක්ද?
එක් එක් network එකේ නීති, easyCoexistence හි තමන්ගේම පරීක්ෂාවන් උඩින්, post යවන හෝ කාලසටහන් කරන විට අදාළ වේ, එබැවින් යා නොහැකි නිෂ්පාදනයක් වහාම ප්රතික්ෂේප වේ:
- Instagram: JPEG රූප පමණි, එබැවින් WebP හෝ PNG නිෂ්පාදන ඡායාරූපයක් පළමුව පරිවර්තනය කරන්න; ඡායාරූප කිහිපයක් carousel එකක් සාදයි. Post එකකට link field එකක් නැත, එබැවින් නිෂ්පාදනයේ ලිපිනය caption එකේ පෙළ ලෙස ඇතුළත් කරන්න.
- TikTok: JPG හෝ WebP රූප 1 සිට 35 දක්වා photo posts, එක් එක් පික්සල් 1080 × 1920 හෝ 1920 × 1080 සහ MB 20 දක්වා, අක්ෂර 90ක title එකක්, සහ එක් ගිණුමකට දිනකට photo posts 15ක්.
- Facebook: නිෂ්පාදනයේ
canonical_urlවෙත සබැඳි post එකක්, පිටුවේ Open Graph tags වලින් Facebook ගොඩනගන preview එක සහිතව, නැතහොත් ලිපිනය පෙළේ ඇතිව ඡායාරූපයක් එකක්. - easyCoexistence හරහා media: HTTPS සබැඳියක් හෝ POST /media වෙතින්
media_idඑකක්, රූප MB 30 දක්වා, post එක කාලසටහන් කළ විට පිටපත් කරයි. - Captions: Nuvemshop හි නම සහ විස්තරය pt හෝ es වැනි භාෂාවෙන් යතුරු ගසන objects වන අතර, විස්තරය HTML ය, එබැවින් එක් භාෂාවක් තෝරා tags ඉවත් කරන්න.
එය සකසන ආකාරය
- 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 වෙත පිළිතුරු දීම posts යැවීමෙන් පසුව. එය 2XX සඳහා තත්පර 3ක් රැඳී සිට පසුව නැවත උත්සාහ කරයි, පැය 48ක් තුළ 16 වතාව දක්වා, එබැවින් පළමුව පිළිතුරු දී, පසුව post කරන්න.
- Instagram වෙත Nuvemshop සපයන ආකාරයට නිෂ්පාදන ඡායාරූපය යැවීම. Nuvemshop ලිපිනය කුමක් වුවත් WebP සපයන්න පුළුවන්, Instagram JPEG පමණක් පළ කරයි, එබැවින් file හි Content-Type පරීක්ෂා කර එය පරිවර්තනය කරන්න.
- store හි access token සමඟ අත්සන සත්යාපනය කිරීම. Nuvemshop යෙදුමේ client secret සමඟ raw body එක මත අත්සන් කරයි, එබැවින් body parse කිරීමට පෙර HMAC ගණනය කරන්න.
- නිෂ්පාදනය සෑදූ මොහොතේම post කිරීම. එය සඟවා හෝ ඡායාරූප නොමැතිව ආරම්භ විය හැක, එබැවින් visibility සහ images පරීක්ෂා කර, product/updated ද සවන් දෙන්න, සහ එක් එක් නිෂ්පාදනය එක් වරක් පමණක් post කරන්න.
easyCoexistence ඔබේ store ට සහ එය ක්රියාත්මක කරන AI agents වලට, Instagram, TikTok, Facebook සහ තවත් channels මත පාරිභෝගිකයන් වෙත ළඟාවීමේ හැකියාව ලබා දේ, එක් එක් එක official API හරහා: n8n සහ ඔබේ scripts සඳහා posts API එකක් සහ media upload, Claude සහ ChatGPT සඳහා Nuvemshop හි තමන්ගේම එක අසලින් MCP connector එකක්, සහ දින 90ක් ඉදිරියට ප්රකාශයට පත් කරන queue එකක්, සියලු සම්බන්ධතා 24/7 නිරීක්ෂණය කරමින්. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩු වෙමින්, පළමු දින 3ක නොමිලේ trial කාලය.
නිතර අසන ප්රශ්න
Tiendanube store වලටත් ක්රියා කරයිද?
ඔව්. Nuvemshop සහ Tiendanube එක API එකක් බෙදා ගනී: docs හි එක් එක් tiendanube.com ලිපිනයට nuvemshop.com.br හි එකසමාන ලිපිනයක් ඇති අතර, API පිළිතුරු දෙන්නේ api.tiendanube.com සහ api.nuvemshop.com.br යන දෙකෙහිම.
වට්ටමට යන විට නිෂ්පාදනය නැවත post කළ හැකිද?
ඔව්. product/updated ද සවන් දෙන්න, සහ variants හි promotional_price එක ඔබ අවසන් වරට post කළ එක සමඟ සසඳන්න; දැන්වීමේ ඇත්තේ නිෂ්පාදනයේ ID එක, විස්තර නොවේ, එබැවින් එක් එක් වරම නිෂ්පාදනය කියවන්න.
Nuvemshop හි තමන්ගේම Instagram සහ Facebook channel එක කුමක් කරයි?
එය store එකේ catalog, Pixel සහ shop, Instagram සහ Facebook හි විකිණීම සඳහා Meta සමඟ සම්බන්ධ කරයි, Nuvemshop Help Center විස්තර කරන පරිදි, admin හි Canais de venda වෙතින්. මෙම flow එක සෑම නව නිෂ්පාදනයක් සඳහාම feed post එකක් ප්රකාශයට පත් කරයි.
Nuvemshop නිෂ්පාදන post කිරීම සඳහා easyCoexistence කොපමණ වියදම් කරයිද?
සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩු වෙමින්, සෑම network එකටම එකම. posts API, media upload සහ MCP connector ඇතුළත් වන අතර, පළමු දින 3ක නොමිලේ trial කාලය.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ