تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

نشر منتجات Nuvemshop و Tiendanube الجديدة تلقائيًا على Instagram و TikTok و Facebook

يمكن لخطاف الويب (webhook) الخاص بحدث product/created في تطبيق Nuvemshop أو Tiendanube أن يُنشئ منشورًا لكل منتج جديد على Instagram و TikTok و Facebook عبر easyCoexistence: يجلب n8n أو سكربت قصير المنتج، ويحوّل صورته الرئيسية إلى JPEG من أجل Instagram، ثم يرسل النص والصورة والرابط إلى واجهة برمجة التطبيقات (API) الخاصة بالمنشورات في easyCoexistence، فتنشر هذه الواجهة المنشور عبر الـ API الرسمية لكل شبكة، الآن أو لاحقًا. ويتولى Claude نشر المنتجات عند الطلب باستخدام الموصل الخاص بـ Nuvemshop.

3 seconds

المدة التي ينتظرها Nuvemshop لاستجابة 2XX على webhook قبل إعادة المحاولة، بحد أقصى 16 محاولة خلال 48 ساعة.

store_id, event, id

الحقول التي يحملها webhook المنتج في Nuvemshop، مع الطابع الزمني دون تفاصيل المنتج، لذلك يُقرأ المنتج عبر GET /products/{id}.

x-linkedstore-hmac-sha256

الترويسة التي تحمل توقيع HMAC-SHA256 لكل webhook، والمُوقَّع بالمفتاح السري للتطبيق (client secret) وليس برمز الوصول (token) الخاص بالمتجر.

WebP

الصيغة التي قد يقدّم بها Nuvemshop صور المنتجات بعد التحسين، دون خيار في API لإيقاف هذا التحويل.

admin-mcp.nuvemshop.com.br

العنوان الذي يقدّمه مركز مساعدة Nuvemshop لإضافة موصل MCP الخاص به إلى Claude كموصل مخصص.

1080 × 1920

أكبر صورة يقبلها منشور الصور في TikTok، أي 1920 × 1080، بصيغة JPG أو WebP وبحجم يصل إلى 20 MB.

كيف يتحوّل منتج Nuvemshop الجديد إلى منشور؟

عبر تطبيق و webhook واستدعاء واحد لكل حساب. تنتمي webhooks الخاصة بـ Nuvemshop إلى التطبيق، لذا أنشئ تطبيقًا بنطاق read_products وثبّته في متجرك، ثم سجّل webhook لحدث product/created يشير إلى سير عمل n8n أو إلى خادمك. يحتوي الإشعار على معرّف المتجر والحدث ومعرّف المنتج دون تفاصيله، لذا يقرأ سير العمل المنتج عبر GET /products/{id}، ويتحقق من أنه مرئي ويحمل صورة، ثم يرسل طلبًا واحدًا لكل حساب إلى API المنشورات في easyCoexistence: منشور صور لـ 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 و webhook الخاص به؟

يُنجز ذلك مرة واحدة، من Partners Portal ومن الطرفية. سجّل شريكًا في Nuvemshop أو Tiendanube، وأنشئ تطبيقًا ضمن Apps بنطاق read_products، وهو يشمل أيضًا صور المنتجات والمتغيرات، ثم ثبّته في متجرك. يُرسل رمز التفويض إلى عنوان إعادة التوجيه الخاص بك ويبقى صالحًا 5 دقائق، ويُستبدل عبر https://www.tiendanube.com/apps/authorize/token برمز الوصول وuser_id، وهو معرّف المتجر. لا تنتهي صلاحية الـ token إلا عند الحصول على رمز جديد لذلك التطبيق والمتجر، أو عند إلغاء تثبيت التطبيق. ثم سجّل الـ webhook عبر POST /webhooks. يحمل كل طلب الترويسة Authorization: Bearer مع الـ token، والترويسة 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 بكل منتج؟

الرد والتحقق والقراءة والتحويل والنشر. تردّ عقدة Webhook مع تفعيل Raw Body وضبط Respond على Immediately خلال مهلة Nuvemshop البالغة 3 ثوانٍ. تحوّل عقدة Extract From File الجسم إلى نص، وتحسب عقدة Crypto قيمة Hmac بخوارزمية SHA256 وترميز HEX، بالمفتاح السري للتطبيق (client secret)، وتسمح عقدة If بمتابعة التشغيل فقط إذا تطابقت النتيجة مع الترويسة x-linkedstore-hmac-sha256.

ثم تقرأ عقدة HTTP Request المنتج عبر GET /products/{{ $json.id }} بالـ token الخاص بالمتجر. تتابع عقدة If عندما تكون visibility مساوية لـ visible وimages غير فارغة، وتُسقط عقدة Remove Duplicates، المضبوطة على Remove Items Processed in Previous Executions، المنتج الذي نُشر من قبل، لأن Nuvemshop قد يرسل الإشعار نفسه مرتين. أما لـ Instagram فتنزّل عقدة HTTP Request الصورة الرئيسية كملف، وتغيّر عقدة Edit Image حجمها مع jpeg بوصفه Format، وترسلها عقدة HTTP Request بصيغة n8n Binary File إلى POST /api/v1/media، فتعيد media_id. ولكل حساب تستدعي عقدة HTTP Request واحدة المسار 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؟

بواسطة نقطة نهاية (endpoint) ويب صغيرة. يتحقق سكربت Python أدناه من التوقيع على الجسم الخام بالمفتاح السري للتطبيق، ويردّ بالرمز 200 فورًا، ويُنجز الباقي في الخلفية: يقرأ المنتج، ويتخطى المنتج غير المرئي أو الذي لا يملك صورة، ويحوّل الصورة الرئيسية بمكتبة Pillow إلى JPEG بحد أقصى 1080 بكسل لكل ضلع، وهي الصيغة التي يقبلها كلٌّ من Instagram و TikTok. يرفع الملف إلى POST /media، وينشره على Instagram و TikTok، وينشر منشور رابط على Facebook. يحمل كل استدعاء ترويسة Idempotency-Key مكوّنة من المنتج والحساب، ويحترمها easyCoexistence، وتمنع مجموعة المعرّفات المنشورة تكرار النشر إذا تكرر الإشعار.

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 موصل ذكاء اصطناعي مبنيًا على MCP يعمل مع Claude، ومع ChatGPT عبر موصلاته، ومع محررات مثل Cursor؛ وفي Claude يُضاف كموصل مخصص على العنوان https://admin-mcp.nuvemshop.com.br، وتبحث أدوات القراءة فيه في المنتجات والطلبات والعملاء. اطلب مثلًا: «انشر أحدث خمسة منتجات لدينا على TikTok ابتداءً من الغد الساعة 10 صباحًا بتوقيت ساو باولو، منشور كل ساعة، مع نص منشور لكل منها.» يقرأ المساعد المنتجات، ويكتب نصوص المنشورات، ويجدول كل منشور عبر scheduled_at. يتصرف عند الطلب فقط، ولا يراقب المتجر بين المحادثات، لذلك تُنشر المنتجات المضافة ليلًا عبر webhook.

ماذا تقبل كل شبكة في منشور المنتج؟

تُطبَّق قواعد كل شبكة، مع فحوصات easyCoexistence الخاصة فوقها، عند إرسال المنشور أو جدولته، فيُرفض المنتج الذي لا يمكن نشره فورًا:

  • Instagram: صور JPEG فقط، لذا حوّل صورة المنتج بصيغة WebP أو PNG أولًا، وتشكّل عدة صور عرضًا منزلقًا (carousel). لا يحتوي المنشور على حقل للرابط، لذا يُكتب عنوان المنتج في النص كنص عادي.
  • TikTok: منشورات صور من 1 إلى 35 صورة بصيغة JPG أو WebP، كل صورة حتى 1080 × 1920 أو 1920 × 1080 بكسل وبحجم 20 MB، وعنوان من 90 حرفًا، و15 منشور صور لكل حساب يوميًا.
  • Facebook: منشور رابط إلى canonical_url الخاص بالمنتج، مع المعاينة التي يبنيها Facebook من وسوم Open Graph في الصفحة، أو صورة واحدة مع العنوان في النص.
  • الوسائط عبر easyCoexistence: رابط HTTPS أو media_id من POST /media، مع صور تصل إلى 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 بعد خروج المنشورات. فهو ينتظر 3 ثوانٍ للحصول على استجابة 2XX ثم يعيد المحاولة، حتى 16 مرة خلال 48 ساعة، لذا ردّ أولًا وانشر لاحقًا.
  • إرسال صورة المنتج إلى Instagram كما يقدّمها Nuvemshop. فقد يسلّم Nuvemshop صيغة WebP مهما كان امتداد العنوان، ولا ينشر Instagram إلا بصيغة JPEG، لذا تحقّق من Content-Type للملف وحوّله.
  • التحقق من التوقيع بالـ token الخاص بالمتجر. فيوقّع Nuvemshop بالمفتاح السري للتطبيق على الجسم الخام، لذا احسب HMAC قبل تحليل الجسم.
  • نشر المنتج لحظة إنشائه. فقد يبدأ مخفيًا أو بلا صور، لذا تحقّق من visibility وimages، واستمع أيضًا إلى product/updated، وانشر كل منتج مرة واحدة.
إنجاز ذلك باستخدام EasyCoexistence

يمنح easyCoexistence متجرك، ووكلاء الذكاء الاصطناعي الذين يشغّلونه، وصولًا إلى العملاء عبر Instagram و TikTok و Facebook وقنوات أخرى، كلٌّ منها عبر الـ API الرسمية الخاصة بها: واجهة للمنشورات ولرفع الوسائط لـ n8n وسكربتاتك، وموصل MCP واحد لـ Claude وChatGPT إلى جانب موصل Nuvemshop، وطابور نشر يجدول المنشورات حتى 90 يومًا مقدمًا، مع مراقبة كل اتصال على مدار الساعة. من 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 للمتغيرات بالسعر الذي نشرته آخر مرة؛ فالإشعار يحمل معرّف المنتج لا تفاصيله، لذا اقرأ المنتج في كل مرة.

ماذا تفعل قناة Instagram وFacebook الخاصة بـ Nuvemshop؟

تربط القناة كتالوج المتجر وPixel ومتجره بـ Meta للبيع عبر Instagram وFacebook، كما يصفها مركز مساعدة Nuvemshop، من Canais de venda في لوحة الإدارة. أما هذا المسار فينشر منشور خلاصة (feed) لكل منتج جديد.

كم تكلفة easyCoexistence لنشر منتجات Nuvemshop؟

من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، وبالسعر نفسه على كل شبكة. واجهة المنشورات ورفع الوسائط وموصل MCP مشمولة جميعها، مع فترة تجريبية مجانية لأول 3 أيام.

تابع القراءة

النشر التلقائي لمنتجات Shopify على Instagram وTikTok وFacebookانشر المنتجات الجديدة من Shopify Flow أو n8n أو Claude على Instagram وTikTok وFacebook وغيرها، عبر واجهات المنصات الرسمية.أتمتة وسائل التواصل الاجتماعي في n8n: Instagram وTikTok وFacebook وغيرهاأتمتة Instagram وTikTok وFacebook وYouTube في n8n: أحداث Instagram وFacebook وTikTok موقعة في عقدة Webhook، ووكيل AI مع أكثر من 35 أداة MCP.كيف توافق على منشورات الذكاء الاصطناعي قبل نشرهااحتفظ بشخص في المراجعة لمنشورات الذكاء الاصطناعي: مسودات في المحادثة، وقائمة انتظار نافذة للمراجعة، والتعديل والإلغاء قبل النشر، وما تسمح به كل شبكة.خدمة العملاء بالذكاء الاصطناعي على WhatsApp وInstagram وMessenger: رُدّ على عملائك بذكائك الاصطناعي الخاصرُدّ على عملائك عبر WhatsApp وInstagram وMessenger بذكائك الاصطناعي الخاص، مع نوافذ الرد لمدة 24 ساعة، والقوالب، وتسليم المحادثة إلى شخص.النشر على Instagram وTikTok وFacebook من Python عبر واجهة برمجة تطبيقات واحدة (API)انشر وأجب على التعليقات والرسائل من Python على Instagram وFacebook وTikTok وYouTube وLinkedIn، عبر واجهة كل شبكة الرسمية.انشر على Instagram وTikTok وFacebook وYouTube وLinkedIn بواجهة API واحدةانشر وجدول منشورات Instagram وReels وStories وفيديوهات TikTok ومنشورات صفحات Facebook ورفع YouTube ومنشورات LinkedIn من Claude أو ChatGPT أو من كودك.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في