Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Awtomatikong i-post ang bagong product mula Nuvemshop at Tiendanube sa Instagram, TikTok at Facebook

Maaaring i-post ng webhook na product/created ng app sa Nuvemshop o Tiendanube ang bawat bagong product sa Instagram, TikTok at Facebook sa pamamagitan ng easyCoexistence: kukunin ng n8n o maikling script ang product, iko-convert ang pangunahing photo nito sa JPEG para sa Instagram, at ipapadala ang text, photo at link sa posts API ng easyCoexistence, na nagpa-publish sa pamamagitan ng opisyal na API ng bawat network, ngayon man o sa susunod. Nagpo-post ang Claude ng mga product kapag hiniling, gamit ang sariling connector ng Nuvemshop.

3 seconds

Gaano katagal hinihintay ng Nuvemshop ang sagot na 2XX sa isang webhook bago mag-retry, hanggang 16 na beses sa loob ng 48 oras.

store_id, event, id

Ang mga field na dala ng product webhook ng Nuvemshop, kasama ang timestamp at walang detalye ng product, kaya binabasa ang product gamit ang GET /products/{id}.

x-linkedstore-hmac-sha256

Ang header na may HMAC-SHA256 signature ng bawat webhook, na ginawa gamit ang client secret ng app at hindi ang access token ng store.

WebP

Ang format na maaaring ibigay ng Nuvemshop sa product images pagkatapos ng optimization, at walang API option para i-off ang conversion.

admin-mcp.nuvemshop.com.br

Ang address na ibinigay ng Sentro ng Tulong ng Nuvemshop para idagdag ang sarili nitong MCP connector sa Claude bilang custom connector.

1080 × 1920

Ang pinakamalaking image na tinatanggap ng TikTok photo post, o 1920 × 1080, bilang JPG o WebP na hanggang 20 MB.

Paano nagiging post ang bagong product ng Nuvemshop?

Sa pamamagitan ng app, webhook at isang request kada account. Ang mga webhook ng Nuvemshop ay pag-aari ng isang app, kaya gumawa ng isa na may read_products scope, i-install ito sa inyong store, at magrehistro ng webhook para sa product/created na tumuturo sa inyong n8n workflow o server. Ang notice ay naglalaman ng store ID, ang event, at ID ng product, nang walang detalye ng product, kaya binabasa ng workflow ang product gamit ang GET /products/{id}, sinisiguro na visible ito at may photo, at nagpapadala ng isang request kada account sa posts API ng easyCoexistence: isang photo post para sa Instagram at TikTok, at isang link post para sa Facebook. Ipina-publish ng easyCoexistence ang bawat isa sa pamamagitan ng opisyal na API ng network, kaagad o sa publish_at na itinakda ninyo.

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

Paano ninyo i-set up ang Nuvemshop app at ang webhook nito?

Isang beses lang, mula sa Partners Portal at isang terminal. Magrehistro bilang partner ng Nuvemshop o Tiendanube, gumawa ng app sa ilalim ng "Apps" na may read_products, na sakop din ang product images at variants, at i-install ito sa inyong store. Ang authorization code na ipinadala sa inyong redirect URL ay tumatagal ng 5 minuto at ipinapalit sa https://www.tiendanube.com/apps/authorize/token para sa access token at user_id, na ID ng store; mawawalan ng bisa ang token kapag nakakuha kayo ng bago para sa app at store na iyon, o kapag na-uninstall ang app. Pagkatapos, iparehistro ang webhook gamit ang POST /webhooks. Bawat request ay may Authorization: Bearer kasama ang token, at User-Agent na nagbabanggit ng inyong app at contact, o sasagot ang Nuvemshop ng 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" }'

Ano ang ginagawa ng n8n workflow sa bawat product?

Sumagot, mag-verify, magbasa, mag-convert at mag-post. Sumasagot agad sa loob ng 3 segundo ng Nuvemshop ang Webhook node na may Raw Body on at Respond na nakatakda sa Immediately. Ginagawang text ng Extract From File node ang body, kinakalkula ng Crypto node ang Hmac gamit ang SHA256 at HEX, na may susi ang client secret ng app, at pinapatuloy lang ng If node ang run kapag tugma ang resulta sa x-linkedstore-hmac-sha256 header.

Binabasa ng HTTP Request node ang GET /products/{{ $json.id }} gamit ang token ng store. Nagpapatuloy ang If node kapag ang visibility ay visible at hindi walang laman ang images, at inaalis ng Remove Duplicates node na nakatakda sa Remove Items Processed in Previous Executions ang product na na-post na, dahil maaaring magpadala ng parehong notice ang Nuvemshop nang dalawang beses. Para sa Instagram, dina-download ng HTTP Request node ang pangunahing image bilang file, nire-resize ito ng Edit Image node na may jpeg bilang Format, at ipinapadala ng HTTP Request node bilang n8n Binary File sa POST /api/v1/media, na nagbabalik ng media_id. Isang HTTP Request kada account ang tumatawag sa 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

Paano nagpo-post ng product ang script nang walang n8n?

Gamit ang maliit na web endpoint. Sinusuri ng Python sa ibaba ang signature laban sa raw body gamit ang client secret ng app, sumasagot agad ng 200, at ginagawa ang iba sa background: binabasa ang product, nilalaktawan ang hindi visible o walang photo, at kino-convert ang pangunahing photo gamit ang Pillow sa JPEG na hanggang 1080 pixels ang bawat gilid, na tinatanggap ng Instagram at TikTok. Ina-upload nito ang file sa POST /media, ipino-post sa Instagram at TikTok, at gumagawa ng link post sa Facebook. Bawat tawag ay may Idempotency-Key na gawa sa product at account, na kinikilala ng easyCoexistence, at isang listahan ng mga ID na na-post na ang pumipigil sa paulit-ulit na notice na mag-post muli.

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}"})

