Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Automatycznie publikuj nowe produkty z Nuvemshop i Tiendanube na Instagramie, TikToku i Facebooku

Webhook produktu z aplikacji Nuvemshop lub Tiendanube, dla zdarzenia product/created, może publikować każdy nowy produkt na Instagramie, TikToku i Facebooku przez easyCoexistence: n8n lub krótki skrypt pobiera produkt, konwertuje jego główne zdjęcie do JPEG dla Instagrama i wysyła tekst, zdjęcie oraz link do API postów easyCoexistence, które publikuje przez oficjalne API każdej sieci, od razu lub później. Claude publikuje produkty na żądanie za pomocą własnego konektora Nuvemshop.

3 seconds

Jak długo Nuvemshop czeka na odpowiedź 2XX na webhook, zanim ponowi próbę, do 16 prób w ciągu 48 godzin.

store_id, event, id

Pola, jakie niesie webhook produktu Nuvemshop: znacznik czasu i brak szczegółów produktu, więc produkt odczytuje się przez GET /products/{id}.

x-linkedstore-hmac-sha256

Nagłówek z podpisem HMAC-SHA256 każdego webhooka, kluczem jest client secret aplikacji, a nie tokenu dostępu sklepu.

WebP

Format, w jakim Nuvemshop może udostępniać zdjęcia produktów po optymalizacji, bez opcji API wyłączającej konwersję.

admin-mcp.nuvemshop.com.br

Adres, który Centrum pomocy Nuvemshop podaje do dodania własnego konektora MCP do Claude jako niestandardowego konektora.

1080 × 1920

Największy obraz w poście ze zdjęciem na TikToku, czyli 1920 × 1080, w formacie JPG lub WebP o wielkości do 20 MB.

Jak nowy produkt Nuvemshop staje się postem?

Przez aplikację, webhook i jedno wywołanie na konto. Webhooki Nuvemshop należą do aplikacji, więc utwórz ją z zakresem read_products, zainstaluj w swoim sklepie i zarejestruj webhook dla product/created, wskazujący na Twój workflow w n8n lub serwer. Powiadomienie zawiera ID sklepu, zdarzenie i ID produktu, bez szczegółów produktu, więc workflow odczytuje produkt przez GET /products/{id}, sprawdza, czy jest widoczny i ma zdjęcie, i wysyła jedno żądanie na konto do API postów easyCoexistence: post ze zdjęciem dla Instagrama i TikToka, post z linkiem dla Facebooka. easyCoexistence publikuje każdy z nich przez oficjalne API sieci, od razu lub o publish_at, który ustawisz.

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

Jak skonfigurować aplikację Nuvemshop i jej webhook?

Raz, w Partners Portal i w terminalu. Zarejestruj się jako partner Nuvemshop lub Tiendanube, utwórz aplikację w sekcji Apps z zakresem read_products, który obejmuje też zdjęcia i warianty produktów, i zainstaluj ją w swoim sklepie. Kod autoryzacji wysłany na Twój adres przekierowania jest ważny 5 minut i wymienia się go pod adresem https://www.tiendanube.com/apps/authorize/token na token dostępu i user_id, czyli ID sklepu; token nie wygasa, dopóki nie uzyskasz nowego dla tej aplikacji i sklepu albo dopóki aplikacja nie zostanie odinstalowana. Następnie zarejestruj webhook przez POST /webhooks. Każde żądanie niesie Authorization: Bearer z tokenem oraz User-Agent z nazwą aplikacji i kontaktem, w przeciwnym razie Nuvemshop odpowiada 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" }'

Co workflow n8n robi z każdym produktem?

Odpowiada, weryfikuje, odczytuje, konwertuje i publikuje. Węzeł Webhook z włączonym Raw Body i Respond ustawionym na Immediately odpowiada, zanim minie limit 3 sekund Nuvemshop. Węzeł Extract From File zamienia treść na tekst, węzeł Crypto liczy jej Hmac z SHA256 i HEX, kluczem jest client secret aplikacji, a węzeł If przepuszcza przebieg tylko wtedy, gdy wynik równa się nagłówkowi x-linkedstore-hmac-sha256.

Węzeł HTTP Request odczytuje GET /products/{{ $json.id }} tokenem sklepu. Węzeł If kontynuuje, gdy visibility jest visible, a images nie jest puste, a węzeł Remove Duplicates ustawiony na Remove Items Processed in Previous Executions odrzuca produkt już opublikowany, bo Nuvemshop może wysłać to samo powiadomienie dwa razy. Dla Instagrama węzeł HTTP Request pobiera główne zdjęcie jako plik, węzeł Edit Image zmienia rozmiar z jpeg jako Format, a węzeł HTTP Request wysyła je jako n8n Binary File do POST /api/v1/media, który zwraca media_id. Jeden HTTP Request na konto wywołuje 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

Jak skrypt publikuje produkty bez n8n?

Małym endpointem webowym. Poniższy Python sprawdza podpis względem surowej treści żądania kluczem client secret aplikacji, odpowiada 200 od razu i resztę wykonuje w tle: odczytuje produkt, pomija produkt niewidoczny lub bez zdjęcia, a główne zdjęcie konwertuje Pillow do JPEG o boku nie większym niż 1080 pikseli, który akceptują zarówno Instagram, jak i TikTok. Przesyła ten plik na POST /media, publikuje go na Instagramie i TikToku, a na Facebooku tworzy post z linkiem. Każde wywołanie niesie Idempotency-Key utworzony z produktu i konta, który easyCoexistence respektuje, a zbiór opublikowanych ID chroni przed dwukrotnym opublikowaniem tego samego powiadomienia.

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

Jak Claude i ChatGPT publikują produkty na żądanie?

Własnym konektorem Nuvemshop obok konektora easyCoexistence. Centrum pomocy Nuvemshop opisuje konektor AI oparty na MCP, który działa z Claude, z ChatGPT przez jego konektory oraz z edytorami takimi jak Cursor; w Claude dodaje się go jako niestandardowy konektor pod adresem https://admin-mcp.nuvemshop.com.br, a jego narzędzia odczytu wyszukują produkty, zamówienia i klientów. Poproś na przykład: „Opublikuj nasze pięć najnowszych produktów na TikToku od jutra o 10:00 czasu São Paulo, jeden co godzinę, z podpisem do każdego.” Asystent odczytuje produkty, pisze podpisy i planuje każdy post przez scheduled_at. Działa, gdy o to poprosisz, i nie obserwuje sklepu między rozmowami, więc produkty dodane w nocy wychodzą przez webhook.

Czego wymaga każda sieć w poście o produkcie?

Zasady każdej sieci, z dodatkowymi kontrolami easyCoexistence, obowiązują w chwili wysłania lub zaplanowania, więc produkt, którego nie da się opublikować, zostaje odrzucony od razu:

  • Instagram: wyłącznie obrazy JPEG, więc najpierw przekonwertuj zdjęcie produktu z WebP lub PNG; kilka zdjęć tworzy karuzelę. Post nie ma pola na link, więc adres produktu trafia do podpisu jako tekst.
  • TikTok: posty ze zdjęciami z 1 do 35 obrazów JPG lub WebP, każdy do 1080 × 1920 lub 1920 × 1080 pikseli i 20 MB, tytuł do 90 znaków oraz 15 postów ze zdjęciami na konto dziennie.
  • Facebook: post z linkiem do canonical_url produktu, z podglądem zbudowanym przez Facebooka z tagów Open Graph strony, albo jedno zdjęcie z adresem w tekście.
  • Media przez easyCoexistence: link HTTPS albo media_id z POST /media, z obrazami do 30 MB, kopiowane w chwili zaplanowania posta.
  • Podpisy: nazwa i opis produktu Nuvemshop to obiekty z kluczem językowym, np. pt lub es, a opis jest w HTML, więc wybierz jeden język i usuń znaczniki.

Jak to skonfigurować

  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.

Typowe błędy

  • Zwlekanie z odpowiedzią Nuvemshop, aż posty wyjdą. Nuvemshop czeka 3 sekundy na 2XX, a potem ponawia próbę, do 16 razy w ciągu 48 godzin, więc najpierw odpowiedz, a dopiero potem publikuj.
  • Wysyłanie na Instagram zdjęcia produktu w formie, w jakiej serwuje je Nuvemshop. Nuvemshop może dostarczać WebP bez względu na rozszerzenie adresu, a Instagram publikuje wyłącznie JPEG, więc sprawdź Content-Type pliku i go skonwertuj.
  • Weryfikowanie podpisu tokenem dostępu sklepu. Nuvemshop podpisuje kluczem client secret aplikacji, nad surową treścią, więc oblicz HMAC przed sparsowaniem treści.
  • Publikowanie produktu w chwili jego utworzenia. Może on zacząć jako ukryty albo bez zdjęć, więc sprawdź visibility i images, nasłuchuj też product/updated i publikuj każdy produkt raz.
Z EasyCoexistence zrobisz to

easyCoexistence daje Twojemu sklepowi i agentom AI, które nim zarządzają, dostęp do klientów na Instagramie, TikToku, Facebooku i kolejnych kanałach, każdy z nich przez oficjalne API: API postów i upload mediów dla n8n i Twoich skryptów, jeden konektor MCP dla Claude i ChatGPT obok konektora Nuvemshop oraz kolejkę, która publikuje do 90 dni wcześniej, a każde połączenie jest monitorowane całą dobę. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami za darmo.

Najczęściej zadawane pytania

Czy działa ze sklepami Tiendanube?

Tak. Nuvemshop i Tiendanube korzystają z jednego API: każdy adres tiendanube.com w dokumentacji ma identyczny odpowiednik na nuvemshop.com.br, a API odpowiada zarówno na api.tiendanube.com, jak i na api.nuvemshop.com.br.

Czy może ponownie opublikować produkt, gdy trafi do promocji?

Tak. Nasłuchuj też product/updated i porównuj promotional_price wariantów z tym, który opublikowano ostatnio; powiadomienie niesie ID produktu, a nie jego szczegóły, więc produkt odczytuj za każdym razem.

Co robi własny kanał Instagrama i Facebooka Nuvemshop?

Łączy katalog sklepu, Pixel i sklep z Meta na potrzeby sprzedaży na Instagramie i Facebooku, jak opisuje Centrum pomocy Nuvemshop, z sekcji Canais de venda w panelu administracyjnym. Ten przepływ publikuje post w feedzie dla każdego nowego produktu.

Ile kosztuje easyCoexistence do publikowania produktów Nuvemshop?

Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, takie same na każdej sieci. API postów, upload mediów i konektor MCP są w cenie, z pierwszymi 3 dniami za darmo.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w