AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Neue Nuvemshop- und Tiendanube-Produkte automatisch auf Instagram, TikTok und Facebook posten

Der product/created-Webhook einer Nuvemshop- oder Tiendanube-App kann jedes neue Produkt über easyCoexistence auf Instagram, TikTok und Facebook posten: n8n oder ein kurzes Skript ruft das Produkt ab, wandelt das Hauptfoto für Instagram in JPEG um und sendet Text, Foto und Link an die Posts-API von easyCoexistence. Diese veröffentlicht über die offizielle API jedes Netzwerks, sofort oder später. Claude postet Produkte auf Anfrage mit dem eigenen Connector von Nuvemshop.

3 seconds

Wie lange Nuvemshop auf eine 2XX-Antwort auf einen Webhook wartet, bevor es erneut versucht, bis zu 16 Versuche innerhalb von 48 Stunden.

store_id, event, id

Die Felder, die ein Nuvemshop-Produkt-Webhook enthält, mit Zeitstempel und ohne Produktdetails, sodass das Produkt mit GET /products/{id} gelesen wird.

x-linkedstore-hmac-sha256

Der Header mit der HMAC-SHA256-Signatur jedes Webhooks, geschlüsselt mit dem Client Secret der App, nicht mit dem Access-Token des Shops.

WebP

Das Format, in dem Nuvemshop Produktbilder nach der Optimierung ausliefern kann, ohne API-Option zum Abschalten der Umwandlung.

admin-mcp.nuvemshop.com.br

Die Adresse, die das Help Center von Nuvemshop für das Hinzufügen des eigenen MCP-Connectors zu Claude als benutzerdefinierten Connector angibt.

1080 × 1920

Das größte Bild eines TikTok-Fotobeitrags, 1920 × 1080, als JPG oder WebP mit bis zu 20 MB.

Wie wird ein neues Nuvemshop-Produkt zu einem Beitrag?

Über eine App, einen Webhook und einen Aufruf pro Konto. Die Webhooks von Nuvemshop gehören zu einer App, also legen Sie eine mit dem Scope read_products an, installieren Sie sie in Ihrem Shop und registrieren Sie einen Webhook für product/created, der auf Ihren n8n-Workflow oder Server zeigt. Die Benachrichtigung enthält die Shop-ID, das Ereignis und die ID des Produkts, ohne Produktdetails. Der Workflow liest das Produkt daher mit GET /products/{id}, prüft, ob es sichtbar ist und ein Foto hat, und sendet je Konto eine Anfrage an die Posts-API von easyCoexistence: einen Fotobeitrag für Instagram und TikTok, einen Linkbeitrag für Facebook. easyCoexistence veröffentlicht jeden über die offizielle API des Netzwerks, sofort oder zum publish_at, das Sie festlegen.

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

Wie richten Sie die Nuvemshop-App und ihren Webhook ein?

Einmal, über das Partners Portal und ein Terminal. Registrieren Sie sich als Nuvemshop- oder Tiendanube-Partner, legen Sie unter Apps eine App mit read_products an, die auch Produktbilder und Varianten abdeckt, und installieren Sie sie in Ihrem Shop. Der an Ihre Redirect-URL gesendete Autorisierungscode ist 5 Minuten gültig und wird unter https://www.tiendanube.com/apps/authorize/token gegen ein Access-Token und eine user_id getauscht, also die Shop-ID. Das Token läuft nicht ab, bis Sie für diese App und diesen Shop ein neues anfordern oder die App deinstalliert wird. Danach registrieren Sie den Webhook mit POST /webhooks. Jede Anfrage trägt Authorization: Bearer mit dem Token und einen User-Agent mit dem Namen Ihrer App und einem Kontakt, sonst antwortet Nuvemshop mit 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" }'

Was macht der n8n-Workflow mit jedem Produkt?

Antworten, prüfen, lesen, umwandeln und posten. Ein Webhook-Knoten mit eingeschaltetem Raw Body und Respond auf Immediately antwortet innerhalb der 3 Sekunden von Nuvemshop. Ein Extract-From-File-Knoten macht aus dem Body Text, ein Crypto-Knoten berechnet dessen Hmac mit SHA256 und HEX, geschlüsselt mit dem Client Secret der App, und ein If-Knoten lässt den Lauf nur weiterlaufen, wenn das Ergebnis dem Header x-linkedstore-hmac-sha256 entspricht.

Ein HTTP-Request-Knoten liest dann GET /products/{{ $json.id }} mit dem Token des Shops. Ein If-Knoten fährt fort, wenn visibility gleich visible ist und images nicht leer ist. Ein Remove-Duplicates-Knoten, eingestellt auf Remove Items Processed in Previous Executions, verwirft ein bereits gepostetes Produkt, da Nuvemshop dieselbe Benachrichtigung zweimal senden kann. Für Instagram lädt ein HTTP-Request-Knoten das Hauptbild als Datei herunter, ein Edit-Image-Knoten skaliert es mit jpeg als Format, und ein HTTP-Request-Knoten sendet es als n8n Binary File an POST /api/v1/media, der eine media_id zurückgibt. Pro Konto ruft ein HTTP-Request POST /api/v1/channels/<account_id>/posts auf.

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

Wie postet ein Skript Produkte ohne n8n?

Mit einem kleinen Web-Endpoint. Das folgende Python-Skript prüft die Signatur gegen den Raw Body mit dem Client Secret der App, antwortet sofort mit 200 und erledigt den Rest im Hintergrund: Es liest das Produkt, überspringt eines, das nicht sichtbar ist oder kein Foto hat, und wandelt das Hauptfoto mit Pillow in ein JPEG mit höchstens 1080 Pixeln pro Seite um, das Instagram und TikTok beide akzeptieren. Die Datei lädt es nach POST /media hoch, postet sie auf Instagram und TikTok und erstellt auf Facebook einen Linkbeitrag. Jeder Aufruf trägt einen Idempotency-Key aus Produkt und Konto, den easyCoexistence berücksichtigt. Eine Liste gesendeter IDs verhindert, dass eine wiederholte Benachrichtigung doppelt postet.

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

Wie posten Claude und ChatGPT Produkte auf Anfrage?

Mit dem eigenen Connector von Nuvemshop neben dem von easyCoexistence. Das Help Center von Nuvemshop beschreibt einen KI-Connector auf Basis von MCP, der mit Claude, mit ChatGPT über dessen Connectors und mit Editoren wie Cursor funktioniert. In Claude wird er als benutzerdefinierter Connector unter https://admin-mcp.nuvemshop.com.br hinzugefügt, seine Lesewerkzeuge suchen Produkte, Bestellungen und Kunden. Fragen Sie zum Beispiel: "Posten Sie unsere fünf neuesten Produkte ab morgen um 10 Uhr Zeit in São Paulo auf TikTok, eines pro Stunde, mit einer Bildunterschrift für jedes." Der Assistent liest die Produkte, schreibt die Bildunterschriften und plant jeden Beitrag mit scheduled_at. Er handelt nur auf Anfrage und beobachtet den Shop nicht zwischen den Chats, deshalb gehen über Nacht hinzugefügte Produkte über den Webhook raus.

Was akzeptiert jedes Netzwerk in einem Produktbeitrag?