Paano nagpo-post ang Claude at ChatGPT ng product kapag hiniling?

Gamit ang sariling connector ng Nuvemshop, katabi ng connector ng easyCoexistence. Inilalarawan ng Sentro ng Tulong ng Nuvemshop ang AI connector na nakabatay sa MCP na gumagana sa Claude, sa ChatGPT sa pamamagitan ng connectors nito, at sa mga editor gaya ng Cursor; sa Claude, idinadagdag ito bilang custom connector sa https://admin-mcp.nuvemshop.com.br, at hinahanap ng read tools nito ang mga product, order at customer. Halimbawa, itanong ito: "I-post ang limang pinakabagong product namin sa TikTok simula bukas ng 10am oras sa São Paulo, isa kada oras, na may caption para sa bawat isa." Binabasa ng assistant ang mga product, sinusulat ang mga caption, at iniiskedyul ang bawat post gamit ang scheduled_at. Kumikilos ito kapag hiniling at hindi nagbabantay sa store sa pagitan ng mga chat, kaya ang mga product na idinagdag magdamag ay ipino-post sa pamamagitan ng webhook.

Ano ang tinatanggap ng bawat network sa product post?

Ang mga patakaran ng bawat network, kasama ang sariling tseke ng easyCoexistence, ay ipinatutupad kapag ipinadala o iniiskedyul ang post, kaya agad na tinatanggihan ang product na hindi maaaring lumabas:

  • Instagram: JPEG images lamang, kaya i-convert muna ang WebP o PNG na product photo; ang maraming photo ay bumubuo ng carousel. Walang link field ang post, kaya ilagay ang address ng product sa caption bilang text.
  • TikTok: photo posts na may 1 hanggang 35 JPG o WebP na image, bawat isa ay hanggang 1080 × 1920 o 1920 × 1080 pixels at 20 MB, isang 90-character na title, at 15 photo posts kada account kada araw.
  • Facebook: link post papunta sa canonical_url ng product, kasama ang preview na binubuo ng Facebook mula sa Open Graph tags ng pahina, o isang photo na may address sa text.
  • Media sa pamamagitan ng easyCoexistence: HTTPS link o media_id mula sa POST /media, na may image na hanggang 30 MB, at kinokopya kapag iniiskedyul ang post.
  • Caption: ang pangalan at description ng Nuvemshop ay mga object na naka-key sa wika, gaya ng pt o es, at HTML ang description, kaya pumili ng isang wika at tanggalin ang mga tag.

Paano ito i-set up

  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.

Mga karaniwang pagkakamali

  • Pagsagot sa Nuvemshop pagkatapos ma-post ang mga product. Naghihintay ito ng 2XX sa loob ng 3 segundo bago mag-retry, hanggang 16 na beses sa loob ng 48 oras, kaya sumagot muna at mag-post pagkatapos.
  • Pagpapadala sa Instagram ng product photo gaya ng ihahain ng Nuvemshop. Maaaring maghatid ang Nuvemshop ng WebP anuman ang dulo ng address, at JPEG lamang ang tinatanggap ng Instagram, kaya suriin ang Content-Type ng file at i-convert ito.
  • Pag-verify ng signature gamit ang access token ng store. Nagsa-sign ang Nuvemshop gamit ang client secret ng app, sa ibabaw ng raw body, kaya kalkulahin ang HMAC bago i-parse ang body.
  • Pag-post ng product sa sandaling malikha ito. Maaaring magsimula itong nakatago o walang photo, kaya suriin ang visibility at images, makinig din sa product/updated, at mag-post ng bawat product nang isang beses.
Ginagawa ito gamit ang EasyCoexistence

Binibigyan ng easyCoexistence ang inyong store, at ang mga AI agent na nagpapatakbo nito, ng abot sa mga customer sa Instagram, TikTok, Facebook at iba pang channel, bawat isa sa pamamagitan ng opisyal nitong API: isang posts API at media upload para sa n8n at inyong mga script, isang MCP connector para sa Claude at ChatGPT na katabi ng sariling connector ng Nuvemshop, at isang queue na nagpa-publish hanggang 90 araw nang maaga, habang may pagmo-monitor na 24/7 sa bawat koneksyon. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang mga koneksyon, na may free trial sa unang 3 araw.

Mga madalas itanong

Gumagana ba ito sa mga Tiendanube store?

Oo. Iisang API ang gamit ng Nuvemshop at Tiendanube: bawat address na tiendanube.com sa docs ay may magkaparehong katumbas sa nuvemshop.com.br, at sumasagot ang API sa api.tiendanube.com at api.nuvemshop.com.br.

Puwede bang i-post muli ang product kapag naka-sale na?

Oo. Makinig din sa product/updated at ikumpara ang promotional_price ng mga variant sa huling na-post; ang notice ay may ID ng product, hindi ang detalye nito, kaya basahin ang product sa bawat pagkakataon.

Ano ang ginagawa ng sariling Instagram at Facebook channel ng Nuvemshop?

Ikinokonekta nito ang catalog, Pixel at shop ng store sa Meta para sa pagbebenta sa Instagram at Facebook, gaya ng inilalarawan ng Sentro ng Tulong ng Nuvemshop, mula sa Canais de venda sa admin. Naglalathala ang daloy na ito ng feed post para sa bawat bagong product.

Magkano ang gastos sa easyCoexistence sa pag-post ng mga product ng Nuvemshop?

US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang mga koneksyon, pareho sa bawat network. Kasama ang posts API, media upload at MCP connector, at may free trial sa unang 3 araw.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong