Nuvemshop と Tiendanube の新商品を Instagram、TikTok、Facebook へ自動投稿
Nuvemshop または Tiendanube のアプリが持つ product/created の Webhook は、新商品ごとに easyCoexistence を通じて Instagram、TikTok、Facebook への投稿を可能にします。n8n または短いスクリプトが商品を取得し、メインの写真を Instagram 向けに JPEG へ変換したうえで、テキスト、写真、リンクを easyCoexistence の posts API に送信します。posts API は、各ネットワークの公式 API を通じて、すぐに、または後から公開します。Claude は依頼に応じて、Nuvemshop 独自のコネクタを使って商品を投稿します。
Nuvemshop が Webhook の 2XX 応答を待つ時間です。再送は 48 時間以内に最大 16 回まで行われます。
商品の Webhook が送るフィールドにはタイムスタンプが含まれ、商品の詳細は含まれません。そのため、GET /products/{id} で商品を読み取ります。
各 Webhook の HMAC-SHA256 署名を格納するヘッダーです。署名の鍵はストアのアクセストークンではなく、アプリのクライアントシークレットです。
最適化後に Nuvemshop が商品画像を配信することがある形式です。この変換を止める API オプションはありません。
Nuvemshop のヘルプセンターが、自社の MCP コネクタを Claude にカスタムコネクタとして追加する際のアドレスとして示しているものです。
TikTok の写真投稿で扱える最大画像は、JPG または WebP 形式で最大 20 MB、1920 × 1080 です。
新しい Nuvemshop の商品は、どのように投稿になりますか?
アプリと Webhook を使い、アカウントごとに 1 回呼び出します。Nuvemshop の Webhook はアプリに紐づくため、read_products スコープを付けてアプリを作成し、ストアにインストールします。そのうえで、product/created の Webhook を登録し、送り先を n8n のワークフローまたはサーバーに設定します。通知にはストア ID、イベント、商品の ID が含まれ、商品の詳細は含まれません。そのためワークフローは GET /products/{id} で商品を読み取り、表示状態が visible で写真があることを確認したうえで、アカウントごとに 1 回ずつ easyCoexistence の posts API へリクエストを送ります。Instagram と TikTok には写真投稿、Facebook にはリンク投稿を送ります。easyCoexistence は各投稿を、すぐに、または設定した publish_at の時刻に、各ネットワークの公式 API を通じて公開します。
Nuvemshop のアプリと Webhook は、どのように設定しますか?
設定は一度だけ、Partners Portal とターミナルから行います。Nuvemshop または Tiendanube のパートナーとして登録し、Apps でアプリを作成してください。その際、商品画像とバリアントも対象になる read_products を指定し、ストアにインストールします。リダイレクト URL に届く認可コードの有効期限は 5 分で、https://www.tiendanube.com/apps/authorize/token で、アクセストークンと、ストア ID である user_id に交換します。トークンは、同じアプリとストアで新しいトークンを取得するか、アプリをアンインストールするまで期限切れになりません。その後、POST /webhooks で Webhook を登録します。各リクエストには、トークンを含む Authorization: Bearer と、アプリ名と連絡先を記載した User-Agent を付けてください。付けない場合、Nuvemshop は 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" }'n8n ワークフローは、商品ごとに何を行いますか?
受け付け、検証、読み取り、変換、投稿の順に行います。Raw Body を有効にし、Respond を Immediately に設定した Webhook ノードは、Nuvemshop の 3 秒以内に応答します。Extract From File ノードでボディをテキストに変換し、Crypto ノードで SHA256 と HEX を指定して Hmac を計算します。鍵はアプリのクライアントシークレットです。If ノードは、計算結果が x-linkedstore-hmac-sha256 ヘッダーと一致した場合のみ処理を続けます。
その後、HTTP Request ノードでストアのトークンを使って GET /products/{{ $json.id }} を読み取ります。If ノードは、visibility が visible で images が空でない場合に処理を続けます。Nuvemshop は同じ通知を 2 回送ることがあるため、Remove Duplicates ノードを Remove Items Processed in Previous Executions に設定し、投稿済みの商品を除外します。Instagram 向けには、HTTP Request ノードでメイン画像をファイルとしてダウンロードし、Edit Image ノードで Format を jpeg にしてリサイズします。その後、HTTP Request ノードで n8n の Binary File として POST /api/v1/media に送信し、media_id を取得します。最後に、アカウントごとに 1 回の HTTP Request で POST /api/v1/channels/<account_id>/posts を呼び出します。
n8n を使わずに、スクリプトで商品を投稿するには?
小さな Web エンドポイントを使います。以下の Python は、アプリのクライアントシークレットで生のボディに対して署名を検証し、すぐに 200 を返して、残りの処理をバックグラウンドで行います。商品を読み取り、visible でない商品や写真のない商品はスキップします。メイン写真は Pillow で、辺が最大 1080 ピクセルの JPEG に変換します。これは Instagram と TikTok の両方が受け付けるサイズです。そのファイルを POST /media にアップロードし、Instagram と TikTok に投稿して、Facebook にはリンク投稿を行います。各呼び出しには、商品とアカウントから作成した Idempotency-Key を付けます。easyCoexistence はこのキーを尊重します。また、投稿済み ID の集合を保持することで、同じ通知を受け取っても 2 回投稿されないようにします。
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 は、依頼に応じてどのように商品を投稿しますか?
easyCoexistence のコネクタと並べて、Nuvemshop 独自のコネクタを使います。Nuvemshop のヘルプセンターでは、MCP を基盤とした AI コネクタについて説明しています。これは Claude で使えるほか、ChatGPT ではコネクタ機能を通じて、また Cursor などのエディターで利用できます。Claude では、https://admin-mcp.nuvemshop.com.br をカスタムコネクタとして追加します。読み取りツールでは、商品、注文、顧客を検索できます。依頼の例は次のとおりです。「明日の午前 10 時(サンパウロ時間)から、最新の商品 5 件を TikTok に投稿してください。1 時間ごとに 1 件ずつ、それぞれにキャプションを付けてください。」アシスタントは商品を読み取り、キャプションを作成し、scheduled_at で各投稿を予約します。アシスタントは依頼されたときにのみ動作し、チャットとチャットの間ではストアを監視しません。そのため、夜間に追加された商品は Webhook を通じて投稿されます。
各ネットワークは、商品投稿で何を受け付けますか?
各ネットワークのルールと、easyCoexistence 独自のチェックは、投稿の送信時または予約時に適用されます。そのため、公開できない商品はすぐに拒否されます。以下のとおりです。
- Instagram:JPEG 画像のみです。WebP または PNG の商品写真は、先に変換してください。複数の写真はカルーセルになります。投稿にはリンク欄がないため、商品のアドレスはキャプションにテキストとして記載します。
- TikTok:JPG または WebP の画像を 1〜35 枚使う写真投稿です。各画像は 1080 × 1920 または 1920 × 1080 ピクセル、20 MB までです。タイトルは 90 文字までで、アカウントごとの 1 日あたりの写真投稿は 15 件までです。
- Facebook:商品の
canonical_urlへのリンク投稿です。プレビューは、ページの Open Graph タグから Facebook が作成します。または、本文にアドレスを記載した写真 1 枚でも投稿できます。 - easyCoexistence 経由のメディア:HTTPS リンク、または POST /media から取得した
media_idを指定できます。画像は最大 30 MB で、投稿の予約時にコピーされます。 - キャプション:Nuvemshop の name と description は、pt や es などの言語コードをキーとするオブジェクトです。description は 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.
- 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.
よくある間違い
- 投稿を送信してから Nuvemshop に応答するのは避けてください。Nuvemshop は 2XX の応答を 3 秒待ち、その後 48 時間以内に最大 16 回まで再送します。先に応答し、その後で投稿してください。
- Nuvemshop が配信する商品写真をそのまま Instagram に送るのは避けてください。Nuvemshop は URL の末尾に関係なく WebP を配信することがあり、Instagram は JPEG のみを公開します。そのため、ファイルの Content-Type を確認し、変換してください。
- 署名の検証にストアのアクセストークンを使うのは避けてください。Nuvemshop は生のボディに対して、アプリのクライアントシークレットで署名します。そのため、ボディを解析する前に Hmac を計算してください。
- 商品が作成された直後に投稿するのは避けてください。商品は非表示や写真なしの状態で始まることがあります。visibility と images を確認し、product/updated も購読して、各商品は 1 回だけ投稿してください。
easyCoexistence は、お使いのストアと、それを運用する AI エージェントに対し、Instagram、TikTok、Facebook などのチャネルでお客様へのリーチを提供します。各チャネルは公式 API を通じて接続されます。n8n やお客様のスクリプト向けには posts API とメディアアップロードを、Claude と ChatGPT 向けには Nuvemshop 独自のものと並べて使える MCP コネクタを 1 つ用意しています。また、90 日先まで公開を予約できるキューも備えています。すべての接続は 24 時間体制で監視されます。料金は接続 1 件あたり月額 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 で販売できるようにします。このフローは、新商品ごとにフィード投稿を公開します。
Nuvemshop の商品を投稿するための easyCoexistence の料金はいくらですか?
接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。どのネットワークでも同じ料金です。posts API、メディアアップロード、MCP コネクタは含まれ、最初の 3 日間は無料トライアルです。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日