Publicar automaticamente novos produtos Nuvemshop e Tiendanube no Instagram, TikTok e Facebook
Um webhook de product/created de uma app Nuvemshop ou Tiendanube pode publicar cada produto novo no Instagram, TikTok e Facebook através do easyCoexistence: o n8n ou um script curto obtém o produto, converte a foto principal para JPEG para o Instagram e envia o texto, a foto e a ligação para a API de publicações do easyCoexistence, que publica através da API oficial de cada rede, agora ou mais tarde. O Claude publica produtos a pedido com o conector próprio da Nuvemshop.
Tempo que a Nuvemshop espera por uma resposta 2XX a um webhook antes de repetir, até 16 tentativas em 48 horas.
Os campos que um webhook de produto da Nuvemshop transporta, com carimbo de data e hora e sem detalhes do produto, pelo que o produto é lido com GET /products/{id}.
O cabeçalho que contém a assinatura HMAC-SHA256 de cada webhook, calculada com o client secret da app e não com o token de acesso da loja.
O formato em que a Nuvemshop pode servir as imagens de produto após otimização, sem opção na API para desativar a conversão.
O endereço que o Centro de Ajuda da Nuvemshop indica para adicionar o seu próprio conector MCP ao Claude como conector personalizado.
A maior imagem que uma publicação de fotos no TikTok aceita é 1920 × 1080, em JPG ou WebP, até 20 MB.
Como é que um novo produto da Nuvemshop se torna uma publicação?
Através de uma app, de um webhook e de um pedido por conta. Os webhooks da Nuvemshop pertencem a uma app, por isso crie uma com o âmbito read_products, instale-a na sua loja e registe um webhook para product/created que aponte para o seu fluxo de trabalho no n8n ou para o seu servidor. A notificação contém o ID da loja, o evento e o ID do produto, sem detalhes do produto, pelo que o fluxo lê o produto com GET /products/{id}, verifica se está visível e tem foto, e envia um pedido por conta à API de publicações do easyCoexistence: uma publicação com foto para o Instagram e o TikTok, e uma publicação com ligação para o Facebook. O easyCoexistence publica cada uma através da API oficial da rede, de imediato ou no publish_at que definir.
Como é que se configura a app da Nuvemshop e o seu webhook?
Uma vez, a partir do Partners Portal e de um terminal. Registe-se como parceiro da Nuvemshop ou da Tiendanube, crie uma app em Apps com read_products, que também cobre as imagens e variantes dos produtos, e instale-a na sua loja. O código de autorização enviado para o seu URL de redirecionamento dura 5 minutos e é trocado em https://www.tiendanube.com/apps/authorize/token por um token de acesso e um user_id, o ID da loja; o token não expira até obter um novo para essa app e loja ou até a app ser desinstalada. Depois registe o webhook com POST /webhooks. Cada pedido leva Authorization: Bearer com o token e um User-Agent com o nome da sua app e um contacto, ou a Nuvemshop responde com 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" }'O que faz o fluxo do n8n com cada produto?
Responder, verificar, ler, converter e publicar. Um nó Webhook com Raw Body ativado e Respond definido para Immediately responde dentro dos 3 segundos da Nuvemshop. Um nó Extract From File transforma o corpo em texto, um nó Crypto calcula o seu Hmac com SHA256 e HEX, com a chave client secret da app, e um nó If deixa a execução continuar só quando o resultado é igual ao cabeçalho x-linkedstore-hmac-sha256.
Um nó HTTP Request lê depois GET /products/{{ $json.id }} com o token da loja. Um nó If avança quando a visibilidade é visible e images não está vazio, e um nó Remove Duplicates definido para Remove Items Processed in Previous Executions elimina um produto já publicado, já que a Nuvemshop pode enviar a mesma notificação duas vezes. Para o Instagram, um nó HTTP Request transfere a imagem principal como ficheiro, um nó Edit Image redimensiona-a com jpeg como Format, e um nó HTTP Request envia-a como Binary File do n8n para POST /api/v1/media, que devolve um media_id. Um nó HTTP Request por conta chama depois POST /api/v1/channels/<account_id>/posts.
Como é que um script publica produtos sem o n8n?
Com um pequeno endpoint web. O Python abaixo verifica a assinatura contra o corpo bruto com o client secret da app, responde 200 de imediato e faz o restante em segundo plano: lê o produto, ignora um que não esteja visível ou não tenha foto, e converte a foto principal com Pillow para um JPEG de no máximo 1080 pixels por lado, que tanto o Instagram como o TikTok aceitam. Envia esse ficheiro para POST /media, publica-o no Instagram e no TikTok, e faz uma publicação com ligação no Facebook. Cada chamada leva um Idempotency-Key formado pelo produto e pela conta, que o easyCoexistence respeita, e um conjunto de IDs já publicados impede que uma notificação repetida publique duas vezes.
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}"})Como é que o Claude e o ChatGPT publicam produtos a pedido?
Com o conector próprio da Nuvemshop, ao lado do conector do easyCoexistence. O Centro de Ajuda da Nuvemshop descreve um conector de IA construído sobre MCP que funciona com o Claude, com o ChatGPT através dos seus conectores e com editores como o Cursor. No Claude, adiciona-se como conector personalizado em https://admin-mcp.nuvemshop.com.br, e as suas ferramentas de leitura consultam produtos, encomendas e clientes. Peça, por exemplo: "Publique os nossos cinco produtos mais recentes no TikTok a partir de amanhã às 10h, hora de São Paulo, um por hora, com uma legenda para cada um." O assistente lê os produtos, escreve as legendas e agenda cada publicação com scheduled_at. Atua quando lhe é pedido e não vigia a loja entre conversas, pelo que os produtos acrescentados durante a noite saem pelo webhook.
O que aceita cada rede numa publicação de produto?
As regras de cada rede, com as verificações próprias do easyCoexistence por cima, aplicam-se quando a publicação é enviada ou agendada, pelo que um produto que não pode sair é recusado de imediato:
- Instagram: apenas imagens JPEG, por isso converta primeiro uma foto de produto em WebP ou PNG; várias fotos formam um carrossel. Uma publicação não tem campo de ligação, pelo que o endereço do produto vai na legenda como texto.
- TikTok: publicações de fotos com 1 a 35 imagens JPG ou WebP, cada uma até 1080 × 1920 ou 1920 × 1080 pixels e 20 MB, um título de 90 caracteres e 15 publicações de fotos por conta por dia.
- Facebook: uma publicação com ligação para o
canonical_urldo produto, com a pré-visualização que o Facebook gera a partir das tags Open Graph da página, ou uma foto com o endereço no texto. - Multimédia através do easyCoexistence: uma ligação HTTPS ou um
media_idde POST /media, com imagens até 30 MB, copiadas quando a publicação é agendada. - Legendas: o nome e a descrição da Nuvemshop são objetos com chave por idioma, como pt ou es, e a descrição é HTML, por isso escolha um idioma e retire as etiquetas.
Como configurar
- 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.
Erros comuns
- Responder à Nuvemshop depois de as publicações serem enviadas. Ela espera 3 segundos por uma resposta 2XX e depois repete, até 16 vezes em 48 horas, por isso responda primeiro e publique depois.
- Enviar ao Instagram a foto do produto tal como a Nuvemshop a serve. A Nuvemshop pode entregar WebP seja qual for a extensão do endereço, e o Instagram publica apenas JPEG, por isso verifique o Content-Type do ficheiro e converta-o.
- Verificar a assinatura com o token de acesso da loja. A Nuvemshop assina com o client secret da app, sobre o corpo bruto, por isso calcule o HMAC antes de o corpo ser analisado.
- Publicar um produto no momento em que é criado. Pode começar oculto ou sem fotos, por isso verifique a visibilidade e as imagens, escute também product/updated e publique cada produto uma só vez.
O easyCoexistence dá à sua loja, e aos agentes de IA que a gerem, alcance junto dos clientes no Instagram, TikTok, Facebook e mais canais, cada um através da sua API oficial: uma API de publicações e upload de multimédia para o n8n e os seus scripts, um conector MCP para o Claude e o ChatGPT ao lado do da Nuvemshop, e uma fila que publica até 90 dias à frente, com cada ligação monitorizada 24/7. De US$ 9 a US$ 0.75 por ligação por mês, que desce à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Funciona com lojas Tiendanube?
Sim. A Nuvemshop e a Tiendanube partilham uma só API: cada endereço tiendanube.com nos documentos tem um idêntico em nuvemshop.com.br, e a API responde tanto em api.tiendanube.com como em api.nuvemshop.com.br.
Pode publicar um produto outra vez quando entra em promoção?
Sim. Escute também product/updated e compare o promotional_price das variantes com o que publicou da última vez; a notificação traz o ID do produto, não os seus detalhes, por isso leia o produto de cada vez.
O que faz o canal próprio da Nuvemshop para Instagram e Facebook?
Liga o catálogo da loja, o Pixel e a sua loja online à Meta para vender no Instagram e no Facebook, como descreve o Centro de Ajuda da Nuvemshop, a partir de Canais de venda no painel de administração. Este fluxo publica uma publicação no feed por cada produto novo.
Quanto custa o easyCoexistence para publicar produtos da Nuvemshop?
De US$ 9 a US$ 0.75 por ligação por mês, que desce à medida que acrescenta ligações, igual em cada rede. A API de publicações, o upload de multimédia e o conector MCP estão incluídos, com os primeiros 3 dias grátis.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em