Publier automatiquement les nouveaux produits Nuvemshop et Tiendanube sur Instagram, TikTok et Facebook
Le webhook product/created d'une application Nuvemshop ou Tiendanube peut publier chaque nouveau produit sur Instagram, TikTok et Facebook via easyCoexistence : n8n ou un court script récupère le produit, convertit sa photo principale en JPEG pour Instagram et envoie le texte, la photo et le lien à l'API des publications d'easyCoexistence, qui publie via l'API officielle de chaque réseau, immédiatement ou plus tard. Claude publie des produits sur demande grâce au connecteur propre à Nuvemshop.
Délai que Nuvemshop attend une réponse 2XX à un webhook avant de réessayer, jusqu'à 16 tentatives sur 48 heures.
Les champs qu'un webhook produit de Nuvemshop transmet, avec un horodatage et sans détails du produit, si bien que le produit se lit avec GET /products/{id}.
L'en-tête qui contient la signature HMAC-SHA256 de chaque webhook, calculée avec le client secret de l'application et non avec le token d'accès de la boutique.
Le format dans lequel Nuvemshop peut servir les images produit après optimisation, sans option API pour désactiver la conversion.
L'adresse que le Centre d'aide de Nuvemshop indique pour ajouter son propre connecteur MCP à Claude en tant que connecteur personnalisé.
La plus grande image d'une publication photo TikTok, soit 1920 × 1080, en JPG ou WebP d'au plus 20 Mo.
Comment un nouveau produit Nuvemshop devient-il une publication ?
Par une application, un webhook et un appel par compte. Les webhooks de Nuvemshop appartiennent à une application : créez-en une avec la portée read_products, installez-la dans votre boutique et enregistrez un webhook pour product/created pointant vers votre workflow n8n ou votre serveur. La notification contient l'identifiant de la boutique, l'événement et l'identifiant du produit, sans détails. Le workflow lit donc le produit avec GET /products/{id}, vérifie qu'il est visible et qu'il a une photo, puis envoie une requête par compte à l'API des publications d'easyCoexistence : une publication photo pour Instagram et TikTok, une publication avec lien pour Facebook. easyCoexistence publie chacune via l'API officielle du réseau, tout de suite ou à la date publish_at que vous définissez.
Comment configurer l'application Nuvemshop et son webhook ?
Une seule fois, depuis le portail partenaires et un terminal. Inscrivez-vous comme partenaire Nuvemshop ou Tiendanube, créez une application dans la section Apps avec read_products, qui couvre aussi les images et les variantes des produits, puis installez-la dans votre boutique. Le code d'autorisation envoyé à votre URL de redirection expire au bout de 5 minutes ; il s'échange à https://www.tiendanube.com/apps/authorize/token contre un token d'accès et un user_id, l'identifiant de la boutique. Le token n'expire pas tant que vous n'en obtenez pas un nouveau pour cette application et cette boutique, ou que l'application n'est pas désinstallée. Enregistrez ensuite le webhook avec POST /webhooks. Chaque requête porte Authorization : Bearer avec le token, ainsi qu'un User-Agent qui nomme votre application et un contact, faute de quoi Nuvemshop répond 400.
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" }'Que fait le workflow n8n avec chaque produit ?
Il répond, vérifie, lit, convertit et publie. Un nœud Webhook avec Corps brut activé et Répondre réglé sur Immédiatement répond dans les 3 secondes accordées par Nuvemshop. Un nœud Extraire depuis un fichier transforme le corps en texte, un nœud Crypto calcule son HMAC en SHA256 et en HEX avec le client secret de l'application, et un nœud Si ne laisse l'exécution se poursuivre que si le résultat est égal à l'en-tête x-linkedstore-hmac-sha256.
Un nœud Requête HTTP lit ensuite GET /products/{{ $json.id }} avec le token de la boutique. Un nœud Si continue lorsque visibility vaut visible et que images n'est pas vide, et un nœud Supprimer les doublons réglé sur Supprimer les éléments traités lors des exécutions précédentes écarte un produit déjà publié, car Nuvemshop peut envoyer deux fois la même notification. Pour Instagram, un nœud Requête HTTP télécharge l'image principale en tant que fichier, un nœud Modifier une image la redimensionne avec jpeg comme Format, puis un nœud Requête HTTP l'envoie sous forme de Fichier binaire n8n vers POST /api/v1/media, qui renvoie un media_id. Une Requête HTTP par compte appelle enfin POST /api/v1/channels/<account_id>/posts.
Comment un script publie-t-il des produits sans n8n ?
Avec un petit endpoint web. Le script Python ci-dessous vérifie la signature sur le corps brut avec le client secret de l'application, répond 200 immédiatement et fait le reste en arrière-plan : il lit le produit, ignore celui qui n'est pas visible ou n'a pas de photo, et convertit la photo principale avec Pillow en JPEG d'au plus 1080 pixels de côté, format accepté par Instagram comme par TikTok. Il téléverse ce fichier vers POST /media, le publie sur Instagram et TikTok, puis fait une publication avec lien sur Facebook. Chaque appel porte un Idempotency-Key construit à partir du produit et du compte, que easyCoexistence respecte, et un ensemble d'identifiants déjà publiés empêche qu'une notification répétée publie deux fois.
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}"})Comment Claude et ChatGPT publient-ils des produits sur demande ?
Avec le connecteur propre à Nuvemshop, à côté de celui d'easyCoexistence. Le Centre d'aide de Nuvemshop décrit un connecteur IA construit sur MCP, qui fonctionne avec Claude, avec ChatGPT via ses connecteurs et avec des éditeurs comme Cursor. Dans Claude, on l'ajoute comme connecteur personnalisé à l'adresse https://admin-mcp.nuvemshop.com.br, et ses outils de lecture consultent les produits, les commandes et les clients. Demandez par exemple : « Publie nos cinq derniers produits sur TikTok à partir de demain 10 h, heure de São Paulo, un par heure, avec une légende pour chacun. » L'assistant lit les produits, rédige les légendes et programme chaque publication avec scheduled_at. Il n'agit que lorsqu'on le lui demande et ne surveille pas la boutique entre deux conversations ; les produits ajoutés pendant la nuit partent donc par le webhook.
Que accepte chaque réseau dans une publication produit ?
Les règles de chaque réseau, auxquelles s'ajoutent les contrôles propres à easyCoexistence, s'appliquent à l'envoi ou à la programmation. Un produit qui ne peut pas partir est donc refusé immédiatement :
- Instagram : images JPEG uniquement, donc convertissez d'abord une photo produit en WebP ou PNG ; plusieurs photos forment un carrousel. Une publication n'a pas de champ lien : l'adresse du produit va donc dans la légende, en texte.
- TikTok : publications photo de 1 à 35 images JPG ou WebP, chacune de 1080 × 1920 ou 1920 × 1080 pixels au plus et 20 Mo, un titre de 90 caractères, et 15 publications photo par compte et par jour.
- Facebook : une publication avec lien vers le
canonical_urldu produit, avec l'aperçu que Facebook construit à partir des balises Open Graph de la page, ou une photo avec l'adresse dans le texte. - Médias via easyCoexistence : un lien HTTPS ou un
media_idissu de POST /media, avec des images jusqu'à 30 Mo, copiées au moment de la programmation. - Légendes : le nom et la description d'un produit Nuvemshop sont des objets indexés par langue, comme pt ou es, et la description est en HTML ; choisissez donc une langue et retirez les balises.
Comment le configurer
- 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.
- 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.
- 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.
Erreurs courantes
- Répondre à Nuvemshop après l'envoi des publications. Nuvemshop attend 3 secondes une réponse 2XX, puis réessaie jusqu'à 16 fois sur 48 heures ; répondez donc d'abord, et publiez ensuite.
- Envoyer à Instagram la photo produit telle que Nuvemshop la sert. Nuvemshop peut livrer du WebP quelle que soit l'extension de l'adresse, et Instagram ne publie qu'en JPEG ; vérifiez donc le Content-Type du fichier et convertissez-le.
- Vérifier la signature avec le token d'accès de la boutique. Nuvemshop signe avec le client secret de l'application, sur le corps brut ; calculez donc le HMAC avant que le corps ne soit analysé.
- Publier un produit dès sa création. Il peut être créé masqué ou sans photos ; vérifiez donc la visibilité et les images, écoutez aussi product/updated, et publiez chaque produit une seule fois.
easyCoexistence offre à votre boutique, et aux agents IA qui la pilotent, la possibilité de joindre vos clients sur Instagram, TikTok, Facebook et d'autres canaux, chacun via son API officielle : une API de publications et de téléversement de médias pour n8n et vos scripts, un connecteur MCP pour Claude et ChatGPT à côté de celui de Nuvemshop, et une file d'attente qui publie jusqu'à 90 jours à l'avance, avec chaque connexion surveillée 24 h/24 et 7 j/7. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.
Questions fréquemment posées
Est-ce compatible avec les boutiques Tiendanube ?
Oui. Nuvemshop et Tiendanube partagent une seule API : chaque adresse tiendanube.com de la documentation a son équivalent identique sur nuvemshop.com.br, et l'API répond à la fois sur api.tiendanube.com et sur api.nuvemshop.com.br.
Peut-on republier un produit lorsqu'il passe en promotion ?
Oui. Écoutez aussi product/updated et comparez le promotional_price des variantes avec celui que vous avez publié en dernier ; la notification porte l'identifiant du produit, pas ses détails, donc lisez le produit à chaque fois.
Que fait le canal natif Instagram et Facebook de Nuvemshop ?
Il relie le catalogue, le Pixel et la boutique en ligne à Meta pour vendre sur Instagram et Facebook, comme le décrit le Centre d'aide de Nuvemshop, depuis « Canais de venda » dans l'administration. Ce flux publie une publication dans le fil pour chaque nouveau produit.
Combien coûte easyCoexistence pour publier des produits Nuvemshop ?
De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, identique sur chaque réseau. L'API des publications, le téléversement de médias et le connecteur MCP sont inclus, avec 3 jours d'essai gratuit.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le