SocialHub.AI
Recursos · Centro para desarrolladores

Shopify, Tienda de Amazon y TikTok

Conecta tus canales de comercio electrónico para que los pedidos online generen fidelización. Shopify sincroniza productos y otorga puntos automáticamente en los pedidos; Amazon y TikTok Shop permiten a los miembros ganar puntos por pedidos que verificamos en la plataforma, sin depender de la palabra del comprador. Puedes configurar las tres opciones en la aplicación, en Ajustes → Tienda online.

Tres canales, un lugar

Los tres se encuentran en la página Configuración → Tienda en línea como una sola tarjeta con pestañas. Shopify es una sincronización completa (productos + puntos de pedido automáticos). Amazon y TikTok Shop son canales de pedido verificado: un miembro informa su pedido number en el portal y la plataforma obtiene el pedido autorizado del vendedor API antes de otorgar los puntos. La información personal del comprador nunca se almacena.

Tienda en línea

Shopify

Conecta tu tienda Shopify para incorporar datos de productos a tus campañas y convertir los pedidos completados en puntos de fidelización; no necesitas código, solo el dominio de tu tienda y un token de acceso de administrador API.

1 · Crea un token de acceso de administrador API en Shopify

En tu Shopify El administrador debe ir a Configuración → Aplicaciones y canales de venta → Desarrollar aplicaciones → crear una aplicación, otorgarle permisos. read_products y read_orders (añada ámbitos de escritura solo si los necesita) e instálelo para revelar el Administrador. API token de acceso (shpat_…).

2 · Conecta la tienda en SocialHub

En la aplicación, ve a Configuración → Tienda online → pestaña Tienda online. Introduce el dominio de tu tienda (my-store.myshopify.com) y el token de acceso de administrador API. El token se verifica con tu tienda antes de guardarlo y se cifra (AES-256-GCM) en reposo; nunca se registra ni se vuelve a mostrar.

3 · Sincroniza y gana

Pulsa Sincronizar ahora para importar tu catálogo de productos para las campañas. A partir de ese momento, los pedidos completados otorgan puntos de fidelidad automáticamente (con la misma fórmula que los recibos), y las primeras compras y las compras repetidas activan los eventos de automatización posteriores a la compra.

// What the platform exposes for the Online Shop connection:
POST /api/shopify/connect      { "shopDomain": "my-store.myshopify.com", "accessToken": "shpat_…" }
GET  /api/shopify/status       // → { connected, shopDomain, status, lastSyncedAt, productCount, apiVersion }
POST /api/shopify/sync         // pull products now
POST /api/shopify/disconnect   // remove the connection + synced product data
//
// Orders: SocialHub receives Shopify order webhooks (order.fulfilled) and awards points
// keyed by the order id — idempotent, so a replayed webhook never double-awards.
// Connecting an Online Shop requires the Omnichannel plan.
Mercado

Amazon

Permite que los miembros ganen puntos por sus pedidos verificados de Amazon. Autorizas una aplicación Amazon SP-API (Iniciar sesión con Amazon) en tu cuenta de Seller Central; la plataforma utiliza esas credenciales para obtener cada pedido autoinformado y otorgar puntos solo si el pedido es real. Configúralo en Ajustes → Tienda online → Amazon (administradores de equipo y administradores del sistema).

Configuración de conexión

Nombre de la conexión
Una etiqueta para esta conexión, p. “Amazon EE. UU. - BrandX”. ¿Multivendedor? Utilice un nombre distinto por conexión.
Región
Región de AWS del punto final SP-API, por ejemplo, us-east-1.
Punto final
Host SP-API para su región, por ejemplo, https://sellingpartnerapi-na.amazon.com.
IDs de mercado
Separados por comas, por ejemplo, ATVPDKIKX0DER (Amazon EE. UU.).
ID de vendedor
Opcional: su ID de socio comercial/comerciante.

Secretos (cifrados en reposo · solo escritura)

Token de actualización LWA
Atzr|… — desde la autorización de su aplicación SP-API en Seller Central.
ID de cliente de LWA
amzn1.application-oa2-client… — ID de cliente de tu aplicación SP-API
Secreto del cliente LWA
Secreto de cliente de tu aplicación SP-API.

Save & Verify ejecuta una verificación de vida en vivo contra SP-API y enumera los mercados que puede ver. El token de actualización de LWA no gira; vuelva a verificarlo en cualquier momento desde la fila de conexión.

Mercado

Tienda de TikTok

El mismo modelo de verificación y no confianza que utiliza Amazon, frente al socio de tienda de TikTok API. Usted autoriza una aplicación TikTok Shop Partner en su tienda para obtener una clave de aplicación/secreto de aplicación y un token de actualización. Configúrelo en Configuración → Tienda en línea → Tienda TikTok (administradores de equipo y administradores de sistema).

Configuración de conexión

Nombre de la conexión
Una etiqueta para esta conexión, por ejemplo, «TikTok EE. UU. - Marca X».
Región
Región de la tienda, p. a nosotros.
Comprar cifrado
Opcional: déjelo en blanco; Save & Verify lo descubre en tu tienda autorizada.

Secretos (cifrados en reposo · solo escritura)

Clave de la aplicación
Clave de tu aplicación TikTok Shop Partner.
Secreto de la aplicación
El secreto de tu aplicación TikTok Shop Partner.
Token de actualización
ROW_… — desde la autorización de la aplicación en su tienda. TikTok rota esto en cada actualización; la plataforma persiste la rotación por usted.

Deja el Cifrado de la Tienda en blanco: Guardar y Verificar lo descubre desde tu tienda autorizada. TikTok rota el token de actualización con cada actualización; la plataforma serializa y conserva la rotación para que las tareas concurrentes nunca se invaliden entre sí.

// Marketplace credentials (Amazon / TikTok Shop) are saved + liveness-checked here.
// Open to team admins (org_owner / org_admin) and system admins; tenant-isolated —
// an admin can only ever read/write their OWN team's channels.
POST /api/admin/channels            { teamId, kind: "amazon" | "tiktok", name, config, secrets }
POST /api/admin/channels/{id}/ping  // re-verify the connection (discovers shop refs / cipher)
//
// Secrets (refresh_token, client_secret, app_secret, …) are AES-GCM encrypted the
// instant they arrive — write-only, never returned, never logged.

Cómo se mantienen seguras las credenciales

Cifrado en reposo

Cada secreto (token de acceso, token de actualización, secreto de cliente/aplicación) se cifra con AES-GCM en el instante en que llega. Los secretos son de sólo escritura: nunca se devuelven al navegador ni se escriben en registros o correos electrónicos.

Inquilino aislado

Las credenciales de canal están vinculadas a un equipo. Los administradores de equipo (org_owner / org_admin) y los administradores del sistema las gestionan, y solo pueden leer o escribir las conexiones de su propio equipo.

Verifica, no confíes

Para Amazon y TikTok Shop, los puntos se otorgan solo por los pedidos que la plataforma obtuvo del API autorizado por el vendedor. La PII del comprador se compara y luego se descarta y nunca persiste en el registro del pedido.

Ganancias idempotentes

Shopify Los webhooks de pedidos y los números de pedidos del mercado se codifican por ID de pedido, por lo que una repetición o un envío duplicado nunca otorga puntos dos veces.

Relacionado: REST API · POS · OMS · ERP · Portal de miembros Incrustar

¿Conectando un canal de ventas?

Consulta con un ingeniero sobre los ámbitos de Shopify, la autorización SP-API, las aplicaciones de socios de TikTok Shop o cómo funcionan los puntos de pedidos verificados.

hablar con ingenieria