MasukMulai uji coba gratis
easyCoexistence API resmi

Posting otomatis produk Nuvemshop dan Tiendanube baru ke Instagram, TikTok dan Facebook

Webhook product/created dari aplikasi Nuvemshop atau Tiendanube dapat memposting setiap produk baru ke Instagram, TikTok dan Facebook melalui easyCoexistence: n8n atau skrip singkat mengambil produk, mengubah foto utamanya menjadi JPEG untuk Instagram, lalu mengirim teks, foto dan tautan ke API posts easyCoexistence, yang menerbitkan lewat API resmi masing-masing jaringan, sekarang atau nanti. Claude memposting produk sesuai permintaan dengan konektor bawaan Nuvemshop.

3 seconds

Berapa lama Nuvemshop menunggu jawaban 2XX untuk webhook sebelum mencoba kembali, hingga 16 kali dalam 48 jam.

store_id, event, id

Kolom yang dibawa webhook produk Nuvemshop, dengan cap waktu dan tanpa detail produk, sehingga produk dibaca dengan GET /products/{id}.

x-linkedstore-hmac-sha256

Header yang berisi tanda tangan HMAC-SHA256 setiap webhook, dikunci dengan client secret aplikasi, bukan token akses toko.

WebP

Format yang mungkin digunakan Nuvemshop untuk gambar produk setelah optimasi, tanpa opsi API untuk mematikan konversi.

admin-mcp.nuvemshop.com.br

Alamat yang diberikan Pusat Bantuan Nuvemshop untuk menambahkan konektor MCP-nya sendiri ke Claude sebagai konektor kustom.

1080 × 1920

Gambar terbesar yang diterima postingan foto TikTok, yaitu 1920 × 1080, berupa JPG atau WebP hingga 20 MB.

Bagaimana produk Nuvemshop baru menjadi postingan?

Melalui aplikasi, webhook, dan satu panggilan per akun. Webhook Nuvemshop dimiliki oleh aplikasi, jadi buat satu dengan scope read_products, pasang di toko Anda, lalu daftarkan webhook untuk product/created yang mengarah ke alur kerja n8n atau server Anda. Pemberitahuan memuat ID toko, event, dan ID produk tanpa detail produk, sehingga alur kerja membaca produk dengan GET /products/{id}, memeriksa apakah produk terlihat dan memiliki foto, lalu mengirim satu permintaan per akun ke API posts easyCoexistence: postingan foto untuk Instagram dan TikTok, serta postingan tautan untuk Facebook. easyCoexistence menerbitkan setiap postingan melalui API resmi jaringan tersebut, segera atau pada publish_at yang Anda atur.

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 cara mengatur aplikasi Nuvemshop dan webhook-nya?

Cukup sekali, dari Portal Partner dan terminal. Daftar sebagai partner Nuvemshop atau Tiendanube, buat aplikasi di bagian Apps dengan read_products, yang juga mencakup gambar dan varian produk, lalu pasang di toko Anda. Kode otorisasi yang dikirim ke URL pengalihan Anda berlaku 5 menit dan ditukar di https://www.tiendanube.com/apps/authorize/token dengan token akses dan user_id, yaitu ID toko. Token tidak kedaluwarsa sampai Anda mendapatkan token baru untuk aplikasi dan toko tersebut, atau aplikasi dicopot. Lalu daftarkan webhook dengan POST /webhooks. Setiap permintaan membawa Authorization: Bearer dengan token, serta User-Agent yang menyebutkan nama aplikasi Anda dan sebuah kontak, 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 alur kerja n8n terhadap setiap produk?

Menjawab, memverifikasi, membaca, mengubah, lalu memposting. Node Webhook dengan Raw Body aktif dan Respond diatur ke Immediately menjawab dalam batas 3 detik Nuvemshop. Node Extract From File mengubah body menjadi teks, node Crypto menghitung Hmac-nya dengan SHA256 dan HEX menggunakan client secret aplikasi, dan node If hanya melanjutkan jika hasilnya sama dengan header x-linkedstore-hmac-sha256.

Node HTTP Request kemudian membaca GET /products/{{ $json.id }} dengan token toko. Node If melanjutkan saat visibility bernilai visible dan images tidak kosong. Node Remove Duplicates yang diatur ke Remove Items Processed in Previous Executions membuang produk yang sudah diposting, karena Nuvemshop bisa mengirim pemberitahuan yang sama dua kali. Untuk Instagram, node HTTP Request mengunduh gambar utama sebagai file, node Edit Image mengubahnya ukurannya dengan jpeg sebagai Format, lalu node HTTP Request mengirimkannya sebagai n8n Binary File ke POST /api/v1/media, yang mengembalikan media_id. Satu node HTTP Request per akun 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 memposting produk tanpa n8n?

Dengan endpoint web kecil. Python di bawah memeriksa tanda tangan terhadap raw body dengan client secret aplikasi, menjawab 200 segera, dan mengerjakan sisanya di latar belakang: ia membaca produk, melewati produk yang tidak terlihat atau tidak punya foto, dan mengubah foto utama dengan Pillow menjadi JPEG berukuran maksimal 1080 piksel per sisi, yang diterima Instagram dan TikTok. Ia mengunggah file itu ke POST /media, memposting ke Instagram dan TikTok, serta membuat postingan tautan di Facebook. Setiap panggilan membawa Idempotency-Key yang dibuat dari produk dan akun, yang dihormati easyCoexistence, dan daftar ID yang sudah diposting mencegah pemberitahuan berulang memposting 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 memposting produk sesuai permintaan?

