Публикация новых товаров Nuvemshop и Tiendanube в Instagram, TikTok и Facebook автоматически
Вебхук product/created приложения Nuvemshop или Tiendanube может публиковать каждый новый товар в Instagram, TikTok и Facebook через easyCoexistence: n8n или короткий скрипт получает товар, конвертирует его главное фото в JPEG для Instagram и отправляет текст, фото и ссылку в API постов easyCoexistence, который публикует через официальный API каждой сети, сразу или позже. Claude публикует товары по запросу через собственный коннектор Nuvemshop.
Сколько Nuvemshop ждёт ответа 2XX на вебхук перед повтором: до 16 попыток в течение 48 часов.
Поля, которые несёт вебхук товара Nuvemshop, с меткой времени и без данных о товаре, поэтому товар читается через GET /products/{id}.
Заголовок с HMAC-SHA256 подписью каждого вебхука, которая вычисляется с client secret приложения, а не с токеном доступа магазина.
Формат, в котором Nuvemshop может отдавать изображения товаров после оптимизации, и в API нет опции, чтобы отключить конвертацию.
Адрес, который Центр справки Nuvemshop указывает для добавления собственного коннектора MCP к Claude как пользовательского коннектора.
Самое большое изображение, которое принимает фотопост TikTok, или 1920 × 1080, в формате JPG или WebP размером до 20 МБ.
Как новый товар Nuvemshop становится постом?
Через приложение, вебхук и один вызов на аккаунт. Вебхуки Nuvemshop принадлежат приложению, поэтому создайте его с областью доступа read_products, установите в своём магазине и зарегистрируйте вебхук для product/created, который указывает на ваш рабочий процесс n8n или сервер. Уведомление содержит ID магазина, событие и ID товара, но без данных о товаре, поэтому рабочий процесс читает товар через GET /products/{id}, проверяет, что он видим и имеет фото, и отправляет один запрос на аккаунт в API постов easyCoexistence: фотопост для Instagram и TikTok, ссылочный пост для Facebook. easyCoexistence публикует каждый из них через официальный API сети, сразу или в поле publish_at, которое вы задали.
Как настроить приложение Nuvemshop и его вебхук?
Один раз, в Partners Portal и терминале. Зарегистрируйтесь как партнёр Nuvemshop или Tiendanube, создайте приложение в разделе Apps с областью read_products, которая также охватывает изображения и варианты товаров, и установите его в магазине. Код авторизации, отправленный на ваш адрес перенаправления (redirect URL), действует 5 минут и обменивается по адресу https://www.tiendanube.com/apps/authorize/token на токен доступа и user_id, ID магазина. Токен не истекает, пока вы не получите новый для этого приложения и магазина или пока приложение не будет удалено. Затем зарегистрируйте вебхук через POST /webhooks. Каждый запрос несёт 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 делает с каждым товаром?
Отвечает, проверяет, читает, конвертирует и публикует. Узел Webhook с включённым Raw Body и настройкой Respond на Immediately отвечает в течение 3 секунд, которые даёт Nuvemshop. Узел Extract From File превращает тело в текст, узел Crypto вычисляет его Hmac с SHA256 и HEX, подписанный client secret приложения, а узел 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 отправляет его как Binary File n8n в POST /api/v1/media, который возвращает media_id. Затем один HTTP Request на аккаунт вызывает POST /api/v1/channels/<account_id>/posts.
Как скрипт публикует товары без n8n?
С небольшим веб-эндпоинтом. Python ниже проверяет подпись по сырому телу с client secret приложения, сразу отвечает 200 и делает остальное в фоне: читает товар, пропускает тот, который не виден или без фото, и конвертирует главное фото с помощью Pillow в JPEG, сторона которого не больше 1080 пикселей, что принимают и Instagram, и TikTok. Он загружает этот файл в POST /media, публикует его в Instagram и TikTok и делает ссылочный пост в Facebook. Каждый вызов несёт Idempotency-Key, составленный из товара и аккаунта, который соблюдает easyCoexistence. Набор опубликованных ID не даёт повторному уведомлению опубликовать пост дважды.
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, который работает с Claude, с ChatGPT через его коннекторы и с редакторами вроде Cursor. В Claude он добавляется как пользовательский коннектор по адресу https://admin-mcp.nuvemshop.com.br, а его инструменты чтения находят товары, заказы и клиентов. Спросите, например: «Опубликуйте наши пять новых товаров в TikTok, начиная с завтрашнего дня в 10:00 по времени Алматы, по одному в час, с подписью к каждому». Ассистент читает товары, пишет подписи и планирует каждый пост через scheduled_at. Он действует по запросу и не следит за магазином между чатами, поэтому товары, добавленные ночью, уходят через вебхук.
Что принимает каждая сеть в посте о товаре?
Правила каждой сети, а также собственные проверки easyCoexistence применяются при отправке или планировании поста, поэтому товар, который не может уйти, отклоняется сразу:
- Instagram: только изображения JPEG, поэтому сначала переведите фото товара из WebP или PNG в JPEG. Несколько фото образуют карусель. У поста нет поля для ссылки, поэтому адрес товара идёт в подписи текстом.
- TikTok: фотопосты из от 1 до 35 изображений JPG или WebP, каждое до 1080 × 1920 или 1920 × 1080 пикселей и 20 МБ, заголовок в 90 символов и 15 фотопостов в день на аккаунт.
- Facebook: ссылочный пост на
canonical_urlтовара, с превью, которое Facebook строит по тегам Open Graph страницы, или одно фото с адресом в тексте. - Медиа через easyCoexistence: ссылка HTTPS или
media_idиз POST /media, изображения до 30 МБ, которые копируются при планировании поста. - Подписи: название и описание товара в Nuvemshop являются объектами с ключами по языку, например pt или es, а описание написано в HTML, поэтому выберите один язык и уберите теги.
Как настроить
- 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 ждёт 3 секунды ответа 2XX, затем повторяет запрос до 16 раз в течение 48 часов, поэтому сначала отвечайте, а потом публикуйте.
- Отправка в Instagram фото товара в том виде, в каком его отдаёт Nuvemshop. Nuvemshop может отдать WebP независимо от расширения адреса, а Instagram публикует только JPEG, поэтому проверяйте Content-Type файла и конвертируйте его.
- Проверка подписи токеном доступа магазина. Nuvemshop подписывает client secret приложения по сырому телу, поэтому вычисляйте HMAC до разбора тела.
- Публикация товара в момент создания. Он может появиться скрытым или без фото, поэтому проверяйте видимость и изображения, слушайте также product/updated и публикуйте каждый товар один раз.
easyCoexistence даёт вашему магазину и ИИ-агентам, которые им управляют, доступ к клиентам в Instagram, TikTok, Facebook и других каналах, каждый через официальный API: API постов и загрузку медиа для n8n и ваших скриптов, один MCP-коннектор для Claude и ChatGPT рядом с коннектором Nuvemshop, а также очередь, которая публикует до 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 товара, а не его данные, поэтому товар каждый раз читается заново.
Что делает собственный канал Instagram и Facebook у Nuvemshop?
Он подключает каталог магазина, Pixel и витрину к Meta для продаж в Instagram и Facebook, как описывает Центр справки Nuvemshop, из раздела Canais de venda в админке. Этот процесс публикует пост в ленте для каждого нового товара.
Сколько стоит easyCoexistence для публикации товаров Nuvemshop?
US$ 9 до US$ 0,75 за подключение в месяц, с понижением по мере добавления подключений, одинаково для каждой сети. API постов, загрузка медиа и коннектор MCP включены, первые 3 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на