Publica automáticamente los productos nuevos de Nuvemshop y Tiendanube en Instagram, TikTok y Facebook
El webhook product/created de una app de Nuvemshop o Tiendanube puede publicar cada producto nuevo en Instagram, TikTok y Facebook a través de easyCoexistence: n8n o un script corto obtiene el producto, convierte su foto principal a JPEG para Instagram y envía texto, foto y enlace a la API de publicaciones de easyCoexistence, que publica mediante la API oficial de cada red, al momento o más adelante. Claude publica productos a pedido con el conector propio de Nuvemshop.
Cuánto espera Nuvemshop una respuesta 2XX a un webhook antes de reintentar, hasta 16 intentos en 48 horas.
Los campos que trae un webhook de producto de Nuvemshop, con una marca de tiempo y sin detalles del producto, por lo que el producto se lee con GET /products/{id}.
El encabezado que contiene la firma HMAC-SHA256 de cada webhook, calculada con el client secret de la app y no con el access token de la tienda.
El formato en que Nuvemshop puede servir las imágenes de producto tras la optimización, sin opción de API para desactivar la conversión.
La dirección que el Centro de Ayuda de Nuvemshop indica para añadir su propio conector MCP a Claude como conector personalizado.
La imagen más grande que acepta una publicación de fotos en TikTok, de 1920 × 1080, en JPG o WebP de hasta 20 MB.
¿Cómo se convierte un producto nuevo de Nuvemshop en una publicación?
Mediante una app, un webhook y una llamada por cuenta. Los webhooks de Nuvemshop pertenecen a una app, así que crea una con el scope read_products, instálala en tu tienda y registra un webhook para product/created que apunte a tu flujo de n8n o a tu servidor. La notificación incluye el ID de la tienda, el evento y el ID del producto, sin detalles del producto, así que el flujo lee el producto con GET /products/{id}, comprueba que esté visible y que tenga foto, y envía una petición por cuenta a la API de publicaciones de easyCoexistence: una publicación de foto para Instagram y TikTok, y una publicación con enlace para Facebook. easyCoexistence publica cada una a través de la API oficial de la red, al momento o en el publish_at que hayas definido.
¿Cómo se configura la app de Nuvemshop y su webhook?
Una vez, desde el Partners Portal y una terminal. Regístrate como partner de Nuvemshop o Tiendanube, crea una app en Apps con read_products, que también cubre las imágenes de producto y las variantes, e instálala en tu tienda. El código de autorización enviado a tu URL de redirección dura 5 minutos y se cambia en https://www.tiendanube.com/apps/authorize/token por un access token y un user_id, el ID de la tienda; el token no caduca hasta que obtengas uno nuevo para esa app y tienda, o hasta que la app se desinstale. Después registra el webhook con POST /webhooks. Cada petición lleva Authorization: Bearer con el token y un User-Agent que indique el nombre de tu app y un contacto, o Nuvemshop responde 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" }'¿Qué hace el flujo de n8n con cada producto?
Responde, verifica, lee, convierte y publica. Un nodo Webhook con Raw Body activado y Respond configurado en Immediately responde dentro de los 3 segundos de Nuvemshop. Un nodo Extract From File convierte el cuerpo en texto, un nodo Crypto calcula su Hmac con SHA256 y HEX, usando el client secret de la app, y un nodo If deja continuar la ejecución solo si el resultado es igual al encabezado x-linkedstore-hmac-sha256.
Un nodo HTTP Request lee después GET /products/{{ $json.id }} con el token de la tienda. Un nodo If continúa cuando visibility es visible e images no está vacío, y un nodo Remove Duplicates configurado en Remove Items Processed in Previous Executions descarta un producto ya publicado, ya que Nuvemshop puede enviar la misma notificación dos veces. Para Instagram, un nodo HTTP Request descarga la imagen principal como archivo, un nodo Edit Image la redimensiona con jpeg como Format, y un nodo HTTP Request la envía como Binary File de n8n a POST /api/v1/media, que devuelve un media_id. Un HTTP Request por cuenta llama después a POST /api/v1/channels/<account_id>/posts.
¿Cómo publica un script los productos sin n8n?
Con un pequeño endpoint web. El script de Python de abajo verifica la firma contra el cuerpo sin procesar con el client secret de la app, responde 200 de inmediato y hace el resto en segundo plano: lee el producto, omite el que no esté visible o no tenga foto, y convierte la foto principal con Pillow a un JPEG de hasta 1080 píxeles por lado, que aceptan tanto Instagram como TikTok. Sube ese archivo a POST /media, lo publica en Instagram y TikTok, y hace una publicación con enlace en Facebook. Cada llamada lleva un Idempotency-Key formado por el producto y la cuenta, que easyCoexistence respeta, y un conjunto de IDs publicados evita que una notificación repetida publique dos veces.
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}"})¿Cómo publican productos Claude y ChatGPT bajo pedido?
Con el conector propio de Nuvemshop, junto al de easyCoexistence. El Centro de Ayuda de Nuvemshop describe un conector de IA basado en MCP que funciona con Claude, con ChatGPT a través de sus conectores y con editores como Cursor; en Claude se añade como conector personalizado en https://admin-mcp.nuvemshop.com.br, y sus herramientas de lectura consultan productos, pedidos y clientes. Pide, por ejemplo: "Publica nuestros cinco productos más nuevos en TikTok desde mañana a las 10:00 hora de São Paulo, uno por hora, con un texto para cada uno." El asistente lee los productos, redacta los textos y programa cada publicación con scheduled_at. Actúa cuando se le pide y no vigila la tienda entre conversaciones, así que los productos añadidos de noche salen por el webhook.
¿Qué acepta cada red en una publicación de producto?
Las reglas de cada red, con las comprobaciones propias de easyCoexistence encima, se aplican cuando la publicación se envía o se programa, así que un producto que no pueda salir se rechaza en el acto:
- Instagram: solo imágenes JPEG, así que convierte primero una foto de producto en WebP o PNG; varias fotos forman un carrusel. Una publicación no tiene campo de enlace, por eso la dirección del producto va en el texto, escrita como texto normal.
- TikTok: publicaciones de fotos de 1 a 35 imágenes JPG o WebP, cada una de hasta 1080 × 1920 o 1920 × 1080 píxeles y 20 MB, un título de 90 caracteres y 15 publicaciones de foto por cuenta al día.
- Facebook: una publicación con enlace a
canonical_urldel producto, con la vista previa que Facebook construye a partir de las etiquetas Open Graph de la página, o una foto con la dirección en el texto. - Medios a través de easyCoexistence: un enlace HTTPS o un
media_idde POST /media, con imágenes de hasta 30 MB, que se copian cuando la publicación se programa. - Textos: el nombre y la descripción de Nuvemshop son objetos indexados por idioma, como pt o es, y la descripción es HTML, así que elige un idioma y quita las etiquetas.
Cómo configurarlo
- 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.
Errores comunes
- Responder a Nuvemshop después de publicar. Espera 3 segundos a un 2XX y luego reintenta, hasta 16 veces en 48 horas, así que responde primero y publica después.
- Enviar a Instagram la foto del producto tal como la sirve Nuvemshop. Nuvemshop puede entregar WebP sea cual sea la extensión de la dirección, y Instagram solo publica JPEG, así que revisa el Content-Type del archivo y conviértelo.
- Verificar la firma con el access token de la tienda. Nuvemshop firma con el client secret de la app, sobre el cuerpo sin procesar, así que calcula el HMAC antes de que el cuerpo se analice.
- Publicar un producto en cuanto se crea. Puede empezar oculto o sin fotos, así que comprueba visibility e images, escucha también product/updated y publica cada producto una sola vez.
easyCoexistence da a tu tienda, y a los agentes de IA que la gestionan, alcance hacia clientes en Instagram, TikTok, Facebook y más canales, cada uno a través de su API oficial: una API de publicaciones y subida de medios para n8n y tus scripts, un conector MCP para Claude y ChatGPT junto al de Nuvemshop, y una cola que publica hasta 90 días por adelantado, con cada conexión supervisada 24/7. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Funciona con tiendas de Tiendanube?
Sí. Nuvemshop y Tiendanube comparten una sola API: cada dirección tiendanube.com de la documentación tiene una idéntica en nuvemshop.com.br, y la API responde tanto en api.tiendanube.com como en api.nuvemshop.com.br.
¿Puede publicar un producto de nuevo cuando entra en oferta?
Sí. Escucha también product/updated y compara los promotional_price de las variantes con el que publicaste por última vez; la notificación trae el ID del producto, no sus detalles, así que lee el producto cada vez.
¿Qué hace el canal propio de Instagram y Facebook de Nuvemshop?
Conecta el catálogo, el Pixel y la Shop de la tienda con Meta para vender en Instagram y Facebook, como describe el Centro de Ayuda de Nuvemshop, desde Canales de venta en el admin. Este flujo publica una publicación en el feed por cada producto nuevo.
¿Cuánto cuesta easyCoexistence para publicar productos de Nuvemshop?
De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, igual en cada red. La API de publicaciones, la subida de medios y el conector MCP están incluidos, con los primeros 3 días gratis.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el