Sandbox y Live (modo de cuenta)

«Sandbox» tiene dos significados distintos en MorisBox:

Concepto	Significado
Hosts de despliegue	Entorno compartido (`api.morisbox.com`, Partner Hub y aplicación cliente)
Sandbox de cuenta	Por socio: mensajes salientes limitados a un único teléfono de prueba

Esta página trata del modo Sandbox / Live de la cuenta.

De forma predeterminada: Sandbox

Cada nuevo socio se crea en modo Sandbox:

Solo puede enviar a un teléfono E.164 permitido (sandbox_allowed_phone)
Las difusiones están bloqueadas
Las invitaciones a flows y el chat de agente utilizan la misma barrera de teléfono
El socio de plataforma seed360 está siempre en modo Live (OTP / sistema)

Configurar su teléfono de prueba

Partner Hub → Ajustes → Sandbox / Live, o:

PUT /api/v1/settings/sandbox
Authorization: Bearer sk_…
Content-Type: application/json

{
  "sandbox_allowed_phone": "+228XXXXXXXX"
}

A continuación:

POST /api/v1/messages
Authorization: Bearer sk_…
Content-Type: application/json

{
  "phone": "+228XXXXXXXX",
  "body": "Hello sandbox"
}

El envío a cualquier otro número devuelve 403 con error.code = sandbox_restricted.

Solicitar el modo Live

Cuando esté listo para el tráfico de producción:

POST /api/v1/settings/sandbox/request-live
Authorization: Bearer sk_…
Content-Type: application/json

{
  "note": "Production launch for SEED notifications"
}

Un administrador de la plataforma MorisBox debe aprobarlo. Hasta entonces, permanece en el sandbox.

Hub: Sandbox / Live → Solicitar Live.

Administración (socio de plataforma)

Los operadores de la plataforma pueden:

Acción	Efecto
Aprobar Live	`sandbox_mode=false`
Rechazar la salida	Permanecer en el sandbox, estado de salida `rejected`
Restablecer Sandbox	Forzar de nuevo el sandbox (p. ej., después de problemas de KYC); conserva el teléfono de prueba

API (clave de administración de seed360):

GET  /api/v1/admin/sandbox
POST /api/v1/admin/sandbox/partners/{id}/approve-live
POST /api/v1/admin/sandbox/partners/{id}/reject-live
POST /api/v1/admin/sandbox/partners/{id}/reset

Hub: Administración del sandbox (solo plataforma).

Hosts (despliegue)

Servicio	URL
Partner API	`https://api.morisbox.com/api/v1`
Partner Hub	`https://partner.morisbox.com`
Documentación para socios	`https://docs.morisbox.com/partners`
Documentación para desarrolladores	`https://developers.morisbox.com/developers`
Aplicación cliente	`https://morisbox.com`

No existe ninguna clave API pública compartida. Cada socio utiliza sus propias credenciales.

Lista de comprobación de smoke tests (socio)

Nuevo socio → sandbox predeterminado
POST /messages sin teléfono permitido → 403 sandbox_restricted
Definir el teléfono permitido → enviar a ese número → 201
Enviar a otro número → 403
POST /broadcasts en el sandbox → 403
Solicitar Live → aprobación del administrador → enviar a cualquier teléfono

curl de socio (sandbox)

export SEED360_API_BASE="https://api.morisbox.com/api/v1"
export SEED360_API_KEY="sk_…"

curl -sS -X PUT "$SEED360_API_BASE/settings/sandbox" \
  -H "Authorization: Bearer $SEED360_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sandbox_allowed_phone":"+228XXXXXXXX"}'

curl -sS -X POST "$SEED360_API_BASE/messages" \
  -H "Authorization: Bearer $SEED360_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+228XXXXXXXX","body":"Hello MorisBox"}'