Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Nuvemshop ve Tiendanube'daki yeni ürünleri otomatik olarak Instagram, TikTok ve Facebook'ta paylaşın

Bir Nuvemshop veya Tiendanube uygulamasının product/created webhook'u, her yeni ürünü easyCoexistence üzerinden Instagram, TikTok ve Facebook'ta paylaşabilir: n8n veya kısa bir betik ürünü çeker, ana fotoğrafını Instagram için JPEG'e dönüştürür ve metni, fotoğrafı ve bağlantıyı easyCoexistence'ın posts API'sine gönderir; bu API her ağın resmi API'si üzerinden hemen ya da daha sonra yayımlar. Claude, Nuvemshop'un kendi MCP konektörü ile istek üzerine ürün paylaşır.

3 seconds

Nuvemshop bir webhook için 2XX yanıtını ne kadar süre bekler ve 48 saat içinde en fazla 16 kez yeniden dener.

store_id, event, id

Nuvemshop ürün webhook'unun taşıdığı alanlar; zaman damgası içerir, ürün ayrıntısı içermez, bu yüzden ürün GET /products/{id} ile okunur.

x-linkedstore-hmac-sha256

Her webhook'un HMAC-SHA256 imzasını taşıyan başlık; anahtar mağazanın erişim token'ı değil, uygulamanın client secret'ıdır.

WebP

Nuvemshop'un optimizasyondan sonra ürün görsellerini sunabileceği biçim; dönüşümü kapatmak için bir API seçeneği yoktur.

admin-mcp.nuvemshop.com.br

Nuvemshop Yardım Merkezi'nin, kendi MCP konektörünü Claude'a özel konektör olarak eklemek için verdiği adres.

1080 × 1920

Bir TikTok fotoğraf paylaşımının kabul ettiği en büyük görsel 1920 × 1080'dir; JPG veya WebP, en fazla 20 MB.

Yeni bir Nuvemshop ürünü nasıl paylaşıma dönüşür?

Bir uygulama, bir webhook ve hesap başına tek bir çağrıyla. Nuvemshop'un webhook'ları bir uygulamaya aittir; bu yüzden read_products kapsamıyla bir uygulama oluşturun, mağazanıza kurun ve product/created için n8n iş akışınıza ya da sunucunuza işaret eden bir webhook kaydedin. Bildirim mağaza kimliğini, olayı ve ürünün ID'sini içerir, ürün ayrıntısı içermez; bu yüzden iş akışı ürünü GET /products/{id} ile okur, görünür olduğunu ve bir fotoğrafı olduğunu kontrol eder ve hesap başına bir istek gönderir: Instagram ve TikTok için fotoğraf paylaşımı, Facebook için bağlantı paylaşımı. easyCoexistence her birini ağın resmi API'si üzerinden, hemen ya da belirlediğiniz publish_at zamanında yayımlar.

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 uygulamasını ve webhook'unu nasıl kurarsınız?

Bir kez, Partners Portal'dan ve bir terminalden. Nuvemshop ya da Tiendanube partneri olarak kaydolun, Apps altında read_products ile bir uygulama oluşturun (bu, ürün görsellerini ve varyantları da kapsar) ve mağazanıza kurun. Yönlendirme URL'nize gönderilen yetkilendirme kodu 5 dakika geçerlidir ve https://www.tiendanube.com/apps/authorize/token adresinde, bir erişim token'ı ve mağazanın kimliği olan user_id ile değiştirilir; token, o uygulama ve mağaza için yenisi alınana ya da uygulama kaldırılana kadar sona ermez. Ardından webhook'u POST /webhooks ile kaydedin. Her istek token'ı taşıyan Authorization: Bearer başlığını ve uygulamanızı ile bir iletişim bilgisini adlandıran bir User-Agent başlığını içermelidir; aksi halde Nuvemshop 400 yanıtı verir.

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 iş akışı her ürünle ne yapar?

