> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Aplicación Shopify Famulor

> Conecta un espacio Famulor existente y usa soporte por voz dentro de Shopify Admin.

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

1. Abre **Famulor AI Agent** en Shopify Admin como propietario.
2. Pulsa **Connect Famulor workspace** e inicia sesión en Famulor en la nueva pestaña.
3. Elige un espacio donde seas propietario o administrador y pulsa **Connect store**.
4. 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`.

```ts theme={null}
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](/es/automations/shopify) 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` |

```ts theme={null}
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` |

```ts theme={null}
const payments = await famulor.shopify.associatedRevenue(storeId);
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.