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

# Asistente de configuración

> Genera una integración de iZap funcional en tu stack con @izapai/wizard.

`@izapai/wizard` es una CLI para desarrolladores que agrega iZap a una aplicación
existente. Funciona con recetas y es determinista: detecta tu stack, escribe
ediciones pequeñas y explícitas y estructuras basadas en el código fuente, y
muestra una vista previa de cada cambio antes de tocar un archivo. No requiere
clave de API ni llamadas a un LLM.

## Ejecútalo

```bash theme={null}
npx @izapai/wizard                              # asistente interactivo (en una TTY)
npx @izapai/wizard run "add iZap MCP"           # lo mismo, con un objetivo indicado
npx @izapai/wizard plan "connect an AI client"  # plan de solo lectura, no escribe nada
```

O instala el binario de forma global:

```bash theme={null}
npm install -g @izapai/wizard
izap-wizard doctor
```

El código fuente está en GitHub, en
[versariai/izap-wizard](https://github.com/versariai/izap-wizard). Los issues y
pull requests son bienvenidos.

En una terminal, el comando sin argumentos abre un asistente a pantalla completa
con una lista de tareas en vivo y las pestañas `Status` / `Logs` / `Reference`.
En un pipe o en CI imprime los mismos pasos línea por línea, y sin TTY escribir
requiere `--yes`: de lo contrario, la ejecución muestra el plan y termina con un
código distinto de cero. `--dry-run` muestra la vista previa sin escribir;
`--yes` omite la confirmación.

El asistente nunca sobrescribe un archivo generado que hayas editado: los
archivos en conflicto detienen la ejecución con una lista clara, y `--force`
sobrescribe de forma deliberada. Los archivos `.env.example` se combinan (tus
líneas ganan y las claves que faltan se agregan al final), y un `.mcp.json` mal
formado aborta la ejecución en lugar de reemplazarse.

## Lo que genera

<Columns cols={2}>
  <Card title="Cliente MCP" icon="robot">
    Instala el servidor MCP de iZap en `.mcp.json`, además de un cliente en
    TypeScript o Python. Consulta [Analytics MCP](/es/api-reference/mcp).
  </Card>

  <Card title="Cliente REST" icon="code">
    Estructura de cliente con JWT u OAuth 2.0 + PKCE para TypeScript o Python.
    Consulta [Autenticación](/es/api-reference/authentication).
  </Card>

  <Card title="Webhooks y SSE" icon="bolt">
    Un receptor de webhooks para el contrato de firma de
    [Webhooks](/es/api-reference/webhooks), o un cliente de Server-Sent Events
    para flujos de chat en vivo.
  </Card>

  <Card title="Superficies de WhatsApp" icon="whatsapp">
    Plantillas, transmisiones (envíos masivos), envío de mensajes y una página
    de conexión con el Embedded Signup de Meta, del lado del servidor para que
    tu JWT nunca llegue al navegador.
  </Card>
</Columns>

## Comandos comunes

```bash theme={null}
izap-wizard list --json                          # todas las recetas, legible por máquinas
izap-wizard plan "send WhatsApp reminders"       # recetas ordenadas para un objetivo
izap-wizard audit                                # inventario de la integración, solo lectura
izap-wizard doctor                               # verificaciones de configuración (rc 0 con avisos; --strict para fallar)
izap-wizard mcp add                              # instala el servidor MCP de iZap
izap-wizard mcp client --stack typescript        # genera un cliente MCP
izap-wizard rest client --stack python --auth oauth
izap-wizard webhook receiver --stack typescript  # requiere izap-webhook-signature-v2; IZAP_WEBHOOK_ALLOW_V1=1 para v1
izap-wizard webhook register --stack python      # POST /api/v1/webhook-endpoints/{business_id}
izap-wizard sse client --stack python
izap-wizard templates --stack typescript         # plantillas de WhatsApp: listar/crear/sincronizar
izap-wizard transmissions --stack python         # transmisiones: vista previa → --confirm → estado
izap-wizard send --stack typescript              # envía un mensaje/plantilla a un chat
izap-wizard whatsapp connect                     # página de incorporación de WhatsApp Business
```

Flags compartidos: `--dry-run`, `--json`, `--force`, `--output-dir DIR`,
`--target-root PATH`, `--env production|staging`.

## Traspaso a un agente

`izap-wizard ai "<goal>"` ejecuta la misma detección y planificación, y luego
escribe un `izap-integration-brief.md` que puedes pasarle a un agente de código
(Claude Code, Cursor o un agente conectado por MCP):

```bash theme={null}
izap-wizard ai "add iZap MCP to my Next.js app"
# → Escribió izap-integration-brief.md (stack detectado, receta, puntos de edición)
```

<Note>
  El asistente nunca lee los valores de tu `.env` y nunca escribe secretos.
  Prefiere escrituras idempotentes y muestra los cambios planificados con
  `--dry-run`.
</Note>


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