Aplicación Shopify Famulor

La aplicación Famulor AI Agent conecta una tienda Shopify con un espacio Famulor existente. El propietario instala la app, la abre en Shopify Admin y confirma la vinculación. No hace falta pegar secretos API ni introducir el dominio de la tienda. La aplicación Shopify no tiene una tarifa adicional. Se aplican tu suscripción Famulor y los cargos de uso existentes. Necesitas una cuenta Famulor existente.

Conectar el espacio

Abre Famulor AI Agent en Shopify Admin como propietario.
Pulsa Connect Famulor workspace e inicia sesión en Famulor en la nueva pestaña.
Elige un espacio donde seas propietario o administrador y pulsa Connect store.
Vuelve a Shopify Admin y pulsa Refresh.

El enlace caduca en cinco minutos y solo puede usarse una vez. Si caduca, empieza otra vez desde Shopify Admin. Solo el propietario puede consultar los datos del espacio conectado desde la app.

Añadir herramientas

Abre Famulor Tools desde Shopify Admin. Configura la conexión nativa y asigna tareas en los ajustes existentes de Tools y Assistant. El asistente consulta productos actuales, existencias, políticas y estado del pedido tras verificar exactamente al cliente. Las herramientas de solicitud de cancelación, reembolso y dirección registran solicitudes para el comerciante sin modificar pedidos. Las modificaciones gestionadas son acciones distintas sujetas a los requisitos siguientes.

Revisar actividad

Store activity muestra acciones y conversaciones atribuidas a esta tienda, sin exponer las de otras tiendas o espacios. Abre una conversación para leer su transcripción y escuchar una grabación disponible. Gestiona las tiendas en Famulor bajo Automations → Connections → Shopify app connections. Desconectar bloquea el acceso de las herramientas a esta tienda. Desinstala la app en Shopify para revocar el acceso.

API, MCP, CLI y SDK

La vinculación inicial necesita la aprobación del propietario en Shopify Admin. Después, las credenciales de propietario/administrador pueden gestionar la tienda.

Tarea	API REST	Herramienta MCP	Comando CLI
Tiendas	`GET /api/v1/shopify/installations`	`list_shopify_installations`	`famulor list-shopify-installations`
Acciones	`GET /api/v1/shopify/actions`	`list_shopify_actions`	`famulor list-shopify-actions`
Añadir herramientas	`POST /api/v1/shopify/installations/{id}/tools`	`provision_shopify_assistant_tools`	`famulor provision-shopify-assistant-tools STORE_ID --assistant-id ASSISTANT_ID --actions lookup_order`
Historial	`GET /api/v1/shopify/installations/{id}/history`	`list_shopify_history`	`famulor list-shopify-history STORE_ID`
Solicitudes	`GET /api/v1/shopify/installations/{id}/requests`	`list_shopify_support_requests`	`famulor list-shopify-support-requests STORE_ID`
Resolución	`PATCH /api/v1/shopify/installations/{id}/requests`	`resolve_shopify_support_request`	`famulor resolve-shopify-support-request STORE_ID --request-id REQUEST_ID --status completed`
Conversación	`GET /api/v1/shopify/installations/{id}/calls/{callId}`	`get_shopify_call`	`famulor get-shopify-call STORE_ID CALL_ID`
Informes de privacidad	`GET /api/v1/shopify/installations/{id}/privacy-exports`	`list_shopify_privacy_exports`	`famulor list-shopify-privacy-exports STORE_ID`
Informe de privacidad	`GET /api/v1/shopify/installations/{id}/privacy-exports/{exportId}`	`get_shopify_privacy_export`	`famulor get-shopify-privacy-export STORE_ID EXPORT_ID`
Desconectar	`DELETE /api/v1/shopify/installations/{id}`	`disconnect_shopify_installation`	`famulor disconnect-shopify-installation STORE_ID`

La lectura usa integrations:read. Las herramientas requieren también assistants:write y el historial calls:read. Los cambios usan integrations:write.

import { Famulor } from "famulor-sdk";
const famulor = new Famulor({ apiKey: process.env.FAMULOR_API_KEY! });
const stores = await famulor.shopify.installations();
const actions = await famulor.shopify.actions();
const activity = await famulor.shopify.history(stores.data[0].id);

El conector con tu propia aplicación sigue disponible. Tiene conexiones y capacidades distintas de la app nativa.

Plugin nativo de Shopify (Beta)

Activa las funciones beta del workspace. Abre Tools → Agent Connectors o Automations → Connections y conecta Shopify AI Agent App (Beta). Ambos usan la misma conexión. Crea o elige un asistente en Assistants y asigna las herramientas de Shopify en Tools. Conocimiento, SMS, transferencias, devoluciones de llamada, telefonía y campañas usan los ajustes existentes de Famulor. Productos, variantes, precios y existencias se consultan en Shopify en directo, sin importar un catálogo a Famulor. Son datos del momento; el checkout calcula el total final. Los pedidos privados requieren referencia exacta, correo coincidente y código postal de envío. El identificador de llamada no basta. Las solicitudes para revisión del comerciante son distintas de las modificaciones de Shopify. Borradores, correos de factura, cancelaciones, direcciones y devoluciones requieren activación del comerciante, permisos y entorno telefónico compatible. Cambios de clientes/pedidos existentes requieren además verificación privada y confirmación explícita vinculada a la acción preparada. Los requisitos ausentes bloquean la ejecución. No hay reembolso automático; un borrador no cobra al cliente. Las devoluciones dependen de envíos actuales y políticas; los cambios pueden requerir intervención del comerciante. Conectar no garantiza audiencias de recuperación, acceso a suscripciones ni ingresos incrementales.

REST API	MCP	CLI
`GET /api/v1/shopify/setup`	`get_shopify_setup`	`famulor get-shopify-setup`
`PATCH /api/v1/shopify/installations/{id}/capabilities`	`update_shopify_capabilities`	`famulor update-shopify-capabilities STORE_ID --enabled-capabilities voice_checkout --expected-version VERSION`

const setup = await famulor.shopify.setup();
await famulor.shopify.updateCapabilities(storeId, { enabled_capabilities: ["voice_checkout"], expected_version: setup.data.capabilities!.version });

Audiencias telefónicas externas (Beta)

En Campaign Settings, elige una conexión elegible de Shopify o Klaviyo y un segmento de origen actual. Las campañas locales conservan su comportamiento. Shopify admite segmentos seleccionados/VIP, recuperación, reposición, checkout abandonado y el escenario compatible de pago fallido. Klaviyo solo admite segmentos seleccionados. Elige el producto de reposición en el selector en directo. Recuperación y reposición necesitan pedidos antiguos. Pago fallido significa pedido real impagado y no cancelado con pruebas completas de fallo, sin pago posterior exitoso/pendiente ni pedido más reciente; no incluye suscripciones ni checkouts sin guardar. Solo llamadas telefónicas, seguimiento en Off. Antes de cada intento se comprueban segmento actual, escenario, teléfono y permiso positivo explícito de marketing por voz. Suscripción de correo/SMS, identificador de llamada y ausencia de bloqueo no bastan. La falta de prueba excluye al destinatario. Horarios, bloqueos, reintentos y capacidad siguen vigentes. La configuración no puede cambiar tras iniciar ejecuciones. Asigna un JSON autorizado mediante espacio de nombres y clave (espacio obligatorio en Shopify). Debe incluir subject_ref y phone actuales, channel: "voice", purpose: "marketing", granted: true, revoked: false, granted_at no futuro, evidence_ref y source_revision actual. Famulor conserva referencias operativas y estados, sin replicar clientes, pedidos ni catálogo.

Pagos netos asociados

Actualiza los pagos asociados en la actividad existente de Shopify. Famulor consulta pagos, reembolsos y cancelaciones actuales solo desde referencias guardadas de llamadas. Los borradores convertidos se resuelven en pedidos; cada pedido cuenta una vez y corresponde a la primera asociación de llamada de tienda, usando ID de llamada para desempatar. Los filtros de campaña se aplican después. Los decimales exactos se separan por moneda de tienda. Se muestran hora, reembolsos, cancelaciones y observaciones parciales. Referencias ausentes, acceso no disponible e historial antiguo/limitado no cuentan como cero ingresos. Es asociación, no ingreso incremental o causal.

REST	MCP	CLI
`GET /api/v1/shopify/installations/{id}/revenue`	`get_shopify_associated_revenue`	`famulor get-shopify-associated-revenue STORE_ID`

const payments = await famulor.shopify.associatedRevenue(storeId);

Automatización

Integraciones

Aplicación Shopify Famulor

Conectar el espacio

Añadir herramientas

Revisar actividad

API, MCP, CLI y SDK

Plugin nativo de Shopify (Beta)

Audiencias telefónicas externas (Beta)

Pagos netos asociados

​Conectar el espacio

​Añadir herramientas

​Revisar actividad

​API, MCP, CLI y SDK

​Plugin nativo de Shopify (Beta)

​Audiencias telefónicas externas (Beta)

​Pagos netos asociados

Conectar el espacio

Añadir herramientas

Revisar actividad

API, MCP, CLI y SDK

Plugin nativo de Shopify (Beta)

Audiencias telefónicas externas (Beta)

Pagos netos asociados