# Modo de prueba

Claves de prueba con datos de ejemplo: integra sin tocar tus datos reales ni esperar aprobación.

Guía Sin aprobación Datos de ejemplo

**Como en Stripe.** Integra con ByDomu sin tocar tus datos reales ni esperar aprobación. Cada cuenta tiene un modo de prueba.

## Claves de prueba

En _Configuración › Claves de API_ elige **Prueba** y crea una clave: `domu_sk_test_…` (secreta, para tu servidor) o `domu_pk_test_…` (publicable, para tu página web). Tienen todos los permisos (escrituras, mensajes y webhooks) sin solicitar acceso, también durante la prueba gratis; basta con tener el correo verificado. Límite: 100 peticiones y 30 escrituras por minuto.

## Tu organización de prueba

Con tu primera clave de prueba creamos una organización de prueba con datos de ejemplo: contactos, citas, tareas y conversaciones, y además propiedades y negocios si tu cuenta es inmobiliaria. No hay datos personales reales. Una clave de prueba solo ve y cambia esa organización, y una clave de producción nunca la ve.

## Cómo saber en qué modo estás

Cada respuesta trae el encabezado `X-Domu-Mode: test` (o `live`), y `GET /v1/me` devuelve `"mode": "test"` y `"livemode": false`.

```bash
curl https://api.bydomu.com/v1/me -i \
  -H "X-API-Key: $BYDOMU_API_KEY"

# X-Domu-Mode: test
# { "data": { "mode": "test", "livemode": false, … } }
```

## Nada sale de verdad

- Desde la organización de prueba no se envía WhatsApp, Instagram, Facebook, correo, SMS ni notificaciones.
- Tampoco hay cobros, publicaciones en portales o Meta Ads, ni llamadas a la IA.
- Los mensajes quedan guardados como enviados y su id empieza por `wamid.sim_`.

## Webhooks

Se entregan igual que en producción, con la misma firma `X-Domu-Signature` y los mismos reintentos. El sobre lleva `"livemode": false`; los de producción, `"livemode": true`. Para probar tu receptor sin esperar un evento real:

```bash
curl -X POST https://api.bydomu.com/v1/test/events \
  -H "X-API-Key: domu_sk_test_…" -H "Content-Type: application/json" \
  -d '{"type":"deal.won"}'
```

El evento sale con los datos del registro más reciente de ese objeto en tu organización de prueba y trae `"test": true`.

## Empezar de cero

`POST /v1/test/reset` (con una clave secreta de prueba) o el botón _Reiniciar datos de prueba_ borra todo y vuelve a cargar los datos de ejemplo. Se conservan tus claves, el id de la organización y tus webhooks.

```bash
curl -X POST https://api.bydomu.com/v1/test/reset \
  -H "X-API-Key: domu_sk_test_…"
```

## Pasar a producción

Cambia la clave por una `domu_sk_live_…` y verifica en tu receptor de webhooks que `livemode` sea `true`. Las operaciones `/v1/test/*` responden `403 TEST_MODE_ONLY` con claves de producción.

## MCP

El servidor MCP acepta `domu_sk_test_…` igual que una clave live; el asistente solo verá los datos de ejemplo.