Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Siarkan produk Nuvemshop dan Tiendanube yang baharu ke Instagram, TikTok dan Facebook secara automatik

Webhook product/created bagi aplikasi Nuvemshop atau Tiendanube boleh menyiarkan setiap produk baharu ke Instagram, TikTok dan Facebook melalui easyCoexistence. n8n atau skrip pendek mengambil produk, menukar foto utama kepada JPEG untuk Instagram, dan menghantar teks, foto serta pautan ke API siaran easyCoexistence. Platform itu menerbitkannya melalui API rasmi setiap rangkaian, sama ada serta-merta atau kemudian. Claude menyiarkan produk atas permintaan dengan penyambung Nuvemshop sendiri.

3 seconds

Tempoh Nuvemshop menunggu respons 2XX bagi webhook sebelum mencuba semula, sehingga 16 cubaan dalam tempoh 48 jam.

store_id, event, id

Medan yang dibawa oleh webhook produk Nuvemshop, dengan cap masa dan tanpa butiran produk, supaya produk dibaca melalui GET /products/{id}.

x-linkedstore-hmac-sha256

Pengepala yang memuatkan tandatangan HMAC-SHA256 setiap webhook, dikunci dengan rahsia klien aplikasi, bukan token akses kedai.

WebP

Format yang mungkin digunakan Nuvemshop untuk imej produk selepas pengoptimuman, tanpa pilihan API untuk mematikan penukaran.

admin-mcp.nuvemshop.com.br

Alamat yang diberikan Pusat Bantuan Nuvemshop untuk menambah penyambung MCP sendiri ke Claude sebagai penyambung tersuai.

1080 × 1920

Imej terbesar yang boleh diterima oleh siaran foto TikTok, atau 1920 × 1080, dalam format JPG atau WebP sehingga 20 MB.

Bagaimana produk Nuvemshop baharu menjadi siaran?

Melalui satu aplikasi, satu webhook dan satu panggilan bagi setiap akaun. Webhook Nuvemshop dimiliki oleh aplikasi, jadi cipta satu dengan skop read_products, pasangkannya dalam kedai anda dan daftarkan webhook untuk product/created yang menuju ke aliran kerja n8n atau pelayan anda. Notis itu memuatkan ID kedai, peristiwa dan ID produk, tanpa butiran produk, jadi aliran kerja membaca produk dengan GET /products/{id}, menyemak bahawa ia kelihatan dan mempunyai foto, dan menghantar satu permintaan bagi setiap akaun ke API siaran easyCoexistence: siaran foto untuk Instagram dan TikTok, siaran pautan untuk Facebook. easyCoexistence menerbitkan setiap siaran melalui API rasmi rangkaian itu, sama ada serta-merta atau pada publish_at yang anda tetapkan.

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

Bagaimana anda menyediakan aplikasi dan webhook Nuvemshop?

Sekali sahaja, daripada Partners Portal dan terminal. Daftar sebagai rakan kongsi Nuvemshop atau Tiendanube, cipta aplikasi di bawah Apps dengan read_products, yang juga meliputi imej dan varian produk, dan pasangkannya dalam kedai anda. Kod kebenaran yang dihantar ke URL ubah hala anda sah selama 5 minit dan ditukar di https://www.tiendanube.com/apps/authorize/token kepada token akses dan user_id, iaitu ID kedai; token itu tidak tamat tempoh sehingga anda mendapat yang baharu bagi aplikasi dan kedai tersebut atau aplikasi dinyahpasang. Kemudian daftarkan webhook dengan POST /webhooks. Setiap permintaan membawa Authorization: Bearer dengan token dan User-Agent yang menamakan aplikasi anda serta satu kenalan, atau Nuvemshop menjawab 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" }'

Apa yang dilakukan aliran kerja n8n terhadap setiap produk?

Jawab, sahkan, baca, tukar dan siarkan. Nod Webhook dengan Raw Body dihidupkan dan Respond ditetapkan kepada Immediately menjawab dalam tempoh 3 saat Nuvemshop. Nod Extract From File menukar badan kepada teks, nod Crypto mengira Hmac dengan SHA256 dan HEX, dikunci dengan rahsia klien aplikasi, dan nod If membenarkan larian diteruskan hanya apabila hasilnya sama dengan pengepala x-linkedstore-hmac-sha256.

Nod HTTP Request kemudian membaca GET /products/{{ $json.id }} dengan token kedai. Nod If diteruskan apabila visibility ialah visible dan images tidak kosong, dan nod Remove Duplicates yang ditetapkan kepada Remove Items Processed in Previous Executions membuang produk yang telah disiarkan, kerana Nuvemshop boleh menghantar notis yang sama dua kali. Untuk Instagram, nod HTTP Request memuat turun imej utama sebagai fail, nod Edit Image mengubah saiznya dengan jpeg sebagai Format, dan nod HTTP Request menghantarnya sebagai n8n Binary File ke POST /api/v1/media, yang mengembalikan media_id. Satu nod HTTP Request bagi setiap akaun kemudian memanggil 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

Bagaimana skrip menyiarkan produk tanpa n8n?

Dengan endpoint web yang kecil. Skrip Python di bawah menyemak tandatangan terhadap badan mentah dengan rahsia klien aplikasi, menjawab 200 serta-merta dan melakukan selebihnya di latar belakang: ia membaca produk, melangkau produk yang tidak kelihatan atau tiada foto, dan menukar foto utama dengan Pillow kepada JPEG dengan setiap sisi tidak melebihi 1080 piksel, format yang diterima oleh Instagram dan TikTok. Ia memuat naik fail itu ke POST /media, menyiarkannya ke Instagram dan TikTok, dan membuat siaran pautan di Facebook. Setiap panggilan membawa Idempotency-Key yang dijana daripada produk dan akaun, yang dihormati oleh easyCoexistence, dan satu set ID yang telah disiarkan menghalang notis berulang daripada menyiarkan dua kali.

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

Bagaimana Claude dan ChatGPT menyiarkan produk atas permintaan?

Dengan penyambung Nuvemshop sendiri di samping easyCoexistence. Pusat Bantuan Nuvemshop menerangkan penyambung AI yang dibina atas MCP dan berfungsi dengan Claude, dengan ChatGPT melalui penyambungnya dan dengan editor seperti Cursor; dalam Claude ia ditambah sebagai penyambung tersuai di https://admin-mcp.nuvemshop.com.br, dan alat bacaannya mencari produk, pesanan dan pelanggan. Contohnya, tanya: "Siarkan lima produk terbaharu kami ke TikTok bermula esok pukul 10 pagi waktu São Paulo, satu sejam sekali, dengan kapsyen untuk setiap satu." Pembantu itu membaca produk, menulis kapsyen dan menjadualkan setiap siaran dengan scheduled_at. Ia bertindak apabila diminta dan tidak memerhati kedai antara sembang, jadi produk yang ditambah semalaman keluar melalui webhook.

Apa yang diterima setiap rangkaian dalam siaran produk?

Peraturan setiap rangkaian, dengan semakan easyCoexistence di atasnya, dikenakan apabila siaran dihantar atau dijadualkan, jadi produk yang tidak boleh keluar ditolak serta-merta:

  • Instagram: imej JPEG sahaja, jadi tukar foto produk WebP atau PNG dahulu; beberapa foto menjadi karusel. Siaran tidak mempunyai medan pautan, jadi alamat produk dimasukkan dalam kapsyen sebagai teks.
  • TikTok: siaran foto 1 hingga 35 imej JPG atau WebP, setiap satu sehingga 1080 × 1920 atau 1920 × 1080 piksel dan 20 MB, tajuk 90 aksara, dan 15 siaran foto bagi setiap akaun sehari.
  • Facebook: siaran pautan ke canonical_url produk, dengan pratonton yang dibina Facebook daripada tag Open Graph halaman, atau satu foto dengan alamat dalam teks.
  • Media melalui easyCoexistence: pautan HTTPS atau media_id daripada POST /media, dengan imej sehingga 30 MB, disalin apabila siaran dijadualkan.
  • Kapsyen: nama dan perihalan Nuvemshop ialah objek yang dikunci mengikut bahasa, seperti pt atau es, dan perihalan ialah HTML, jadi pilih satu bahasa dan buang tag.

Cara menetapkannya

  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.

Kesilapan biasa

  • Menjawab Nuvemshop selepas siaran dihantar. Nuvemshop menunggu 3 saat untuk respons 2XX dan kemudian mencuba semula, sehingga 16 kali dalam tempoh 48 jam, jadi jawab dahulu dan siarkan kemudian.
  • Menghantar foto produk kepada Instagram seperti yang disajikan Nuvemshop. Nuvemshop mungkin menghantar WebP tanpa mengira sambungan alamat, dan Instagram hanya menerbitkan JPEG, jadi semak Content-Type fail dan tukarkannya.
  • Mengesahkan tandatangan dengan token akses kedai. Nuvemshop menandatangani dengan rahsia klien aplikasi, ke atas badan mentah, jadi kira HMAC sebelum badan dihuraikan.
  • Menyiarkan produk sebaik sahaja dicipta. Ia mungkin bermula dalam keadaan tersembunyi atau tanpa foto, jadi semak visibility dan images, dengarkan juga product/updated, dan siarkan setiap produk sekali sahaja.
Menggunakan EasyCoexistence untuk ini

easyCoexistence memberikan kedai anda, dan ejen AI yang mengendalikannya, capaian kepada pelanggan di Instagram, TikTok, Facebook dan lebih banyak saluran, setiap satu melalui API rasminya: API siaran dan muat naik media untuk n8n dan skrip anda, satu penyambung MCP untuk Claude dan ChatGPT di samping penyambung Nuvemshop sendiri, dan barisan yang menerbitkan sehingga 90 hari lebih awal, dengan setiap sambungan dipantau 24/7. Daripada US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari percubaan percuma.

Soalan lazim

Adakah ia berfungsi dengan kedai Tiendanube?

Ya. Nuvemshop dan Tiendanube berkongsi satu API: setiap alamat tiendanube.com dalam dokumen mempunyai alamat yang sama pada nuvemshop.com.br, dan API menjawab pada kedua-dua api.tiendanube.com dan api.nuvemshop.com.br.

Bolehkah ia menyiarkan semula produk apabila ia mempunyai harga promosi?

Ya. Dengarkan product/updated juga dan bandingkan promotional_price varian dengan harga yang terakhir anda siarkan; notis membawa ID produk, bukan butirannya, jadi baca produk setiap kali.

Apa yang dilakukan saluran Instagram dan Facebook sendiri Nuvemshop?

Ia menyambungkan katalog, Pixel dan kedai kepada Meta untuk menjual di Instagram dan Facebook, seperti yang diterangkan Pusat Bantuan Nuvemshop, daripada Canais de venda dalam pentadbir. Aliran ini menyiarkan siaran suapan untuk setiap produk baharu.

Berapakah kos easyCoexistence untuk menyiarkan produk Nuvemshop?

Daripada US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, sama bagi setiap rangkaian. API siaran, muat naik media dan penyambung MCP disertakan, dengan 3 hari percubaan percuma pertama.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada