لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

نئی Nuvemshop اور Tiendanube پروڈکٹس Instagram، TikTok اور Facebook پر خودکار پوسٹ کریں

Nuvemshop یا Tiendanube ایپ کا product/created ویب ہک ہر نئی پروڈکٹ کو easyCoexistence کے ذریعے Instagram، TikTok اور Facebook پر پوسٹ کر سکتا ہے۔ n8n یا ایک مختصر اسکرپٹ پروڈکٹ حاصل کرتا ہے، اس کی مرکزی تصویر کو Instagram کے لیے JPEG میں بدلتا ہے اور متن، تصویر اور لنک easyCoexistence کے posts API کو بھیجتا ہے، جو ہر نیٹ ورک کے سرکاری API کے ذریعے ابھی یا بعد میں شائع کرتا ہے۔ Claude Nuvemshop کے اپنے کنیکٹر کے ساتھ درخواست پر پروڈکٹس پوسٹ کرتا ہے۔

3 seconds

Nuvemshop ویب ہک کے 2XX جواب کا کتنی دیر انتظار کرتا ہے، اس سے پہلے کہ دوبارہ کوشش کرے، 48 گھنٹوں کے اندر 16 کوششوں تک۔

store_id, event, id

وہ فیلڈز جو Nuvemshop پروڈکٹ ویب ہک میں آتے ہیں، ٹائم اسٹیمپ کے ساتھ اور پروڈکٹ کی تفصیلات کے بغیر، اس لیے پروڈکٹ GET /products/{id} سے پڑھی جاتی ہے۔

x-linkedstore-hmac-sha256

وہ ہیڈر جس میں ہر ویب ہک کا HMAC-SHA256 دستخط ہوتا ہے، جو ایپ کے کلائنٹ سیکرٹ سے بنایا جاتا ہے، اسٹور کے رسائی ٹوکن سے نہیں۔

WebP

وہ فارمیٹ جس میں Nuvemshop آپٹمائزیشن کے بعد پروڈکٹ تصاویر فراہم کر سکتا ہے، اور اس تبدیلی کو بند کرنے کا کوئی API آپشن نہیں۔

admin-mcp.nuvemshop.com.br

وہ پتہ جو Nuvemshop کا ہیلپ سینٹر اپنے MCP کنیکٹر کو Claude میں حسب ضرورت کنیکٹر کے طور پر شامل کرنے کے لیے دیتا ہے۔

1080 × 1920

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 پر جو آپ مقرر کریں۔

1product/createdNuvemshop's webhook, signed
2GET /products/{id}Name, images, variants, canonical_url
3Checkvisibility visible, at least one image
4Posts APIOne call per account, now or later

Nuvemshop ایپ اور اس کا ویب ہک کیسے سیٹ اپ کریں؟

ایک بار، Partners Portal اور ٹرمینل سے۔ Nuvemshop یا Tiendanube پارٹنر کے طور پر رجسٹر ہوں، Apps کے تحت read_products کے ساتھ ایپ بنائیں، جو پروڈکٹ تصاویر اور ویرینٹس کا بھی احاطہ کرتا ہے، اور اسے اپنے اسٹور میں انسٹال کریں۔ آپ کے redirect URL پر بھیجا گیا authorization code 5 منٹ تک چلتا ہے اور https://www.tiendanube.com/apps/authorize/token پر ایک رسائی ٹوکن اور user_id کے بدلے میں تبدیل کیا جاتا ہے، جو اسٹور کی ID ہے؛ ٹوکن اس وقت تک ختم نہیں ہوتا جب تک اس ایپ اور اسٹور کے لیے نیا نہ لیا جائے یا ایپ ان انسٹال نہ ہو۔ پھر POST /webhooks کے ساتھ ویب ہک رجسٹر کریں۔ ہر درخواست میں Authorization: Bearer ٹوکن کے ساتھ اور User-Agent ہوتا ہے جو آپ کی ایپ اور ایک رابطے کا نام دیتا ہے، ورنہ Nuvemshop 400 جواب دیتا ہے۔

Register the product/created webhook
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 پر سیٹ ہو، Nuvemshop کی 3 سیکنڈ کی حد کے اندر جواب دیتا ہے۔ ایک Extract From File نوڈ باڈی کو متن میں بدلتا ہے، ایک Crypto نوڈ اس کا Hmac with SHA256 اور HEX کے ساتھ حساب لگاتا ہے، جسے ایپ کے کلائنٹ سیکرٹ کی کے ساتھ کیا جاتا ہے، اور ایک If نوڈ ورک فلو کو صرف اس وقت جاری رہنے دیتا ہے جب نتیجہ x-linkedstore-hmac-sha256 ہیڈر کے برابر ہو۔

پھر ایک HTTP درخواست نوڈ اسٹور کے ٹوکن کے ساتھ GET /products/{{ $json.id }} پڑھتا ہے۔ ایک If نوڈ اس وقت جاری رہتا ہے جب visibility کی قدر visible ہو اور images خالی نہ ہو، اور ایک Remove Duplicates نوڈ جو Remove Items Processed in Previous Executions پر سیٹ ہو، وہ پروڈکٹ ہٹا دیتا ہے جو پہلے ہی پوسٹ ہو چکی ہو، کیونکہ Nuvemshop ایک ہی نوٹس دو بار بھیج سکتا ہے۔ Instagram کے لیے ایک HTTP درخواست نوڈ مرکزی تصویر ایک فائل کے طور پر ڈاؤن لوڈ کرتا ہے، ایک Edit Image نوڈ اسے jpeg فارمیٹ کے ساتھ ری سائز کرتا ہے، اور ایک HTTP درخواست نوڈ اسے n8n Binary File کے طور پر POST /api/v1/media کو بھیجتا ہے، جو media_id واپس کرتا ہے۔ ہر اکاؤنٹ کے لیے ایک HTTP درخواست POST /api/v1/channels/<account_id>/posts کو کال کرتا ہے۔

1WebhookRaw Body on, Respond Immediately
2Crypto and IfHMAC-SHA256 against the header
3HTTP RequestGET the product, then its main image
4Edit ImageResized, Format jpeg, sent to POST /media
5HTTP RequestPOST /channels/:id/posts per account

اسکرپٹ n8n کے بغیر پروڈکٹس کیسے پوسٹ کرتا ہے؟

ایک چھوٹے ویب اینڈ پوائنٹ کے ساتھ۔ ذیل میں دیا گیا Python کوڈ ایپ کے کلائنٹ سیکرٹ کے ساتھ خام باڈی کے مقابل دستخط جانچتا ہے، فوراً 200 جواب دیتا ہے اور باقی کام پس منظر میں کرتا ہے: یہ پروڈکٹ پڑھتا ہے، جو نظر نہ آنے والی ہو یا جس کی تصویر نہ ہو اسے چھوڑ دیتا ہے، اور مرکزی تصویر کو Pillow سے JPEG میں بدلتا ہے جس کا ہر طرف زیادہ سے زیادہ 1080 پکسل ہو، جسے Instagram اور TikTok دونوں قبول کرتے ہیں۔ یہ وہ فائل POST /media پر اپ لوڈ کرتا ہے، Instagram اور TikTok پر پوسٹ کرتا ہے، اور Facebook پر لنک پوسٹ بناتا ہے۔ ہر کال میں ایک Idempotency-Key ہوتی ہے جو پروڈکٹ اور اکاؤنٹ سے بنتی ہے، جسے easyCoexistence قبول کرتا ہے، اور پوسٹ شدہ IDs کا ایک سیٹ دہرائی گئی نوٹس کو دو بار پوسٹ ہونے سے روکتا ہے۔

Python: post each new Nuvemshop product (pip install flask requests pillow)
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 درخواست پر پروڈکٹس کیسے پوسٹ کرتے ہیں؟

Nuvemshop کے اپنے کنیکٹر کے ساتھ جو easyCoexistence کے کنیکٹر کے ساتھ ہوتا ہے۔ Nuvemshop کا ہیلپ سینٹر ایک AI کنیکٹر کی وضاحت کرتا ہے جو MCP پر بنا ہے اور Claude کے ساتھ، ChatGPT کے کنیکٹرز کے ذریعے اور Cursor جیسے ایڈیٹرز کے ساتھ کام کرتا ہے؛ Claude میں اسے https://admin-mcp.nuvemshop.com.br پر حسب ضرورت کنیکٹر کے طور پر شامل کیا جاتا ہے، اور اس کے ریڈ ٹولز پروڈکٹس، آرڈرز اور کسٹمرز تلاش کرتے ہیں۔ مثال کے طور پر پوچھیں: “ہماری پانچ نئی پروڈکٹس TikTok پر کل سے، ہر گھنٹے ایک، صبح 10 بجے (ساؤ پاؤلو کا وقت) ہر ایک کے کیپشن کے ساتھ پوسٹ کریں۔” اسسٹنٹ پروڈکٹس پڑھتا ہے، کیپشن لکھتا ہے اور 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 کے ذریعے میڈیا: POST /media سے ایک HTTPS لنک یا media_id، 30 MB تک کی تصاویر کے ساتھ، جو پوسٹ شیڈول ہونے پر کاپی ہوتی ہیں۔
  • کیپشنز: Nuvemshop کا نام اور تفصیل زبان کے کلید والے آبجیکٹ ہیں، جیسے pt یا es، اور تفصیل HTML ہے، اس لیے ایک زبان چنیں اور ٹیگز ہٹا دیں۔

اسے کیسے سیٹ اپ کریں

  1. 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.
  2. 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.
  3. 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 کے ساتھ یہ کام کرنا

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 اور شاپ کو Meta سے جوڑتا ہے تاکہ Instagram اور Facebook پر فروخت ہو، جیسا کہ Nuvemshop کا ہیلپ سینٹر بتاتا ہے، جسے ایڈمن میں Canais de venda سے کھولا جاتا ہے۔ یہ فلو ہر نئی پروڈکٹ کے لیے فیڈ پوسٹ شائع کرتا ہے۔

Nuvemshop پروڈکٹس پوسٹ کرنے کے لیے easyCoexistence کی قیمت کتنی ہے؟

ہر نیٹ ورک پر یکساں، فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، جیسے جیسے کنکشن بڑھائیں قیمت کم ہوتی ہے۔ posts API، میڈیا اپ لوڈ اور MCP کنیکٹر شامل ہیں، پہلے 3 دن مفت۔

مزید پڑھیں

Shopify پروڈکٹس کو Instagram، TikTok اور Facebook پر خودکار پوسٹ کریںShopify Flow، n8n یا Claude سے نئی پروڈکٹس Instagram، TikTok، Facebook اور دیگر پر آفیشل APIs کے ذریعے پوسٹ کریں۔n8n سوشل میڈیا آٹومیشن: Instagram، TikTok، Facebook اور مزیدn8n میں Instagram، TikTok، Facebook اور YouTube خودکار بنائیں: ویب ہک نوڈ میں دستخط شدہ Instagram، Facebook اور TikTok ایونٹس، اور 35+ MCP ٹولز والا AI ایجنٹ۔AI کی لکھی پوسٹس شائع ہونے سے پہلے کیسے منظور کریںAI پوسٹس میں انسان شامل رکھیں: چیٹ میں ڈرافٹ، قطار میں نظرثانی کی مہلت، شائع ہونے سے پہلے تدوین اور منسوخی، اور ہر نیٹ ورک کی حدود۔WhatsApp، Instagram اور Messenger پر AI کسٹمر سروس: اپنے AI کے ساتھ گاہکوں کو جواب دیںاپنے AI سے WhatsApp، Instagram اور Messenger پر کسٹمرز کو جواب دیں: 24 گھنٹے کی ونڈو، ٹیمپلیٹس، چیٹ کسی شخص کو سونپنا اور کیا خودکار کریں۔Python سے ایک API کے ذریعے Instagram، TikTok اور Facebook پر پوسٹ کریںPython سے Instagram، Facebook، TikTok، YouTube اور LinkedIn پر پوسٹ شائع کریں، کمنٹس پڑھیں اور DMs کا جواب دیں، ہر نیٹ ورک کے سرکاری API کے ذریعے۔ایک API سے Instagram، TikTok، Facebook، YouTube اور LinkedIn پر پوسٹ کریںClaude، ChatGPT یا کوڈ سے Instagram، TikTok، Facebook، YouTube اور LinkedIn پر پوسٹس شائع اور شیڈول کریں۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