Chapisha bidhaa mpya za Nuvemshop na Tiendanube kwenye Instagram, TikTok na Facebook kiotomatiki
webhook ya product/created ya programu ya Nuvemshop au Tiendanube inaweza kuchapisha kila bidhaa mpya kwenye Instagram, TikTok na Facebook kupitia easyCoexistence: n8n au hati fupi huchukua bidhaa, hubadilisha picha yake kuu kuwa JPEG kwa Instagram, kisha hutuma maandishi, picha na kiungo kwenye posts API ya easyCoexistence, ambayo huchapisha kupitia API rasmi ya kila mtandao, sasa au baadaye. Claude huchapisha bidhaa kwa ombi kwa kutumia kiunganishi cha Nuvemshop chenyewe.
Muda ambao Nuvemshop husubiri jibu la 2XX kwa webhook kabla ya kujaribu tena, hadi majaribio 16 ndani ya saa 48.
Sehemu ambazo webhook ya bidhaa ya Nuvemshop hubeba, pamoja na muda wa tukio na bila maelezo ya bidhaa, kwa hiyo bidhaa husomwa kwa GET /products/{id}.
Kichwa kinachobeba sahihi ya HMAC-SHA256 ya kila webhook, kinachofungwa kwa client secret ya programu, si access token ya duka.
Umbizo ambalo Nuvemshop inaweza kutoa picha za bidhaa baada ya uboreshaji, bila chaguo la API la kuzima ubadilishaji.
Anwani ambayo Kituo cha Msaada cha Nuvemshop kinatoa kwa kuongeza MCP connector yake kwa Claude kama custom connector.
Picha kubwa zaidi ambayo chapisho la picha la TikTok hukubali ni 1920 × 1080, kama JPG au WebP za hadi MB 20.
Bidhaa mpya ya Nuvemshop inakuwa chapisho vipi?
Kupitia programu, webhook na wito mmoja kwa kila akaunti. Webhook za Nuvemshop ni za programu, kwa hiyo tengeneza programu moja yenye ruhusa ya read_products, isakinishe kwenye duka lako, kisha usajili webhook ya product/created inayoelekeza kwenye workflow yako ya n8n au seva. Arifa ina ID ya duka, tukio na ID ya bidhaa, bila maelezo ya bidhaa, kwa hiyo workflow husoma bidhaa kwa GET /products/{id}, hukagua kwamba inaonekana na ina picha, kisha hutuma ombi moja kwa kila akaunti kwenye posts API ya easyCoexistence: chapisho la picha kwa Instagram na TikTok, na chapisho la kiungo kwa Facebook. easyCoexistence huchapisha kila moja kupitia API rasmi ya mtandao, mara moja au kwenye publish_at uliyoweka.
Unasanidi vipi programu ya Nuvemshop na webhook yake?
Mara moja tu, kutoka Partners Portal na terminal. Jisajili kama mshirika wa Nuvemshop au Tiendanube, tengeneza programu chini ya Apps yenye read_products, ambayo pia inahusu picha za bidhaa na variants, kisha uisakinishe kwenye duka lako. Msimbo wa idhini unaotumwa kwenye redirect URL yako unadumu dakika 5 na hubadilishwa kwenye https://www.tiendanube.com/apps/authorize/token kuwa access token na user_id, yaani ID ya duka. Token haiishi muda hadi upate mpya kwa programu na duka hilo, au programu iondolewe. Kisha sajili webhook kwa POST /webhooks. Kila ombi hubeba Authorization: Bearer yenye token na User-Agent inayotaja programu yako na mawasiliano, la sivyo Nuvemshop hujibu 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" }'Workflow ya n8n hufanya nini na kila bidhaa?
Hujibu, hukagua, husoma, hubadilisha na kuchapisha. Node ya Webhook yenye Raw Body imewashwa na Respond imewekwa Immediately hujibu ndani ya sekunde 3 ambazo Nuvemshop inatoa. Node ya Extract From File hubadilisha body kuwa maandishi, node ya Crypto huhesabu Hmac kwa SHA256 na HEX, ikifungwa na client secret ya programu, na node ya If huruhusu run iendelee pale tu matokeo yanapolingana na kichwa cha x-linkedstore-hmac-sha256.
Node ya HTTP Request kisha husoma GET /products/{{ $json.id }} kwa token ya duka. Node ya If huendelea pale visibility ni visible na images si tupu, na node ya Remove Duplicates iliyowekwa Remove Items Processed in Previous Executions huondoa bidhaa ambayo tayari imechapishwa, kwa kuwa Nuvemshop inaweza kutuma arifa hiyo hiyo mara mbili. Kwa Instagram, node ya HTTP Request hupakua picha kuu kama faili, node ya Edit Image hubadilisha ukubwa wake ikiwa na jpeg kama Format, kisha node ya HTTP Request huituma kama n8n Binary File kwa POST /api/v1/media, ambayo hurudisha media_id. Node moja ya HTTP Request kwa kila akaunti kisha huita POST /api/v1/channels/<account_id>/posts.
Skripti hupachika bidhaa vipi bila n8n?
Kwa endpoint ndogo ya wavuti. Python hapa chini hukagua sahihi dhidi ya raw body kwa kutumia client secret ya programu, hujibu 200 mara moja na kufanya kazi nyingine chinichini: husoma bidhaa, huruka ile isiyoonekana au isiyo na picha, na hubadilisha picha kuu kuwa JPEG ya upeo wa pikseli 1080 kila upande, ambayo Instagram na TikTok zote hukubali, kwa kutumia Pillow. Inapakia faili hiyo kwa POST /media, huichapisha kwenye Instagram na TikTok, na kufanya chapisho la kiungo kwenye Facebook. Kila wito hubeba Idempotency-Key iliyoundwa kutoka bidhaa na akaunti, ambayo easyCoexistence huiheshimu, na orodha ya ID zilizochapishwa huzuia arifa inayorudiwa kuchapisha mara mbili.
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 na ChatGPT huchapisha bidhaa kwa ombi vipi?
Kwa kutumia kiunganishi cha Nuvemshop chenyewe, kando ya cha easyCoexistence. Kituo cha Msaada cha Nuvemshop kinaeleza AI connector iliyojengwa kwa MCP inayofanya kazi na Claude, na ChatGPT kupitia connectors zake, pamoja na wahariri kama Cursor. Kwenye Claude huongezwa kama custom connector kwa https://admin-mcp.nuvemshop.com.br, na zana zake za kusoma hutafuta bidhaa, oda na wateja. Kwa mfano, uliza: "Chapisha bidhaa zetu tano za hivi karibuni kwenye TikTok kuanzia kesho saa 10:00 asubuhi, saa za São Paulo, moja kila saa, zikiwa na maelezo kwa kila moja." Msaidizi husoma bidhaa, huandika maelezo na kupanga kila chapisho kwa scheduled_at. Hufanya kazi kwa ombi tu na haiangalii duka kati ya mazungumzo, kwa hiyo bidhaa zilizoongezwa usiku kucha hutoka kupitia webhook.
Kila mtandao hukubali nini kwenye chapisho la bidhaa?
Sheria za kila mtandao, pamoja na ukaguzi wa easyCoexistence wenyewe, hutumika chapisho linapotumwa au kupangwa, kwa hiyo bidhaa isiyoweza kutoka hukataliwa mara moja:
- Instagram: picha za JPEG pekee, kwa hiyo badilisha kwanza picha ya bidhaa ya WebP au PNG; picha kadhaa huunda carousel. Chapisho halina uga wa kiungo, kwa hiyo anwani ya bidhaa huwekwa kwenye maelezo kama maandishi.
- TikTok: machapisho ya picha 1 hadi 35 za JPG au WebP, kila moja hadi 1080 × 1920 au 1920 × 1080 pikseli na MB 20, kichwa cha herufi 90, na machapisho 15 ya picha kwa akaunti kwa siku.
- Facebook: chapisho la kiungo kwenye
canonical_urlya bidhaa, pamoja na onyesho ambalo Facebook hujenga kutoka tagi za Open Graph za ukurasa, au picha moja yenye anwani kwenye maandishi. - Vyombo vya habari kupitia easyCoexistence: kiungo cha HTTPS au
media_idkutoka POST /media, na picha hadi MB 30, zinazonakiliwa wakati chapisho linapopangwa. - Maelezo: jina na maelezo ya Nuvemshop ni vitu vilivyopangwa kwa lugha, kama pt au es, na maelezo ni HTML, kwa hiyo chagua lugha moja na ondoa tagi.
Jinsi ya kuisanidi
- 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.
Makosa ya kawaida
- Kujibu Nuvemshop baada ya machapisho kutoka. Inasubiri 2XX ndani ya sekunde 3 kisha hujaribu tena, hadi mara 16 ndani ya saa 48, kwa hiyo jibu kwanza na uchapishe baadaye.
- Kutuma picha ya bidhaa kwa Instagram jinsi Nuvemshop inavyoitoa. Nuvemshop inaweza kutoa WebP bila kujali anwani inaishia vipi, na Instagram huchapisha JPEG pekee, kwa hiyo angalia Content-Type ya faili na uibadilishe.
- Kuthibitisha sahihi kwa access token ya duka. Nuvemshop husaini kwa client secret ya programu, juu ya raw body, kwa hiyo hesabu HMAC kabla body haijachambuliwa.
- Kuchapisha bidhaa mara tu inapoundwa. Inaweza kuanza ikiwa imefichwa au bila picha, kwa hiyo angalia visibility na images, sikiliza product/updated pia, na chapishe kila bidhaa mara moja tu.
easyCoexistence humpa duka lako, na mawakala wa AI wanaouendesha, ufikiaji wa wateja kwenye Instagram, TikTok, Facebook na chaneli nyingine zaidi, kila moja kupitia API yake rasmi: posts API na upakiaji wa media kwa n8n na skripti zako, kiunganishi kimoja cha MCP kwa Claude na ChatGPT kando ya cha Nuvemshop, na foleni inayochapisha hadi siku 90 mbele, huku kila muunganisho ukifuatiliwa saa 24. US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kadri unavyoongeza muunganisho, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, inafanya kazi na maduka ya Tiendanube?
Ndiyo. Nuvemshop na Tiendanube hushiriki API moja: kila anwani ya tiendanube.com kwenye nyaraka ina inayolingana kwenye nuvemshop.com.br, na API hujibu kwenye api.tiendanube.com na api.nuvemshop.com.br.
Je, inaweza kuchapisha bidhaa tena inapowekwa kwenye punguzo?
Ndiyo. Sikiliza product/updated pia na linganisha promotional_price ya variants na ile uliyochapisha mwisho. Arifa hubeba ID ya bidhaa, si maelezo yake, kwa hiyo soma bidhaa kila mara.
Kituo cha Instagram na Facebook cha Nuvemshop hufanya nini?
Huunganisha katalogi, Pixel na duka lako kwa Meta ili kuuza kwenye Instagram na Facebook, kama Kituo cha Msaada cha Nuvemshop kinavyoeleza, kutoka Canais de venda kwenye admin. Mtiririko huu huchapisha chapisho la feed kwa kila bidhaa mpya.
easyCoexistence inagharimu kiasi gani kuchapisha bidhaa za Nuvemshop?
US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kadri unavyoongeza muunganisho, sawa kwenye kila mtandao. posts API, upakiaji wa media na kiunganishi cha MCP vimejumuishwa, na siku 3 za kwanza ni bila malipo.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye