নতুন 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 বার পর্যন্ত।
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 পার্টনার হিসেবে নিবন্ধন করুন, Apps-এর অধীনে read_products সহ একটি অ্যাপ তৈরি করুন, যা পণ্যের ছবি ও ভেরিয়েন্টও কভার করে, এবং আপনার স্টোরে ইনস্টল করুন। আপনার redirect URL-এ পাঠানো অনুমোদন কোডের মেয়াদ 5 মিনিট, যা https://www.tiendanube.com/apps/authorize/token-এ বিনিময় করে একটি অ্যাক্সেস টোকেন এবং 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 নোড SHA256 ও HEX-এ এর Hmac গণনা করে, অ্যাপের ক্লায়েন্ট সিক্রেটকে কী হিসেবে ব্যবহার করে, এবং একটি 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 দিয়ে 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-তে তার কানেক্টরের মাধ্যমে এবং 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-এ একটি লিংক পোস্ট, যার প্রিভিউ পেজের 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-ও শুনুন এবং variants-এর 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 পর্যবেক্ষণ
যাচাই করা হয়েছে