Construye con Etchify.

Integración IA y API REST directa en todos los planes, prueba incluida. Spec OpenAPI, endpoint MCP, 36 herramientas: 15 de lectura, 21 de escritura. Push en tiempo real vía el webhook orders/create nativo de Shopify.

Quickstarts

Elige el frontend que ya usas. Cada configuración empieza con la clave API del admin de Etchify.

Todos los planes, prueba incluida

Endpoints

Todos los endpoints están limitados a una sola tienda mediante la clave API.

Especificación OpenAPI

Importa esta URL en Acciones de ChatGPT Custom GPT o genera un cliente tipado.

https://api.etchify.app/api/openapi.json

Abrir →

Endpoint MCP

Usa esta URL para conectores custom de Claude.ai y la config mcpServers de Claude Desktop / Claude Code.

https://api.etchify.app/mcp

Autenticación

Cada solicitud necesita un header.

X-API-Key: sk_etch_...

✓Rota o revoca en cualquier momento desde Ajustes → Integración IA en el admin de Etchify.
✓Cada clave está limitada a una tienda. Las claves nunca salen de tu admin de Shopify hasta que las copies — solo se muestran una vez al generarse.

Rate-limits

Starter	60 req/min	Más que suficiente para conversación IA humana
Pro	60 req/min	Más que suficiente para conversación IA humana
Business	600 req/min	Diseñado para operaciones bulk scriptadas
Prueba 14 días	600 req/min	Equivalente Business durante la prueba

Códigos de error

HTTP estándar. Body siempre JSON: { error, message, request_id }.

401Header X-API-Key faltante o malformado

403Clave API válida pero sin autorización para este endpoint

404Recurso no encontrado en esta tienda

409Conflict — el recurso ya existe (solo POST mutations)

429Rate-limit excedido — ver header Retry-After

500Error del servidor — request_id está logueado, escribe a help@etchify.app

Inventario de herramientas MCP / REST

36 herramientas: 15 de lectura, 21 de escritura. La tabla muestra las 15 de lectura. Las mismas herramientas vía OpenAPI, MCP-HTTP, MCP-stdio o REST directa.

Herramienta	Propósito
list-products	Lista todos los productos configurados de tu tienda
get-product-config	Config detallada de un producto (materiales, modos, dimensiones)
browse-templates	Filtra plantillas por producto, categoría o forma
list-materials	Biblioteca de todos los materiales configurados
list-shapes	Biblioteca de todas las formas custom
list-all-templates	Lista plana de todas las plantillas
health-check	Estado de salud y uptime del servicio
get-api-spec	Devuelve la spec OpenAPI inline
get-setup-guide	Walkthrough de pasos de configuración restantes
diagnose-setup	Detecta malas configuraciones entre productos, materiales, formas
shop-info	Nombre de la tienda, plan, fecha de instalación, locale, moneda
list-orders	Los pedidos de la tienda, los más recientes primero — estado, producto, vista previa del diseño, archivo de producción listo
get-order	Un pedido en detalle
get-shop-stats	Cifras de uso de tus clientes
show-image	Muestra una imagen de diseño o de producto en el chat

Prueba estos prompts

Pídele datos de Etchify a tu puente con ChatGPT o Claude — copia una línea, pégala en tu frontend de IA, listo. 36 herramientas: 15 de lectura, 21 de escritura trabajan por debajo.

Analíticas e insights

Herramientas de lectura

¿Qué materiales se venden mejor este mes?

¿Con qué plantilla convierten más a menudo los clientes?

¿A cuánto asciende la parte de mis ingresos que se lleva Etchify este trimestre?

¿Sobre qué material diseñan la mayoría de los clientes?

Inspecciona la biblioteca

Herramientas de lectura

Lista todos los materiales de la categoría madera.

¿Qué productos usan la forma «Coaster Round»?

¿Cuáles son los ajustes de producción del material «Roble 6mm»?

¿Qué plantillas no se han usado en los últimos 30 días?

Configuración y depuración

Herramientas de diagnóstico + escritura

Mi cliente no puede añadir el diseño al carrito — ¿qué podría estar fallando?

Guíame para activar el export PDF/X-1a para mi imprenta.

Cambia el método de producción de este producto a impresión.

Detecta claves de API mal configuradas en mi configuración.

Requiere tener la integración de IA activada. Tu IA cambia la configuración directamente — los productos que ya están a la venta esperan tu aprobación.

Integration Cookbook

Tres recetas para propietarios que conectan Etchify a sus propios flujos — descarga masiva vía curl, push en tiempo real vía el webhook nativo orders/create de Shopify, configuración de nodo HTTP en n8n. Cada snippet funciona contra la REST API (todos los planes).

Descarga masiva de pedidos diseñados (curl)

Trae a tu ERP todos los pedidos diseñados de un rango de fechas. Elimina las importaciones de tablas y los flujos con CSV sin herramientas extra.

# Fetch designed orders since yesterday
curl -X GET 'https://api.etchify.app/api/v1/orders?since=2026-05-03T00:00:00Z&status=designed' \
  -H 'X-API-Key: shop_etchify_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json'

# Fetch designed orders since yesterday
curl -X GET 'https://api.etchify.app/api/v1/orders?since=2026-05-03T00:00:00Z&status=designed' \
  -H 'X-API-Key: shop_etchify_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json'

Push en tiempo real vía orders/create de Shopify

Los pedidos llegan a Etchify a través de los webhooks de pedidos propios de Shopify — no hay un webhook de Etchify aparte que verificar. Para tu ERP, un servicio de email o un puente con Slack, suscribe el webhook orders/create de Shopify; incluye las propiedades de carrito de Etchify de cada pedido.

Nodo HTTP Request de n8n

JSON listo para pegar en un workflow de n8n. Descarga los nuevos pedidos diseñados cada hora con cabecera de autenticación. Combínalo con un trigger de agenda y salida a Notion / Airtable.

// n8n HTTP Request node config (manual export to JSON)
{
  "method": "GET",
  "url": "https://api.etchify.app/api/v1/orders",
  "authentication": "genericCredentialType",
  "genericAuthType": "httpHeaderAuth",
  "sendQuery": true,
  "queryParameters": {
    "parameters": [
      { "name": "since", "value": "{{$now.minus({hours:1}).toISO()}}" },
      { "name": "status", "value": "designed" }
    ]
  },
  "options": { "response": { "response": { "responseFormat": "json" } } }
}

// n8n HTTP Request node config (manual export to JSON)
{
  "method": "GET",
  "url": "https://api.etchify.app/api/v1/orders",
  "authentication": "genericCredentialType",
  "genericAuthType": "httpHeaderAuth",
  "sendQuery": true,
  "queryParameters": {
    "parameters": [
      { "name": "since", "value": "{{$now.minus({hours:1}).toISO()}}" },
      { "name": "status", "value": "designed" }
    ]
  },
  "options": { "response": { "response": { "responseFormat": "json" } } }
}

Los snippets son plantillas de partida — cámbialos por tus propias claves de API, secretos y endpoints. El push en tiempo real usa el webhook orders/create de Shopify (gratis en todos los planes de Shopify), que transporta cada propiedad de carrito de Etchify (_design_id, _design_url, _preview_url, medidas como «Dimensions»; el material está en la variante) — sin configuración por parte de Etchify.

Disponible: AI Write Tools + REST directa

Push en tiempo real (Shopify-nativo)

Suscribe el webhook orders/create de Shopify a tu endpoint — cada Etchify-cart-property (_design_id, _design_url, _preview_url, medidas como «Dimensions»; el material está en la variante) se entrega automáticamente. Verificación HMAC vía la firma estándar de Shopify. Gratis en cada plan Shopify.

AI Write Tools

21 herramientas de escritura para agentes IA en todos los planes: enable-product, create-shape, set-brand-colors, upload-shop-logo, create-template, set-production-method, etc. Tu IA cambia la configuración directamente — los productos que ya están a la venta esperan tu aprobación.

Changelog API

Breaking-changes y nuevos endpoints se trackean en el changelog.

Ver changelog →

¿Necesitas ayuda?

Escribe a help@etchify.app — los planes Pro y Business reciben routing prioritario.

help@etchify.app Volver a Integración IA