EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Publique automaticamente produtos novos da Nuvemshop e Tiendanube no Instagram, TikTok e Facebook

O evento product/created do webhook de um app da Nuvemshop ou Tiendanube pode publicar cada produto novo no Instagram, TikTok e Facebook pelo easyCoexistence: o n8n ou um script curto busca o produto, converte a foto principal para JPEG para o Instagram e envia texto, foto e link para a API de posts do easyCoexistence, que publica pela API oficial de cada rede, agora ou depois. O Claude publica produtos sob demanda com o conector próprio da Nuvemshop.

3 seconds

Quanto tempo a Nuvemshop espera por uma resposta 2XX ao webhook antes de repetir o envio, até 16 vezes em 48 horas.

store_id, event, id

Os campos que um webhook de produto da Nuvemshop traz, com carimbo de data e hora e sem detalhes do produto, por isso o produto é lido com GET /products/{id}.

x-linkedstore-hmac-sha256

O cabeçalho que guarda a assinatura HMAC-SHA256 de cada webhook, gerada com o client secret do app, e não com o access token da loja.

WebP

O formato em que a Nuvemshop pode servir as imagens de produto após a otimização, sem opção na API para desligar a conversão.

admin-mcp.nuvemshop.com.br

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

1080 × 1920

A maior imagem que uma publicação de foto no TikTok aceita, ou 1920 × 1080, em JPG ou WebP de até 20 MB.

Como um novo produto da Nuvemshop vira uma publicação?

Por meio de um app, um webhook e uma chamada por conta. Os webhooks da Nuvemshop pertencem a um app, então crie um com o escopo read_products, instale-o na sua loja e registre um webhook para product/created apontando para o seu fluxo no n8n ou para o seu servidor. A notificação traz o ID da loja, o evento e o ID do produto, sem detalhes, então o fluxo lê o produto com GET /products/{id}, verifica se ele está visível e se tem foto, e envia uma requisição por conta para a API de posts do easyCoexistence: uma publicação de foto para Instagram e TikTok, e uma publicação de link para o Facebook. O easyCoexistence publica cada uma pela API oficial da rede, na hora ou no publish_at que você 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 configurar o app da Nuvemshop e o webhook?

Uma vez, pelo Portal de Parceiros e um terminal. Cadastre-se como parceiro da Nuvemshop ou Tiendanube, crie um app em Apps com read_products, que também cobre imagens e variações de produtos, e instale-o na sua loja. O código de autorização enviado à sua URL de redirecionamento vale por 5 minutos e é trocado em https://www.tiendanube.com/apps/authorize/token por um access token e um user_id, o ID da loja; o token não expira até que você obtenha um novo para aquele app e loja ou até que o app seja desinstalado. Depois, registre o webhook com POST /webhooks. Cada requisição leva Authorization: Bearer com o token e um User-Agent com o nome do seu app e um contato, senão a Nuvemshop responde 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 o fluxo do n8n faz com cada produto?

Responde, verifica, lê, converte e publica. Um nó Webhook com Raw Body ativado e Respond definido como Immediately responde dentro dos 3 segundos exigidos pela Nuvemshop. Um nó Extract From File transforma o corpo em texto, um nó Crypto calcula o seu Hmac com SHA256 e HEX, usando o client secret do app como chave, e um nó If deixa a execução continuar somente quando o resultado é igual ao cabeçalho x-linkedstore-hmac-sha256.

Um nó HTTP Request então lê GET /products/{{ $json.id }} com o token da loja. Um nó If continua quando visibility é visible e images não está vazio, e um nó Remove Duplicates definido como Remove Items Processed in Previous Executions descarta um produto já publicado, já que a Nuvemshop pode enviar a mesma notificação duas vezes. Para o Instagram, um nó HTTP Request baixa a imagem principal como arquivo, um nó Edit Image a redimensiona com jpeg como Format, e um nó HTTP Request a envia como n8n Binary File para POST /api/v1/media, que retorna um media_id. Um nó HTTP Request por conta chama 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 um script publica produtos sem o n8n?

Com um pequeno endpoint web. O script em Python abaixo verifica a assinatura sobre o corpo bruto com o client secret do app, responde 200 imediatamente e faz o resto em segundo plano: lê o produto, pula 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, formato aceito por Instagram e TikTok. Envia esse arquivo para POST /media, publica no Instagram e no TikTok, e faz uma publicação de link 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 Claude e ChatGPT publicam produtos sob demanda?

Com o conector próprio da Nuvemshop ao lado do conector do easyCoexistence. A Central de Ajuda da Nuvemshop descreve um conector de IA construído sobre MCP que funciona com Claude, com ChatGPT pelos seus conectores e com editores como o Cursor; no Claude ele é adicionado como conector personalizado em https://admin-mcp.nuvemshop.com.br, e suas ferramentas de leitura consultam produtos, pedidos e clientes. Peça, por exemplo: "Publique nossos cinco produtos mais novos no TikTok a partir de amanhã às 10h, horário 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. Ele age quando é solicitado e não acompanha a loja entre as conversas, então produtos adicionados de madrugada saem pelo webhook.

O que cada rede aceita em uma publicação de produto?

As regras de cada rede, com as verificações próprias do easyCoexistence por cima, valem no envio ou no agendamento, então um produto que não pode sair é recusado na hora:

  • Instagram: somente imagens JPEG, então converta primeiro uma foto de produto em WebP ou PNG; várias fotos formam um carrossel. A publicação não tem campo de link, então o endereço do produto entra na legenda como texto.
  • TikTok: publicações de foto com 1 a 35 imagens JPG ou WebP, cada uma de até 1080 × 1920 ou 1920 × 1080 pixels e 20 MB, um título de 90 caracteres e 15 publicações de foto por conta por dia.
  • Facebook: uma publicação de link para o canonical_url do produto, com a prévia que o Facebook monta a partir das tags Open Graph da página, ou uma foto com o endereço no texto.
  • Mídia pelo easyCoexistence: um link HTTPS ou um media_id de POST /media, com imagens de até 30 MB, copiadas quando a publicação é agendada.
  • Legendas: o nome e a descrição da Nuvemshop são objetos indexados por idioma, como pt ou es, e a descrição é HTML, então escolha um idioma e remova as tags.

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 que as publicações saem. Ela espera 3 segundos por uma resposta 2XX e depois repete o envio, até 16 vezes em 48 horas, então responda primeiro e publique depois.
  • Enviar ao Instagram a foto do produto como a Nuvemshop a serve. A Nuvemshop pode entregar WebP independentemente da extensão do endereço, e o Instagram publica somente JPEG, então verifique o Content-Type do arquivo e converta.
  • Verificar a assinatura com o access token da loja. A Nuvemshop assina com o client secret do app, sobre o corpo bruto, então calcule o HMAC antes que o corpo seja interpretado.
  • Publicar o produto no instante em que ele é criado. Ele pode começar oculto ou sem fotos, então verifique visibility e images, escute também product/updated e publique cada produto uma única vez.
Fazendo isso com o EasyCoexistence

O easyCoexistence dá à sua loja, e aos agentes de IA que a operam, alcance até os clientes no Instagram, TikTok, Facebook e novos canais que chegam, cada um pela sua API oficial: uma API de posts e upload de mídia para n8n e seus scripts, um conector MCP para Claude e ChatGPT ao lado do da Nuvemshop, e uma fila que publica até 90 dias antes, com cada conexão monitorada 24/7. De US$ 9 até US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Funciona com lojas da Tiendanube?

Sim. Nuvemshop e Tiendanube compartilham uma só API: cada endereço tiendanube.com da documentação tem um equivalente idêntico em nuvemshop.com.br, e a API responde em api.tiendanube.com e em api.nuvemshop.com.br.

Dá para publicar um produto de novo quando ele entra em promoção?

Sim. Escute também product/updated e compare o promotional_price das variações com o último que você publicou; a notificação traz o ID do produto, não os detalhes, então leia o produto a cada vez.

O que o canal próprio de Instagram e Facebook da Nuvemshop faz?

Ele conecta o catálogo, o Pixel e a loja da Nuvemshop à Meta para vender no Instagram e no Facebook, como descreve a Central de Ajuda da Nuvemshop, a partir de Canais de venda no painel. Este fluxo publica uma publicação no feed para cada produto novo.

Quanto custa o easyCoexistence para publicar produtos da Nuvemshop?

De US$ 9 até US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, igual em cada rede. A API de posts, o upload de mídia e o conector MCP estão incluídos, com os primeiros 3 dias grátis.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em