Yanıtlar, doğrular, okur, dönüştürür ve paylaşır. Raw Body açık ve Respond ayarı Immediately olan bir Webhook düğümü, Nuvemshop'un 3 saniyelik süresi içinde yanıt verir. Bir Extract From File düğümü gövdeyi metne çevirir, bir Crypto düğümü SHA256 ve HEX ile Hmac hesaplar (anahtar olarak uygulamanın client secret'ı kullanılır) ve bir If düğümü, sonuç x-linkedstore-hmac-sha256 başlığına eşitse akışın devam etmesine izin verir.

Bir HTTP Request düğümü ardından mağazanın token'ı ile GET /products/{{ $json.id }} isteğini okur. visibility değeri visible ve images boş değilse devam eden bir If düğümü ve Remove Items Processed in Previous Executions olarak ayarlanmış bir Remove Duplicates düğümü, Nuvemshop aynı bildirimi iki kez gönderebileceği için önceden paylaşılmış bir ürünü eler. Instagram için bir HTTP Request düğümü ana görseli dosya olarak indirir, bir Edit Image düğümü Format olarak jpeg seçerek yeniden boyutlandırır ve bir HTTP Request düğümü onu n8n Binary File olarak POST /api/v1/media adresine gönderir; bu da bir media_id döndürür. Hesap başına bir HTTP Request, POST /api/v1/channels/<account_id>/posts çağırır.

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

Bir betik, n8n olmadan ürünleri nasıl paylaşır?

Küçük bir web uç noktasıyla. Aşağıdaki Python, imzayı ham gövdeye karşı uygulamanın client secret'ı ile denetler, hemen 200 yanıtı verir ve işi arka planda yapar: ürünü okur, görünür olmayan ya da fotoğrafı olmayan birini atlar ve ana fotoğrafı Pillow ile bir kenarı en fazla 1080 piksel olan JPEG'e dönüştürür; bu, Instagram ve TikTok'un ikisinin de kabul ettiği bir boyuttur. Bu dosyayı POST /media adresine yükler, Instagram ve TikTok'a paylaşır ve Facebook'ta bir bağlantı paylaşımı yapar. Her çağrı, ürün ve hesaptan oluşturulan bir Idempotency-Key taşır; easyCoexistence bunu dikkate alır ve paylaşılmış ID'lerden oluşan bir küme, tekrarlanan bildirimin iki kez paylaşılmasını önler.

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 ve ChatGPT, istek üzerine ürünleri nasıl paylaşır?

Nuvemshop'un kendi konektörü ile, easyCoexistence'ın konektörünün yanında. Nuvemshop Yardım Merkezi, MCP üzerine kurulu bir AI konektörü tarif eder; bu, Claude ile çalışır, ChatGPT'de connectors aracılığıyla ve Cursor gibi editörlerle de. Claude'da özel konektör olarak https://admin-mcp.nuvemshop.com.br adresinden eklenir ve okuma araçları ürünleri, siparişleri ve müşterileri arar. Örneğin şunu isteyin: "En yeni beş ürünümüzü yarından itibaren São Paulo saatiyle sabah 10'dan başlayarak saatte bir TikTok'ta paylaşın, her biri için bir açıklama ekleyin." Asistan ürünleri okur, açıklamaları yazar ve her paylaşımı scheduled_at ile planlar. İstendiğinde çalışır, sohbetler arasında mağazayı izlemez; bu yüzden gece eklenen ürünler webhook üzerinden gider.

Her ağ bir ürün paylaşımında neyi kabul eder?

