התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

פרסום אוטומטי של מוצרים חדשים מ-Nuvemshop ו-Tiendanube ל-Instagram, TikTok ו-Facebook

אפליקציה של Nuvemshop או Tiendanube יכולה לפרסם כל מוצר חדש ל-Instagram, ל-TikTok ול-Facebook דרך EasyCoexistence: וובהוק (Webhook) מסוג product/created מפעיל זרימת n8n או סקריפט קצר, שמביא את המוצר, ממיר את התמונה הראשית ל-JPEG עבור Instagram ושולח טקסט, תמונה וקישור אל ה-API של הפרסומים של EasyCoexistence. EasyCoexistence מפרסמת כל פוסט דרך ה-API הרשמי של הרשת, מיד או במועד מאוחר יותר. Claude מפרסם מוצרים לפי בקשה דרך המחבר של Nuvemshop עצמה.

3 seconds

הזמן שבו Nuvemshop ממתינה לתשובה 2XX לוובהוק לפני ניסיון חוזר, עד 16 ניסיונות תוך 48 שעות.

store_id, event, id

שדות הוובהוק של מוצר ב-Nuvemshop כוללים חותמת זמן ללא פרטי מוצר, ולכן את המוצר קוראים בבקשה נפרדת ל-GET /products/{id}, לא מתוך ההודעה.

x-linkedstore-hmac-sha256

הכותרת שנושאת את חתימת ה-HMAC-SHA256 של כל וובהוק, מפתחה הוא סוד הלקוח של האפליקציה, לא אסימון גישה (Access Token) של החנות.

WebP

הפורמט שבו Nuvemshop עשויה להגיש תמונות מוצר אחרי אופטימיזציה, ללא אפשרות ב-API לבטל את ההמרה.

admin-mcp.nuvemshop.com.br

הכתובת ששולח מרכז העזרה של Nuvemshop לחיבור המחבר שלה ל-Claude כמחבר מותאם אישית.

1080 × 1920

התמונה הגדולה ביותר שפוסט תמונה ב-TikTok מקבל: 1920 × 1080, בפורמט JPG או WebP, עד 20 MB לקובץ.

איך מוצר חדש ב-Nuvemshop הופך לפוסט?

דרך אפליקציה, וובהוק וקריאה אחת לכל חשבון. הוובהוקים של Nuvemshop שייכים לאפליקציה, לכן יוצרים אחת כזאת עם ההרשאה read_products, מתקינים אותה בחנות ורושמים וובהוק ל-product/created שמצביע על זרימת העבודה ב-n8n או על השרת. ההודעה מכילה את מזהה החנות, את האירוע ואת מזהה המוצר, בלי פרטי מוצר, ולכן זרימת העבודה קוראת את המוצר דרך GET /products/{id}, בודקת שהוא גלוי ושיש לו תמונה, ושולחת בקשה אחת לכל חשבון אל ה-API של הפרסומים של EasyCoexistence: פוסט תמונה ל-Instagram ול-TikTok, ופוסט קישור ל-Facebook. EasyCoexistence מפרסמת כל אחד דרך ה-API הרשמי של הרשת, מיד או בזמן שקבעתם.

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, שמכסה גם תמונות מוצר ווריאציות, ומתקינים אותה בחנות. קוד ההרשאה שנשלח לכתובת ההפניה שלכם תקף 5 דקות, ומחליפים אותו בכתובת https://www.tiendanube.com/apps/authorize/token לאסימון גישה ול-user_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 עושה עם כל מוצר?

מענה, אימות, קריאה, המרה ופרסום. צומת Webhook עם Raw Body פעיל ו-Respond מוגדר ל-Immediately עונה בתוך 3 השניות שנותנת Nuvemshop. צומת Extract From File הופך את הגוף לטקסט, צומת Crypto מחשב את ה-Hmac עם SHA256 ו-HEX, כשהמפתח הוא סוד הלקוח של האפליקציה, וצומת 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 שולח אותה כ-Binary File של n8n אל 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?

עם נקודת קצה קטנה ברשת. הסקריפט בפייתון שלהלן בודק את החתימה מול הגוף הגולמי עם סוד הלקוח של האפליקציה, עונה 200 מיד, ומבצע את השאר ברקע: קורא את המוצר, מדלג על מוצר שאינו גלוי או בלי תמונה, וממיר את התמונה הראשית עם Pillow ל-JPEG שצלעו הארוכה לא עולה על 1080 פיקסלים, פורמט ש-Instagram וגם TikTok מקבלים. הוא מעלה את הקובץ אל POST /media, מפרסם אותו ב-Instagram וב-TikTok, ויוצר פוסט קישור ב-Facebook. לכל קריאה יש כותרת Idempotency-Key שנבנית מהמוצר ומהחשבון, ו-EasyCoexistence מכבדת אותה, וקבוצה של מזהים שפורסמו מונעת מהודעה חוזרת מ-Nuvemshop לפרסם פעמיים.

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:00 לפי שעון סאו פאולו, אחד בכל שעה, עם כיתוב לכל אחד." העוזר קורא את המוצרים, כותב את הכיתובים ומתזמן כל פוסט לפי השדה 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 של הדף, או תמונה אחת עם הכתובת בטקסט.
  • מדיה דרך 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 מגישה אותה. היא עשויה להגיש WebP ללא תלות בסיומת הכתובת, ו-Instagram מפרסם רק JPEG, ולכן בודקים את Content-Type של הקובץ וממירים אותו.
  • אימות החתימה באמצעות אסימון הגישה של החנות. Nuvemshop חותמת עם סוד הלקוח של האפליקציה, על הגוף הגולמי, ולכן מחשבים את ה-HMAC לפני שהגוף מנותח.
  • פרסום מוצר מיד בעת יצירתו. הוא עשוי להתחיל מוסתר או בלי תמונות, ולכן בודקים את הנראות ואת התמונות, מאזינים גם ל-product/updated, ומפרסמים כל מוצר פעם אחת.
עושים את זה עם EasyCoexistence

EasyCoexistence נותנת לחנות שלכם, ולסוכני ה-AI שמפעילים אותה, גישה ללקוחות ב-Instagram, ב-TikTok, ב-Facebook ובערוצים נוספים, כל אחד דרך ה-API הרשמי שלו: ממשק API לפרסומים והעלאת מדיה עבור n8n והסקריפטים שלכם, שרת MCP אחד ל-Claude ול-ChatGPT, לצד המחבר של Nuvemshop, ותור שמפרסם עד 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 ומשווים את promotional_price של הווריאציות למחיר שפורסם לאחרונה; ההודעה נושאת את מזהה המוצר ולא את פרטיו, ולכן קוראים את המוצר בכל פעם מחדש.

מה עושה הערוץ המקורי של Nuvemshop ל-Instagram ול-Facebook?

הוא מחבר את הקטלוג, ה-Pixel והחנות לחשבון Meta כדי למכור ב-Instagram וב-Facebook, כפי שמתואר במרכז העזרה של Nuvemshop, מתוך Canais de venda בממשק הניהול. הזרימה הזו מפרסמת פוסט פיד לכל מוצר חדש.

כמה עולה EasyCoexistence לפרסום מוצרים של Nuvemshop?

US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, זהה בכל רשת. ה-API לפרסומים, העלאת המדיה ושרת ה-MCP כלולים, ועם 3 הימים הראשונים בחינם.

המשיכו לקרוא

פרסום אוטומטי של מוצרי Shopify ל-Instagram, TikTok ו-Facebookפרסום מוצרים חדשים מ-Shopify Flow, n8n או Claude ל-Instagram, TikTok, Facebook ועוד, דרך ממשקי API רשמיים.אוטומציה לרשתות חברתיות ב-n8n: Instagram, TikTok, Facebook ועודאוטומציה ב-n8n ל-Instagram, TikTok, Facebook ו-YouTube: אירועי Instagram, Facebook ו-TikTok חתומים לצומת Webhook וסוכן AI עם 35+ כלי MCPאיך מאשרים פוסטים שנכתבו ב-AI לפני שהם יוצאים לאווירהשאירו אדם בתהליך על פוסטים שנכתבו ב-AI: טיוטות בצ'אט, תור לבדיקה, עריכה וביטול לפני הפרסום, ומה כל רשת מאפשרת לערוך.שירות לקוחות עם AI ב-WhatsApp, Instagram ו-Messenger: השיבו ללקוחות עם ה-AI שלכםהגיבו ללקוחות ב-WhatsApp, Instagram ו-Messenger עם ה-AI שלכם: חלונות 24 השעות, תבניות, העברה לאיש צוות ומה כדאי להפוך לאוטומטי.פרסום ב-Instagram, ב-TikTok וב-Facebook מ-Python דרך ממשק API אחדפרסום פוסטים, קריאת תגובות ומענה להודעות DM ב-Instagram, Facebook, TikTok, YouTube ו-LinkedIn מ-Python, דרך ה-API הרשמי של כל רשת.פרסום ב-Instagram, TikTok, Facebook, YouTube ו-LinkedIn עם ממשק API אחדפרסום ותזמון ב-Instagram, TikTok, Facebook, YouTube ו-LinkedIn מ-Claude, מ-ChatGPT או מהקוד שלכם, בפורמטים של כל רשת.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-