Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

3 seconds

Tempo que a Nuvemshop espera por uma resposta 2XX a um webhook antes de repetir, até 16 tentativas em 48 horas.

store_id, event, id

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}.

x-linkedstore-hmac-sha256

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.

WebP

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.

admin-mcp.nuvemshop.com.br

O endereço que o Centro de Ajuda da Nuvemshop indica para adicionar o seu próprio conector MCP ao Claude como conector personalizado.

1080 × 1920

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.

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

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.

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

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.

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

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.

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

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_url do 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_id de 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

  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.

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.
Fazer isto com a EasyCoexistence

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