Her ağın kuralları, easyCoexistence'ın kendi kontrolleriyle birlikte, paylaşım gönderildiğinde ya da planlandığında uygulanır; bu nedenle gönderilemeyecek bir ürün hemen reddedilir:

  • Instagram: yalnızca JPEG görseller; bu yüzden önce bir WebP ya da PNG ürün fotoğrafını dönüştürün. Birden çok fotoğraf bir carousel oluşturur. Bir paylaşımın bağlantı alanı yoktur, bu yüzden ürünün adresi açıklamaya metin olarak yazılır.
  • TikTok: 1 ila 35 JPG ya da WebP görselden oluşan fotoğraf paylaşımları; her biri en fazla 1080 × 1920 ya da 1920 × 1080 piksel ve 20 MB, 90 karakterlik bir başlık ve hesap başına günde 15 fotoğraf paylaşımı.
  • Facebook: ürünün canonical_url adresine bir bağlantı paylaşımı; önizleme, Facebook'un sayfanın Open Graph etiketlerinden oluşturduğu önizlemedir, ya da metinde adresin yer aldığı tek bir fotoğraf.
  • easyCoexistence üzerinden medya: en fazla 30 MB görselli bir HTTPS bağlantısı ya da POST /media çağrısından gelen bir media_id; paylaşım planlandığında kopyalanır.
  • Açıklamalar: Nuvemshop'un name ve description alanları pt ya da es gibi dil anahtarlarına sahip nesnelerdir; description HTML'dir, bu yüzden bir dil seçin ve etiketleri ayıklayın.

Nasıl kurulur

  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.

Yaygın hatalar

  • Ürünleri Nuvemshop'a yanıt vermeden önce paylaşmak. Nuvemshop 2XX için 3 saniye bekler, sonra 48 saat içinde 16 kez yeniden dener. Bu yüzden önce yanıt verin, sonra paylaşın.
  • Instagram'a ürün fotoğrafını Nuvemshop'un sunduğu biçimde göndermek. Nuvemshop, adres neyle biterse bitsin WebP sunabilir; Instagram yalnızca JPEG yayımlar, bu yüzden dosyanın Content-Type değerini kontrol edin ve dönüştürün.
  • Token ile imza doğrulamak. Nuvemshop, ham gövde üzerinden uygulamanın client secret'ı ile imzalar; bu yüzden gövde ayrıştırılmadan önce HMAC'ı hesaplayın.
  • Ürün oluşturulur oluşturulmaz paylaşmak. Ürün gizli ya da fotoğrafsız başlayabilir; bu yüzden görünürlüğü ve görselleri kontrol edin, product/updated olayını da dinleyin ve her ürünü bir kez paylaşın.
Bunu EasyCoexistence'la yapmak

easyCoexistence, mağazanıza ve onu yöneten AI ajanlarına, Instagram, TikTok, Facebook ve daha fazla kanalda müşterilere ulaşma imkânı verir; her biri resmi API'si üzerinden: n8n ve betikleriniz için bir posts API ve medya yükleme, Claude ve ChatGPT için Nuvemshop'un kendi konektörünün yanında tek bir MCP konektörü ve 90 güne kadar önceden yayımlayan bir kuyruk. Her bağlantı 7/24 izlenir. Bağlantı başına aylık US$ 9 ile US$ 0,75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Tiendanube mağazalarıyla çalışır mı?

Evet. Nuvemshop ve Tiendanube tek bir API'yi paylaşır: dokümandaki her tiendanube.com adresinin nuvemshop.com.br üzerinde birebir karşılığı vardır ve API hem api.tiendanube.com hem de api.nuvemshop.com.br üzerinden yanıt verir.

Ürün indirime girdiğinde tekrar paylaşılabilir mi?

Evet. Ayrıca product/updated olayını dinleyin ve varyantların promotional_price değerini son paylaştığınız fiyatla karşılaştırın; bildirim ürünün ayrıntılarını değil ID'sini taşır, bu yüzden her seferinde ürünü okuyun.

Nuvemshop'un kendi Instagram ve Facebook kanalı ne yapar?

Mağazanın kataloğunu, Pixel'ini ve mağazasını Instagram ve Facebook'ta satış yapmak için Meta'ya bağlar; Nuvemshop Yardım Merkezi'nin anlattığı gibi, yönetici panelindeki Canais de venda bölümünden. Bu akış her yeni ürün için bir feed paylaşımı yayımlar.

Nuvemshop ürünlerini paylaşmak için easyCoexistence ne kadar tutar?

Bağlantı başına aylık US$ 9 ile US$ 0,75 arasında, bağlantı ekledikçe düşer; her ağda aynı fiyatla. posts API, medya yükleme ve MCP konektörü dahildir; ilk 3 gün ücretsiz deneme.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi