AccediInizia la prova gratuita
easyCoexistence API ufficiali

Pubblica in automatico i nuovi prodotti Nuvemshop e Tiendanube su Instagram, TikTok e Facebook

Il webhook product/created di un'app Nuvemshop o Tiendanube può pubblicare ogni nuovo prodotto su Instagram, TikTok e Facebook tramite easyCoexistence: n8n o un breve script recupera il prodotto, converte la foto principale in JPEG per Instagram e invia testo, foto e link all'API dei post di easyCoexistence, che pubblica tramite l'API ufficiale di ciascuna rete, subito o più tardi. Claude pubblica i prodotti su richiesta con il connettore nativo di Nuvemshop.

3 seconds

Quanto attende Nuvemshop una risposta 2XX a un webhook prima di riprovare, fino a 16 tentativi entro 48 ore.

store_id, event, id

I campi che un webhook di prodotto di Nuvemshop contiene, con un timestamp e nessun dettaglio del prodotto, quindi il prodotto si legge con GET /products/{id}.

x-linkedstore-hmac-sha256

L'header che contiene la firma HMAC-SHA256 di ogni webhook, calcolata con il client secret dell'app e non con il token di accesso dello store.

WebP

Il formato in cui Nuvemshop può servire le immagini dei prodotti dopo l'ottimizzazione, senza alcuna opzione API per disattivare la conversione.

admin-mcp.nuvemshop.com.br

L'indirizzo che il Centro assistenza di Nuvemshop indica per aggiungere a Claude il suo connettore MCP come connettore personalizzato.

1080 × 1920

La dimensione massima di immagine accettata da un post foto su TikTok, cioè 1920 × 1080, in JPG o WebP fino a 20 MB.

Come diventa un post un nuovo prodotto Nuvemshop?

Tramite un'app, un webhook e una chiamata per account. I webhook di Nuvemshop appartengono a un'app, quindi creane una con lo scope read_products, installala nel tuo store e registra un webhook per product/created che punti al tuo workflow n8n o al tuo server. La notifica contiene l'ID dello store, l'evento e l'ID del prodotto, senza dettagli del prodotto, quindi il workflow legge il prodotto con GET /products/{id}, verifica che sia visibile e abbia una foto, e invia una richiesta per account all'endpoint dei post di easyCoexistence: un post foto per Instagram e TikTok, un post con link per Facebook. easyCoexistence pubblica ciascuno tramite l'API ufficiale della rete, subito o al publish_at che imposti.

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

Come si configurano l'app Nuvemshop e il suo webhook?

Una volta sola, dal Partners Portal e da un terminale. Registrati come partner di Nuvemshop o Tiendanube, crea un'app in Apps con read_products, che copre anche le immagini e le varianti dei prodotti, e installala nel tuo store. Il codice di autorizzazione inviato al tuo redirect URL dura 5 minuti e si scambia all'indirizzo https://www.tiendanube.com/apps/authorize/token con un token di accesso e uno user_id, cioè l'ID dello store; il token non scade finché non ne ottieni uno nuovo per quell'app e quello store o l'app non viene disinstallata. Poi registra il webhook con POST /webhooks. Ogni richiesta porta Authorization: Bearer con il token e uno User-Agent che indica la tua app e un contatto, altrimenti Nuvemshop risponde 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" }'

Che cosa fa il workflow n8n con ogni prodotto?

Risponde, verifica, legge, converte e pubblica. Un nodo Webhook con Raw Body attivo e Respond impostato su Immediately risponde entro i 3 secondi di Nuvemshop. Un nodo Extract From File trasforma il corpo in testo, un nodo Crypto calcola il suo Hmac con SHA256 e HEX, con il client secret dell'app, e un nodo If lascia proseguire l'esecuzione solo quando il risultato è uguale all'header x-linkedstore-hmac-sha256.

Un nodo HTTP Request legge poi GET /products/{{ $json.id }} con il token dello store. Un nodo If prosegue quando la visibilità è visible e images non è vuoto, e un nodo Remove Duplicates impostato su Remove Items Processed in Previous Executions scarta un prodotto già pubblicato, dato che Nuvemshop può inviare la stessa notifica due volte. Per Instagram, un nodo HTTP Request scarica l'immagine principale come file, un nodo Edit Image la ridimensiona con jpeg come Format, e un nodo HTTP Request la invia come n8n Binary File a POST /api/v1/media, che restituisce un media_id. Una HTTP Request per account chiama poi 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

Come pubblica i prodotti uno script senza n8n?

Con un piccolo endpoint web. Il codice Python qui sotto verifica la firma sul corpo grezzo con il client secret dell'app, risponde subito 200 e fa il resto in background: legge il prodotto, salta quello non visibile o senza foto, e converte la foto principale con Pillow in un JPEG di al massimo 1080 pixel per lato, che Instagram e TikTok accettano entrambi. Carica il file su POST /media, lo pubblica su Instagram e TikTok e crea un post con link su Facebook. Ogni chiamata porta un Idempotency-Key ricavato dal prodotto e dall'account, che easyCoexistence rispetta, e un insieme di ID già pubblicati impedisce che una notifica ripetuta pubblichi due volte.

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

Come pubblicano prodotti Claude e ChatGPT su richiesta?

Con il connettore nativo di Nuvemshop accanto a quello di easyCoexistence. Il Centro assistenza di Nuvemshop descrive un connettore AI basato su MCP che funziona con Claude, con ChatGPT tramite i suoi connettori e con editor come Cursor; in Claude si aggiunge come connettore personalizzato all'indirizzo https://admin-mcp.nuvemshop.com.br, e i suoi strumenti di lettura cercano prodotti, ordini e clienti. Chiedi, per esempio: "Pubblica i nostri cinque prodotti più recenti su TikTok da domani alle 10 ora di São Paulo, uno all'ora, con una didascalia per ciascuno." L'assistente legge i prodotti, scrive le didascalie e programma ogni post con scheduled_at. Agisce quando gli viene chiesto e non controlla lo store tra una chat e l'altra, quindi i prodotti aggiunti di notte partono tramite il webhook.

Che cosa accetta ogni rete in un post di prodotto?

Le regole di ciascuna rete, con i controlli propri di easyCoexistence, si applicano quando il post viene inviato o programmato, quindi un prodotto che non può uscire viene rifiutato subito:

  • Instagram: solo immagini JPEG, quindi converti prima una foto prodotto in WebP o PNG; più foto creano un carosello. Un post non ha un campo link, quindi l'indirizzo del prodotto va nella didascalia come testo.
  • TikTok: post foto con da 1 a 35 immagini JPG o WebP, ciascuna fino a 1080 × 1920 o 1920 × 1080 pixel e 20 MB, un titolo di 90 caratteri e 15 post foto per account al giorno.
  • Facebook: un post con link al canonical_url del prodotto, con l'anteprima che Facebook costruisce dai tag Open Graph della pagina, oppure una foto con l'indirizzo nel testo.
  • Media tramite easyCoexistence: un link HTTPS o un media_id da POST /media, con immagini fino a 30 MB, copiate al momento della programmazione del post.
  • Didascalie: nome e descrizione di Nuvemshop sono oggetti indicizzati per lingua, come pt o es, e la descrizione è HTML, quindi scegli una lingua e rimuovi i tag.

Come configurarlo

  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.

Errori comuni

  • Rispondere a Nuvemshop dopo la pubblicazione dei post. Attende 3 secondi una risposta 2XX e poi riprova, fino a 16 volte in 48 ore, quindi rispondi per primo e pubblica dopo.
  • Inviare a Instagram la foto del prodotto così come la serve Nuvemshop. Nuvemshop può consegnare WebP qualunque sia l'estensione dell'indirizzo, e Instagram pubblica solo JPEG, quindi controlla il Content-Type del file e convertilo.
  • Verificare la firma con il token di accesso dello store. Nuvemshop firma con il client secret dell'app, sul corpo grezzo, quindi calcola l'HMAC prima che il corpo venga analizzato.
  • Pubblicare un prodotto nel momento stesso in cui viene creato. Può nascere nascosto o senza foto, quindi verifica visibilità e immagini, ascolta anche product/updated e pubblica ogni prodotto una sola volta.
Farlo con EasyCoexistence

easyCoexistence dà al tuo store, e agli agenti AI che lo gestiscono, la possibilità di raggiungere i clienti su Instagram, TikTok, Facebook e altri canali, ciascuno tramite la sua API ufficiale: un'API dei post e upload dei media per n8n e i tuoi script, un connettore MCP per Claude e ChatGPT accanto a quello di Nuvemshop, e una coda che pubblica fino a 90 giorni in anticipo, con ogni connessione monitorata 24/7. Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni gratuiti.

Domande frequenti

Funziona con gli store Tiendanube?

Sì. Nuvemshop e Tiendanube condividono un'unica API: ogni indirizzo tiendanube.com nella documentazione ha un equivalente identico su nuvemshop.com.br, e l'API risponde su api.tiendanube.com e api.nuvemshop.com.br.

Può pubblicare di nuovo un prodotto quando va in promozione?

Sì. Ascolta anche product/updated e confronta il promotional_price delle varianti con quello che hai pubblicato per ultimo; la notifica contiene l'ID del prodotto, non i suoi dettagli, quindi leggi il prodotto ogni volta.

Che cosa fa il canale Instagram e Facebook nativo di Nuvemshop?

Collega il catalogo, il Pixel e lo shop dello store a Meta per vendere su Instagram e Facebook, come descrive il Centro assistenza di Nuvemshop, dalla voce Canais de venda nell'admin. Questo flusso pubblica un post nel feed per ogni nuovo prodotto.

Quanto costa easyCoexistence per pubblicare i prodotti Nuvemshop?

Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, uguale su ogni rete. L'API dei post, l'upload dei media e il connettore MCP sono inclusi, con i primi 3 giorni gratuiti.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il