Dengan konektor bawaan Nuvemshop yang berdampingan dengan konektor easyCoexistence. Pusat Bantuan Nuvemshop menjelaskan konektor AI berbasis MCP yang bekerja dengan Claude, dengan ChatGPT melalui fitur konektornya, dan dengan editor seperti Cursor. Di Claude, konektor ini ditambahkan sebagai konektor kustom di https://admin-mcp.nuvemshop.com.br, dan alat bacanya mencari produk, pesanan, dan pelanggan. Contohnya, ajukan: "Posting lima produk terbaru kami ke TikTok mulai besok pukul 10.00 waktu São Paulo, satu per jam, dengan keterangan untuk masing-masing." Asisten membaca produk, menulis keterangannya, dan menjadwalkan setiap postingan dengan scheduled_at. Ia bertindak saat diminta dan tidak memantau toko di antara percakapan, sehingga produk yang ditambahkan semalam keluar lewat webhook.

Apa yang diterima setiap jaringan dalam postingan produk?

Aturan setiap jaringan, ditambah pemeriksaan easyCoexistence sendiri, berlaku saat postingan dikirim atau dijadwalkan, sehingga produk yang tidak bisa tayang langsung ditolak:

  • Instagram: hanya gambar JPEG, jadi ubah dulu foto produk WebP atau PNG; beberapa foto membentuk karusel. Postingan tidak memiliki kolom tautan, sehingga alamat produk dimasukkan ke keterangan sebagai teks.
  • TikTok: postingan foto berisi 1 hingga 35 gambar JPG atau WebP, masing-masing hingga 1080 × 1920 atau 1920 × 1080 piksel dan 20 MB, judul 90 karakter, dan 15 postingan foto per akun per hari.
  • Facebook: postingan tautan ke canonical_url produk, dengan pratinjau yang dibuat Facebook dari tag Open Graph halaman, atau satu foto dengan alamat di teks.
  • Media melalui easyCoexistence: tautan HTTPS atau media_id dari POST /media, dengan gambar hingga 30 MB, disalin saat postingan dijadwalkan.
  • Keterangan: nama dan deskripsi Nuvemshop berupa objek yang dikunci per bahasa, seperti pt atau es, dan deskripsinya berupa HTML, jadi pilih satu bahasa dan hapus tag-nya.

Cara mengonfigurasi

  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.

Kesalahan umum

  • Menjawab Nuvemshop setelah postingan terkirim. Nuvemshop menunggu 3 detik untuk 2XX lalu mencoba kembali, hingga 16 kali dalam 48 jam, jadi jawab dulu, baru posting.
  • Mengirim foto produk ke Instagram sebagaimana disajikan Nuvemshop. Nuvemshop bisa mengirim WebP apa pun akhir alamatnya, sedangkan Instagram hanya menerbitkan JPEG, jadi periksa Content-Type file dan ubah formatnya.
  • Memverifikasi tanda tangan dengan token akses toko. Nuvemshop menandatangani dengan client secret aplikasi, atas raw body, jadi hitung HMAC sebelum body diurai.
  • Memposting produk begitu dibuat. Produk bisa mulai dalam keadaan tersembunyi atau tanpa foto, jadi periksa visibility dan images, dengarkan juga product/updated, dan posting setiap produk satu kali.
Melakukan ini dengan EasyCoexistence

easyCoexistence memberi toko Anda, serta agen AI yang menjalankannya, jangkauan ke pelanggan di Instagram, TikTok, Facebook, dan saluran lainnya, masing-masing lewat API resminya: API posts dan unggahan media untuk n8n dan skrip Anda, satu konektor MCP untuk Claude dan ChatGPT di samping milik Nuvemshop, serta antrean yang menerbitkan hingga 90 hari ke depan, dengan setiap koneksi dipantau 24/7. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah ini bekerja dengan toko Tiendanube?

Ya. Nuvemshop dan Tiendanube berbagi satu API: setiap alamat tiendanube.com dalam dokumentasi memiliki padanan identik di nuvemshop.com.br, dan API menjawab di api.tiendanube.com maupun api.nuvemshop.com.br.

Bisakah memposting ulang produk saat masuk promosi?

Bisa. Dengarkan juga product/updated dan bandingkan promotional_price varian dengan yang terakhir Anda posting. Pemberitahuan membawa ID produk, bukan detailnya, jadi baca produk setiap kali.

Apa yang dilakukan saluran Instagram dan Facebook milik Nuvemshop?

Ia menghubungkan katalog, Pixel, dan toko ke Meta untuk berjualan di Instagram dan Facebook, sebagaimana dijelaskan Pusat Bantuan Nuvemshop, dari Canais de venda di admin. Alur ini menerbitkan postingan feed untuk setiap produk baru.

Berapa biaya easyCoexistence untuk memposting produk Nuvemshop?

US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, sama di setiap jaringan. API posts, unggahan media, dan konektor MCP sudah termasuk, dengan 3 hari pertama gratis.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada