登录开始免费试用
easyCoexistence 官方 API

自动把 Nuvemshop 和 Tiendanube 新商品发布到 Instagram、TikTok 和 Facebook

Nuvemshop 或 Tiendanube 应用的 product/created Webhook 可以通过 easyCoexistence 将每件新商品发布到 Instagram、TikTok 和 Facebook:n8n 或一段简短脚本获取商品,把主图转换为 JPEG 供 Instagram 使用,再将文字、图片和链接发送到 easyCoexistence 的 posts API。该 API 通过各网络的官方 API 发布,可立即发布,也可稍后发布。Claude 可借助 Nuvemshop 自有连接器,按需发布商品。

3 seconds

Nuvemshop 在重试前等待 Webhook 返回 2XX 响应的时长,48 小时内最多尝试 16 次。

store_id, event, id

Nuvemshop 商品 Webhook 携带的字段包含时间戳但不含商品详情,因此需通过 GET /products/{id} 读取商品。

x-linkedstore-hmac-sha256

保存每个 Webhook 的 HMAC-SHA256 签名的请求头,其密钥为应用的 client secret,而非店铺的访问令牌。

WebP

Nuvemshop 优化后可能提供的商品图片格式,API 中没有关闭该转换的选项。

admin-mcp.nuvemshop.com.br

Nuvemshop 帮助中心给出的地址,用于将其自有 MCP 连接器作为自定义连接器添加到 Claude。

1080 × 1920

TikTok 图文帖子可接受的最大图片尺寸为 1920 × 1080,格式为 JPG 或 WebP,最大 20 MB。

新商品如何变成帖子?

通过应用、Webhook 以及每个账户一次调用实现。Nuvemshop 的 Webhook 归属于应用,因此请使用 read_products 权限创建应用,在店铺中安装,并为 product/created 注册一个指向 n8n 工作流或服务器的 Webhook。通知包含店铺 ID、事件和商品 ID,但不含商品详情,因此工作流需通过 GET /products/{id} 读取商品,检查其是否可见且有图片,然后对每个账户向 easyCoexistence 的 posts API 发送一次请求:Instagram 和 TikTok 发布图文帖子,Facebook 发布链接帖子。easyCoexistence 通过各网络的官方 API 发布每条帖子,可立即发布,也可在您设置的 publish_at 时间发布。

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

如何设置 Nuvemshop 应用及其 Webhook?

只需一次,在 Partners Portal 和终端中完成。注册成为 Nuvemshop 或 Tiendanube 合作伙伴,在 Apps 下创建带有 read_products 权限的应用(该权限同时涵盖商品图片和变体),并在店铺中安装。发送到您重定向 URL 的授权码有效期为 5 分钟,需在 https://www.tiendanube.com/apps/authorize/token 兑换为访问令牌和 user_id(即店铺 ID)。该令牌在您为该应用和店铺获取新令牌或应用被卸载之前不会过期。然后使用 POST /webhooks 注册 Webhook。每个请求都需携带带有令牌的 Authorization: Bearer,以及标明应用名称和联系方式的 User-Agent,否则 Nuvemshop 将返回 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" }'

n8n 工作流如何处理每个商品?

依次完成应答、验证、读取、转换和发布。Webhook 节点开启 Raw Body 并将 Respond 设置为 Immediately,可在 Nuvemshop 的 3 秒时限内应答。Extract From File 节点将请求体转为文本,Crypto 节点以应用的 client secret 为密钥,使用 SHA256 和 HEX 计算其 Hmac,If 节点仅在结果与 x-linkedstore-hmac-sha256 请求头相等时才继续运行。

随后,HTTP Request 节点使用店铺令牌读取 GET /products/{{ $json.id }}。If 节点在 visibility 为 visible 且 images 不为空时继续运行;Remove Duplicates 节点设置为 Remove Items Processed in Previous Executions,会丢弃已发布过的商品,因为 Nuvemshop 可能重复发送同一通知。对于 Instagram,HTTP Request 节点将主图下载为文件,Edit Image 节点以 jpeg 作为 Format 调整尺寸,再由 HTTP Request 节点将其作为 n8n Binary File 发送到 POST /api/v1/media,该接口返回 media_id。每个账户对应一个 HTTP Request 节点,调用 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

脚本如何在不使用 n8n 的情况下发布商品?

借助一个小型 Web 端点。下面的 Python 代码使用应用的 client secret 对原始请求体校验签名,立即返回 200,其余工作在后台完成:读取商品,跳过不可见或没有图片的商品,并使用 Pillow 将主图转换为最长边不超过 1080 像素的 JPEG,这种格式 Instagram 和 TikTok 都支持。它将该文件上传到 POST /media,发布到 Instagram 和 TikTok,并在 Facebook 上发布链接帖子。每次调用都携带一个由商品和账户组成的 Idempotency-Key,easyCoexistence 会予以遵循;另外,一组已发布的 ID 可防止重复通知导致同一商品发布两次。

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

Claude 和 ChatGPT 如何按需发布商品?

借助 Nuvemshop 自有连接器,并与 easyCoexistence 的连接器并用。Nuvemshop 帮助中心介绍了一个基于 MCP 构建的 AI 连接器,可用于 Claude,通过其连接器用于 ChatGPT,并可用于 Cursor 等编辑器;在 Claude 中,需将 https://admin-mcp.nuvemshop.com.br 添加为自定义连接器,其读取工具可查询商品、订单和客户。例如,您可以这样提问:“从明天上午 10 点(圣保罗时间)起,将我们最新的五件商品发布到 TikTok,每小时一条,并为每件配上文案。”助手会读取商品、撰写文案,并使用 scheduled_at 为每条帖子设定时间。它仅在您提出请求时行动,不会在两次对话之间监控店铺,因此夜间新增的商品将通过 Webhook 发布。

每个网络接受什么样的商品帖子?

每个网络的规则,连同 easyCoexistence 自身的检查,会在帖子发送或排期时生效,因此无法发布的商品会被立即拒绝:

  • Instagram:仅接受 JPEG 图片,因此请先将 WebP 或 PNG 格式的商品图片转换;多张图片将组成轮播。帖子没有链接字段,因此商品地址需以文字形式放入文案中。
  • TikTok:图文帖子可包含 1 至 35 张 JPG 或 WebP 图片,每张最大 1080 × 1920 或 1920 × 1080 像素、20 MB,标题 90 个字符以内,每个账户每天最多 15 条图文帖子。
  • Facebook:链接帖子指向商品的 canonical_url,预览内容由 Facebook 根据页面的 Open Graph 标签生成;或发布一张图片,并将地址写入文字中。
  • 通过 easyCoexistence 上传的媒体:可使用 HTTPS 链接或来自 POST /media 的 media_id,图片最大 30 MB,在排期时会被复制。
  • 文案:Nuvemshop 的名称和描述是以语言为键的对象,例如 pt 或 es,且描述为 HTML,因此请选择一种语言并去除标签。

设置方法

  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.

常见错误

  • 在帖子发出后才回复 Nuvemshop。它会等待 3 秒以获取 2XX 响应,否则会在 48 小时内最多重试 16 次,因此应先回复,再发布。
  • 把 Nuvemshop 提供的商品图片原样发送给 Instagram。无论地址以什么结尾,Nuvemshop 都可能提供 WebP 格式,而 Instagram 只接受 JPEG 发布,因此请检查文件的 Content-Type 并进行转换。
  • 用店铺的访问令牌验证签名。Nuvemshop 使用应用的 client secret 对原始请求体签名,因此应在解析请求体之前计算 HMAC。
  • 商品一创建就立即发布。新商品可能处于隐藏状态或尚无图片,因此请检查 visibility 和 images,同时监听 product/updated,并确保每个商品只发布一次。
使用 EasyCoexistence 完成这些操作

easyCoexistence 为您的店铺以及运行店铺的 AI 代理提供触达客户的能力,覆盖 Instagram、TikTok、Facebook 及更多渠道,每个渠道均通过其官方 API 连接:为 n8n 和您的脚本提供 posts API 与媒体上传,为 Claude 和 ChatGPT 提供可与 Nuvemshop 自有连接器并用的 MCP 连接器,并提供可提前 90 天排队的发布队列,所有连接均全天候 24/7 监控。每个连接每月 US$ 9 至 US$ 0.75,连接越多越便宜,前 3 天免费。

常见问题

它支持 Tiendanube 店铺吗?

支持。Nuvemshop 与 Tiendanube 共用一套 API:文档中每个 tiendanube.com 地址在 nuvemshop.com.br 上都有完全相同的对应地址,API 同时在 api.tiendanube.com 和 api.nuvemshop.com.br 上响应。

商品打折后能否再次发布?

可以。同时监听 product/updated,并将变体的 promotional_price 与您上次发布时的价格进行比较;通知只包含商品 ID,不含商品详情,因此每次都需读取商品。

Nuvemshop 自有的 Instagram 和 Facebook 渠道是做什么的?

正如 Nuvemshop 帮助中心所述,该渠道可在后台的“Canais de venda”(销售渠道)中将店铺的目录、Pixel 和店铺连接到 Meta,以便在 Instagram 和 Facebook 上销售。本流程则为每件新商品发布一条动态帖子。

用 easyCoexistence 发布 Nuvemshop 商品每月要花多少钱?

每个连接每月 US$ 9 至 US$ 0.75,连接越多越便宜,每个网络的价格相同。posts API、媒体上传和 MCP 连接器均包含在内,前 3 天免费。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间