Die Regeln jedes Netzwerks gelten zusammen mit den eigenen Prüfungen von easyCoexistence, sobald der Beitrag gesendet oder geplant wird. Ein Produkt, das nicht veröffentlicht werden kann, wird daher sofort abgelehnt:

  • Instagram: nur JPEG-Bilder, also ein WebP- oder PNG-Produktfoto zuerst umwandeln; mehrere Fotos ergeben ein Karussell. Ein Beitrag hat kein Linkfeld, deshalb steht die Adresse des Produkts als Text in der Bildunterschrift.
  • TikTok: Fotobeiträge aus 1 bis 35 JPG- oder WebP-Bildern, jedes bis zu 1080 × 1920 oder 1920 × 1080 Pixel und 20 MB, mit einem Titel von 90 Zeichen und 15 Fotobeiträgen pro Konto und Tag.
  • Facebook: ein Linkbeitrag auf die canonical_url des Produkts mit der Vorschau, die Facebook aus den Open-Graph-Tags der Seite erstellt, oder ein Foto mit der Adresse im Text.
  • Medien über easyCoexistence: ein HTTPS-Link oder eine media_id von POST /media, mit Bildern bis 30 MB, die beim Planen eines Beitrags kopiert werden.
  • Bildunterschriften: Name und Beschreibung von Nuvemshop sind nach Sprache geordnete Objekte, etwa pt oder es, und die Beschreibung ist HTML. Wählen Sie also eine Sprache und entfernen Sie die Tags.

So richten Sie es ein

  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.

Häufige Fehler

  • Erst nach dem Versand der Beiträge bei Nuvemshop antworten. Nuvemshop wartet 3 Sekunden auf eine 2XX-Antwort und versucht es dann erneut, bis zu 16-mal innerhalb von 48 Stunden. Antworten Sie also zuerst und posten Sie danach.
  • Instagram das Produktfoto so senden, wie Nuvemshop es ausliefert. Nuvemshop kann WebP liefern, unabhängig von der Endung der Adresse, und Instagram veröffentlicht nur JPEG. Prüfen Sie daher den Content-Type der Datei und wandeln Sie sie um.
  • Die Signatur mit dem Access-Token des Shops prüfen. Nuvemshop signiert mit dem Client Secret der App über den Raw Body, also berechnen Sie den HMAC, bevor der Body geparst wird.
  • Ein Produkt im Moment seiner Erstellung posten. Es kann versteckt oder ohne Fotos starten. Prüfen Sie daher visibility und images, hören Sie auch auf product/updated und posten Sie jedes Produkt nur einmal.
Mit EasyCoexistence

easyCoexistence gibt Ihrem Shop und den KI-Agenten, die ihn betreiben, Reichweite zu Kunden auf Instagram, TikTok, Facebook und weiteren Kanälen, jeweils über deren offizielle API: eine Posts-API und Medien-Upload für n8n und Ihre Skripte, einen MCP-Connector für Claude und ChatGPT neben dem von Nuvemshop sowie eine Warteschlange, die bis zu 90 Tage im Voraus veröffentlicht. Jede Verbindung wird rund um die Uhr überwacht. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Funktioniert es mit Tiendanube-Shops?

Ja. Nuvemshop und Tiendanube teilen sich eine API: Jede tiendanube.com-Adresse in der Dokumentation hat ein identisches Gegenstück auf nuvemshop.com.br, und die API antwortet sowohl auf api.tiendanube.com als auch auf api.nuvemshop.com.br.

Kann es ein Produkt erneut posten, wenn es reduziert wird?

Ja. Hören Sie zusätzlich auf product/updated und vergleichen Sie das promotional_price der Varianten mit dem zuletzt geposteten. Die Benachrichtigung enthält die ID des Produkts, nicht seine Details, also lesen Sie das Produkt jedes Mal neu.

Was macht der eigene Instagram- und Facebook-Kanal von Nuvemshop?

Er verbindet Katalog, Pixel und Shop des Shops mit Meta, damit man auf Instagram und Facebook verkaufen kann, wie das Help Center von Nuvemshop beschreibt, über Canais de venda im Admin. Dieser Ablauf veröffentlicht für jedes neue Produkt einen Feed-Beitrag.

Was kostet easyCoexistence für das Posten von Nuvemshop-Produkten?

US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, auf jedem Netzwerk gleich. Die Posts-API, der Medien-Upload und der MCP-Connector sind enthalten, mit einer kostenlosen Testphase von 3 Tagen.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am