Modo de prueba

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

GuíaSin aprobaciónDatos 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.

cURL

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:

cURL

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.

cURL

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.