ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Αυτόματη ανάρτηση νέων προϊόντων Nuvemshop και Tiendanube σε Instagram, TikTok και Facebook

Το webhook product/created μιας εφαρμογής Nuvemshop ή Tiendanube μπορεί να ανεβάζει κάθε νέο προϊόν σε Instagram, TikTok και Facebook μέσω του easyCoexistence: ένα workflow στο n8n ή ένα σύντομο script διαβάζει το προϊόν, μετατρέπει την κύρια φωτογραφία του σε JPEG για το Instagram και στέλνει κείμενο, φωτογραφία και σύνδεσμο στο posts API του easyCoexistence, το οποίο δημοσιεύει μέσω του επίσημου API κάθε δικτύου, άμεσα ή αργότερα. Το Claude δημοσιεύει προϊόντα κατόπιν αιτήματος με τον δικό του connector της Nuvemshop.

3 seconds

Πόσο περιμένει η Nuvemshop απάντηση 2XX σε ένα webhook πριν επαναλάβει, έως 16 προσπάθειες μέσα σε 48 ώρες.

store_id, event, id

Τα πεδία που μεταφέρει ένα webhook προϊόντος της Nuvemshop, με χρονική σήμανση και χωρίς λεπτομέρειες προϊόντος, ώστε το προϊόν να διαβάζεται με GET /products/{id}.

x-linkedstore-hmac-sha256

Η κεφαλίδα που περιέχει την υπογραφή HMAC-SHA256 κάθε webhook, με κλειδί το client secret της εφαρμογής και όχι το access token του καταστήματος.

WebP

Η μορφή στην οποία η Nuvemshop μπορεί να προσφέρει εικόνες προϊόντων μετά τη βελτιστοποίηση, χωρίς επιλογή API για απενεργοποίηση της μετατροπής.

admin-mcp.nuvemshop.com.br

Η διεύθυνση που δίνει το Κέντρο Βοήθειας της Nuvemshop για την προσθήκη του δικού της MCP connector στο Claude ως custom connector.

1080 × 1920

Η μεγαλύτερη εικόνα που δέχεται μια ανάρτηση φωτογραφίας στο TikTok, 1920 × 1080, σε JPG ή WebP έως 20 MB.

Πώς γίνεται ένα νέο προϊόν Nuvemshop ανάρτηση;

Μέσω μιας εφαρμογής, ενός webhook και μιας κλήσης ανά λογαριασμό. Τα webhooks της Nuvemshop ανήκουν σε μια εφαρμογή, οπότε δημιουργήστε μία με το scope read_products, εγκαταστήστε την στο κατάστημά σας και καταχωρίστε webhook για το product/created που δείχνει στο workflow σας στο n8n ή στον server σας. Η ειδοποίηση περιέχει το ID του καταστήματος, το γεγονός και το ID του προϊόντος, χωρίς λεπτομέρειες, οπότε το workflow διαβάζει το προϊόν με GET /products/{id}, ελέγχει ότι είναι ορατό και έχει φωτογραφία, και στέλνει ένα αίτημα ανά λογαριασμό στο posts API του easyCoexistence: ανάρτηση φωτογραφίας για Instagram και TikTok, ανάρτηση συνδέσμου για Facebook. Το easyCoexistence δημοσιεύει την καθεμία μέσω του επίσημου API του δικτύου, αμέσως ή στο publish_at που ορίζετε.

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 και το webhook της;

Μία φορά, από το Partners Portal και ένα τερματικό. Εγγραφείτε ως συνεργάτης της Nuvemshop ή της Tiendanube, δημιουργήστε μια εφαρμογή στην ενότητα Apps με read_products, που καλύπτει επίσης τις εικόνες και τις παραλλαγές προϊόντων, και εγκαταστήστε την στο κατάστημά σας. Ο κωδικός εξουσιοδότησης που στέλνεται στο redirect URL σας ισχύει 5 λεπτά και ανταλλάσσεται στη διεύθυνση https://www.tiendanube.com/apps/authorize/token με ένα access token και ένα user_id, δηλαδή το ID του καταστήματος. Το token δεν λήγει μέχρι να λάβετε νέο για αυτή την εφαρμογή και κατάστημα ή μέχρι να απεγκατασταθεί η εφαρμογή. Στη συνέχεια καταχωρίστε το webhook με POST /webhooks. Κάθε αίτημα φέρει Authorization: Bearer με το token και ένα User-Agent με το όνομα της εφαρμογής σας και ένα στοιχείο επικοινωνίας, αλλιώς η Nuvemshop απαντά 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" }'

