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

# Self-serve vs Partner tier

> Elegí el tier de API correcto para tu caso de uso: tus propias integraciones, volumen mayor, o embeber Quikly en un producto que revendés a clientes finales.

La API REST de Quikly está disponible en tres tiers. Elegir el correcto desde el inicio evita suspensiones de claves y throttling inesperado cuando escalás.

## Chooser rápido

<CardGroup cols={3}>
  <Card title="Self-serve" icon="user" href="/es/integrations/api-keys">
    Para **tus propias integraciones**: scripts, herramientas internas, flujos de n8n que construís para vos o para clientes *como parte de tu servicio profesional*. Incluido en cada plan.
  </Card>

  <Card title="Business (API Boost)" icon="chart-line">
    Para casos **self-serve de mayor volumen** — las mismas integraciones, pero necesitás más de 2.000–5.000 llamadas/mes. Add-on sobre tu plan actual.
  </Card>

  <Card title="Partner" icon="handshake">
    Para **embeber Quikly en un producto que vendés** a usuarios finales de terceros. Requiere un acuerdo separado. <a href="mailto:contact@getquikly.com">Contactanos</a>.
  </Card>
</CardGroup>

## Self-serve

Es el tier por defecto. Cualquier usuario con un plan pago (Starter, Professional, Agency, Lifetime) puede generar claves API desde **Settings → API Keys**.

**Para qué sirve:**

* Flujos de n8n / Zapier / Make que corrés vos.
* Pipelines de CI/CD que consultan propuestas o actualizan estados.
* Un bot de Telegram o widget web que embebés en *tu propio* sitio para captar leads de *tu* negocio freelance o de agencia.
* Un dashboard interno que tu equipo usa junto con la UI de Quikly.

**Límites:** ver [Claves de API → Rate limits y quota](/es/integrations/api-keys#rate-limits-and-quota).

**Qué NO está permitido en self-serve:**

* Revender la funcionalidad de Quikly a terceros como si fuera tu producto.
* Correr una sola API key a nombre de muchos clientes pagos de *tu* producto (proxying multi-tenant).
* Quitar la atribución en los outputs generados y presentarlos como si los hubiera generado tu marca.

Estos casos requieren el tier Partner descrito abajo. La política completa está en [Términos de Servicio §5.3](https://getquikly.com/legal/terms).

## Business (API Boost)

<Note>
  Estado: **próximamente**. Si hoy estás chocando el techo self-serve y tu caso sigue siendo "tus propias integraciones", escribinos a <a href="mailto:contact@getquikly.com">[contact@getquikly.com](mailto:contact@getquikly.com)</a> y whitelistamos quota extra mientras el add-on llega.
</Note>

API Boost es un add-on sobre un plan Professional, Agency o Lifetime. Levanta la quota mensual y el rate limit por minuto sin cambiar a qué endpoints podés llegar.

Usalo cuando:

* Tenés una o dos automatizaciones pesadas que ocasionalmente pican arriba de la quota incluida.
* Corrés un pipeline de propuestas para tus propios clientes y necesitás más margen que los 2.000/mes de Agency.

## Partner

El tier Partner es para empresas que construyen un **producto sobre Quikly** que sirve a *sus propios* clientes pagos.

Escenarios típicos de partner:

* Un builder de agentes IA cuyos usuarios crean agentes que generan propuestas.
* Un CRM o herramienta de operaciones que embebe nativamente el flujo de propuestas y recomendación de tarifa de Quikly.
* Un servicio white-label potenciado por Quikly.

Las integraciones Partner obtienen:

* Un namespace dedicado `/api/v1/partner/*` con límites más altos.
* Un path de autenticación separado (API key + firma HMAC del request).
* Cardinality por usuario final incorporado al pricing (facturás por lo que consumen tus usuarios, no por una quota mensual plana).
* Un Partner Agreement formal que cubre atribución, responsabilidad sobre los datos, anti-reverse-engineering y terminación.

Las integraciones Partner deben:

* Enviar `X-Partner-Id`, `X-External-User-Id` y `X-Agent-Id` en cada request (ver [headers de trazabilidad](/es/integrations/api-keys#integration-traceability-headers)).
* Mantener la atribución "Powered by Quikly" a menos que el Partner Agreement lo exceptúe expresamente.
* Aislar los datos del usuario final (sin leakage entre tenants).

**Cómo empezar:** mandanos un mail a <a href="mailto:contact@getquikly.com">[contact@getquikly.com](mailto:contact@getquikly.com)</a> con una descripción breve de lo que estás construyendo, volumen mensual esperado, y si necesitás white-label. Te pasamos un borrador de Partner Agreement y una API key de sandbox.

## Tabla de decisión

| Tu caso de uso                                                                                         | Tier correcto          |
| ------------------------------------------------------------------------------------------------------ | ---------------------- |
| "Quiero conectar mi bot de Telegram con Quikly para mi propio pre-sales."                              | Self-serve             |
| "Llevo una agencia y quiero que n8n auto-cree propuestas desde Typeform."                              | Self-serve             |
| "Mi herramienta interna hace 5.000 llamadas a rate-recommendation por mes."                            | Self-serve + API Boost |
| "Estoy construyendo una plataforma de agentes IA y mis usuarios crearán agentes que llaman a Quikly."  | **Partner**            |
| "Quiero revender el calculador de tarifa de Quikly bajo mi marca."                                     | **Partner**            |
| "Mi SaaS tiene un botón 'generar propuesta' que llama a Quikly en background para todos mis clientes." | **Partner**            |

## Atribución y watermarking

Los outputs generados por los endpoints de IA de Quikly (agent chat, rate recommendation, análisis de propuesta, diferenciadores) incluyen un marcador `source: "quikly.ai"` en el metadata de la respuesta. Los PDFs generados en planes Starter incluyen un footer "Powered by Quikly.ai"; los PDFs Pro/Agency/Lifetime no, pero las respuestas JSON siguen llevando metadata de atribución.

Quitar o enmascarar este metadata en self-serve es una violación de los [Términos de Servicio §5.3.2](https://getquikly.com/legal/terms). Los partners pueden negociar las reglas de atribución en su acuerdo.

## Relacionado

* [Claves de API](/es/integrations/api-keys) — cómo crear, scopear y rotar claves.
* [Resumen de integraciones](/es/integrations/overview) — todas las rutas de integración y sus métodos de autenticación.
* [Términos de Servicio §5.3](https://getquikly.com/legal/terms) — política completa de API e integraciones.