Τι κάνει το workflow του n8n με κάθε προϊόν;

Απαντά, επαληθεύει, διαβάζει, μετατρέπει και δημοσιεύει. Ένας κόμβος Webhook με Raw Body ενεργό και Respond ρυθμισμένο σε Immediately απαντά μέσα στα 3 δευτερόλεπτα της Nuvemshop. Ένας κόμβος Extract From File μετατρέπει το σώμα σε κείμενο, ένας κόμβος Crypto υπολογίζει το Hmac με SHA256 και HEX, με κλειδί το client secret της εφαρμογής, και ένας κόμβος If αφήνει τη ροή να συνεχίσει μόνο όταν το αποτέλεσμα ισούται με την κεφαλίδα x-linkedstore-hmac-sha256.

Ένας κόμβος HTTP Request διαβάζει στη συνέχεια το GET /products/{{ $json.id }} με το token του καταστήματος. Ένας κόμβος If συνεχίζει όταν το visibility είναι visible και το images δεν είναι κενό, και ένας κόμβος Remove Duplicates ρυθμισμένος σε Remove Items Processed in Previous Executions αφαιρεί προϊόν που έχει ήδη δημοσιευτεί, επειδή η Nuvemshop μπορεί να στείλει την ίδια ειδοποίηση δύο φορές. Για το Instagram, ένας κόμβος HTTP Request κατεβάζει την κύρια εικόνα ως αρχείο, ένας κόμβος Edit Image την αλλάζει μέγεθος με jpeg ως Format, και ένας κόμβος HTTP Request τη στέλνει ως n8n Binary File στο POST /api/v1/media, το οποίο επιστρέφει ένα media_id. Ένα HTTP Request ανά λογαριασμό καλεί στη συνέχεια το 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

Πώς δημοσιεύει ένα script προϊόντα χωρίς n8n;

Με ένα μικρό web endpoint. Το παρακάτω script σε Python ελέγχει την υπογραφή στο raw body με το client secret της εφαρμογής, απαντά 200 αμέσως και κάνει τα υπόλοιπα στο παρασκήνιο: διαβάζει το προϊόν, παραλείπει όποιο δεν είναι ορατό ή δεν έχει φωτογραφία, και μετατρέπει την κύρια φωτογραφία με Pillow σε JPEG έως 1080 pixels ανά πλευρά, που δέχονται και το Instagram και το TikTok. Ανεβάζει το αρχείο στο POST /media, το δημοσιεύει στο Instagram και στο TikTok και κάνει ανάρτηση συνδέσμου στο Facebook. Κάθε κλήση φέρει Idempotency-Key φτιαγμένο από το προϊόν και τον λογαριασμό, το οποίο τηρεί το easyCoexistence, και ένα σύνολο δημοσιευμένων IDs εμποδίζει μια επαναλαμβανόμενη ειδοποίηση να δημοσιεύσει δεύτερη φορά.

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 και το ChatGPT κατόπιν αιτήματος;

Με τον δικό του connector της Nuvemshop, δίπλα σε αυτόν του easyCoexistence. Το Κέντρο Βοήθειας της Nuvemshop περιγράφει έναν AI connector βασισμένο στο MCP που λειτουργεί με το Claude, με το ChatGPT μέσω των connectors του και με επεξεργαστές όπως το Cursor. Στο Claude προστίθεται ως custom connector στη διεύθυνση https://admin-mcp.nuvemshop.com.br, και τα εργαλεία ανάγνωσης του αναζητούν προϊόντα, παραγγελίες και πελάτες. Ζητήστε, για παράδειγμα: «Δημοσίευσε τα πέντε νεότερα προϊόντα μας στο TikTok από αύριο στις 10 π.μ. ώρα São Paulo, ένα την ώρα, με λεζάντα για το καθένα». Ο βοηθός διαβάζει τα προϊόντα, γράφει τις λεζάντες και προγραμματίζει κάθε ανάρτηση με scheduled_at. Ενεργεί όταν του ζητηθεί και δεν παρακολουθεί το κατάστημα ανάμεσα στις συνομιλίες, οπότε τα προϊόντα που προστίθενται τη νύχτα φεύγουν μέσω του webhook.

Τι δέχεται κάθε δίκτυο σε μια ανάρτηση προϊόντος;

Οι κανόνες κάθε δικτύου, με τους δικούς του ελέγχους του easyCoexistence από πάνω, ισχύουν τη στιγμή που στέλνεται ή προγραμματίζεται η ανάρτηση, οπότε ένα προϊόν που δεν μπορεί να φύγει απορρίπτεται αμέσως:

  • Instagram: μόνο εικόνες JPEG, οπότε μετατρέψτε πρώτα μια φωτογραφία προϊόντος WebP ή PNG. Πολλές φωτογραφίες δημιουργούν carousel. Η ανάρτηση δεν έχει πεδίο συνδέσμου, οπότε η διεύθυνση του προϊόντος μπαίνει στη λεζάντα ως κείμενο.
  • TikTok: αναρτήσεις φωτογραφιών από 1 έως 35 εικόνες JPG ή WebP, καθεμία έως 1080 × 1920 ή 1920 × 1080 pixels και 20 MB, τίτλος 90 χαρακτήρων και 15 αναρτήσεις φωτογραφιών ανά λογαριασμό την ημέρα.
  • Facebook: ανάρτηση συνδέσμου στο canonical_url του προϊόντος, με την προεπισκόπηση που χτίζει το Facebook από τις ετικέτες Open Graph της σελίδας, ή μία φωτογραφία με τη διεύθυνση στο κείμενο.
  • Πολυμέσα μέσω του easyCoexistence: σύνδεσμος HTTPS ή media_id από το POST /media, με εικόνες έως 30 MB, που αντιγράφονται όταν προγραμματίζεται η ανάρτηση.
  • Λεζάντες: το όνομα και η περιγραφή της Nuvemshop είναι αντικείμενα με κλειδί τη γλώσσα, όπως pt ή es, και η περιγραφή είναι HTML. Επιλέξτε μία γλώσσα και αφαιρέστε τις ετικέτες.

Πώς να το ρυθμίσετε

  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.

Συνηθισμένα λάθη

  • Απάντηση στη Nuvemshop αφού έχουν φύγει οι αναρτήσεις. Περιμένει 3 δευτερόλεπτα για 2XX και μετά επαναλαμβάνει, έως 16 φορές μέσα σε 48 ώρες, οπότε απαντήστε πρώτα και δημοσιεύετε μετά.
  • Αποστολή στο Instagram της φωτογραφίας προϊόντος όπως τη σερβίρει η Nuvemshop. Η Nuvemshop μπορεί να στείλει WebP ό,τι κι αν λήγει η διεύθυνση, και το Instagram δημοσιεύει μόνο JPEG, οπότε ελέγξτε το Content-Type του αρχείου και μετατρέψτε το.
  • Επαλήθευση της υπογραφής με το access token του καταστήματος. Η Nuvemshop υπογράφει με το client secret της εφαρμογής, πάνω στο raw body, οπότε υπολογίστε το HMAC πριν αναλυθεί το σώμα.
  • Δημοσίευση προϊόντος τη στιγμή που δημιουργείται. Μπορεί να ξεκινά κρυφό ή χωρίς φωτογραφίες, οπότε ελέγξτε το visibility και τα images, ακούστε και το product/updated, και δημοσιεύστε κάθε προϊόν μία φορά.
Κάντε το με EasyCoexistence

Το easyCoexistence δίνει στο κατάστημά σας, και στους AI agents που το διαχειρίζονται, πρόσβαση σε πελάτες στο Instagram, TikTok, Facebook και σε περισσότερα κανάλια, το καθένα μέσω του επίσημου API του: ένα posts API και upload πολυμέσων για το n8n και τα scripts σας, ένα MCP connector για το Claude και το ChatGPT δίπλα σε αυτό της Nuvemshop, και μια ουρά που δημοσιεύει έως 90 ημέρες μπροστά. Κάθε σύνδεση παρακολουθείται 24/7. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με πτώση καθώς προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Λειτουργεί με καταστήματα Tiendanube;

Ναι. Η Nuvemshop και η Tiendanube μοιράζονται ένα API: κάθε διεύθυνση tiendanube.com στα docs έχει ταυτόσημη στο nuvemshop.com.br, και το API απαντά και στο api.tiendanube.com και στο api.nuvemshop.com.br.

Μπορεί να ξαναδημοσιεύσει ένα προϊόν όταν μπαίνει σε προσφορά;

Ναι. Ακούστε και το product/updated και συγκρίνετε το promotional_price των παραλλαγών με εκείνο που δημοσιεύσατε τελευταία. Η ειδοποίηση φέρει το ID του προϊόντος, όχι τις λεπτομέρειες του, οπότε διαβάστε το προϊόν κάθε φορά.

Τι κάνει το δικό του κανάλι Instagram και Facebook της Nuvemshop;

Συνδέει τον κατάλογο, το Pixel και το κατάστημα του καταστήματος με τη Meta για πώληση στο Instagram και στο Facebook, όπως περιγράφει το Κέντρο Βοήθειας της Nuvemshop, από τα Canais de venda στο admin. Αυτή η ροή δημοσιεύει ανάρτηση feed για κάθε νέο προϊόν.

Πόσο κοστίζει το easyCoexistence για τη δημοσίευση προϊόντων Nuvemshop;

US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με πτώση καθώς προσθέτετε συνδέσεις, το ίδιο σε κάθε δίκτυο. Το posts API, το upload πολυμέσων και ο MCP connector περιλαμβάνονται, με τις πρώτες 3 ημέρες δωρεάν.

Συνεχίστε την ανάγνωση

Αυτόματη ανάρτηση προϊόντων Shopify σε Instagram, TikTok και FacebookΔημοσιεύστε νέα προϊόντα Shopify σε Instagram, TikTok, Facebook και άλλα μέσω του Shopify Flow, n8n ή Claude, με επίσημα API.Αυτοματισμός n8n για social media: Instagram, TikTok, Facebook και άλλαΑυτοματοποιήστε Instagram, TikTok, Facebook και YouTube στο n8n: υπογεγραμμένα συμβάντα σε κόμβο Webhook και AI Agent με 35+ εργαλεία MCP.Πώς να εγκρίνετε αναρτήσεις γραμμένες από AI πριν δημοσιευτούνΚρατήστε άνθρωπο στη διαδικασία για τις αναρτήσεις AI: πρόχειρα στη συνομιλία, η ουρά ως παράθυρο ελέγχου, επεξεργασία και ακύρωση πριν τη δημοσίευση.Εξυπηρέτηση πελατών με AI στο WhatsApp, Instagram και Messenger: απαντήστε στους πελάτες με το δικό σας AIΑπαντήστε στους πελάτες σε WhatsApp, Instagram και Messenger με το δικό σας AI: παράθυρα 24 ωρών, πρότυπα, μεταφορά σε άνθρωπο, τι να αυτοματοποιήσετε.Ανάρτηση σε Instagram, TikTok και Facebook από Python με ένα APIΔημοσιεύστε, διαβάστε σχόλια και απαντήστε σε DMs σε Instagram, Facebook, TikTok, YouTube και LinkedIn από Python, μέσω των επίσημων API κάθε δικτύου.Δημοσίευση στο Instagram, TikTok, Facebook, YouTube και LinkedIn με ένα APIΔημοσιεύστε και προγραμματίστε Instagram, Reels, Stories, βίντεο TikTok, αναρτήσεις σελίδων, YouTube και LinkedIn από Claude, ChatGPT ή κώδικα.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις