Sandbox e Live (modo da conta)

“Sandbox” tem dois significados distintos no MorisBox:

Conceito	Significado
Hosts de implantação	Ambiente compartilhado (`api.morisbox.com`, Partner Hub e Application Client)
Sandbox da conta	Por parceiro: mensagens de saída limitadas a um único telefone de teste

Esta página trata do modo Sandbox / Live da conta.

Por padrão: Sandbox

Cada novo parceiro é criado no modo Sandbox:

Só pode enviar para um telefone E.164 permitido (sandbox_allowed_phone)
As transmissões ficam bloqueadas
Os convites para fluxos e o chat de agente usam a mesma restrição de telefone
O parceiro de plataforma seed360 está sempre no modo Live (OTP / sistema)

Configurar seu telefone de teste

Partner Hub → Configurações → Sandbox / Live, ou:

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

{
  "sandbox_allowed_phone": "+228XXXXXXXX"
}

Em seguida:

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

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

O envio para qualquer outro número retorna 403, com error.code = sandbox_restricted.

Solicitar o modo Live

Quando estiver pronto para o tráfego de produção:

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

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

Um administrador da plataforma MorisBox deve aprovar a solicitação. Até lá, você permanece no sandbox.

Hub: Sandbox / Live → Solicitar Live.

Administração (parceiro de plataforma)

Os operadores da plataforma podem:

Ação	Efeito
Aprovar Live	`sandbox_mode=false`
Rejeitar a saída	Permanecer no sandbox, status da saída `rejected`
Redefinir Sandbox	Forçar novamente o sandbox (por exemplo, após problemas de KYC); mantém o telefone de teste

API (chave de administração 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: Administração do sandbox (somente plataforma).

Hosts (implantação)

Serviço	URL
Partner API	`https://api.morisbox.com/api/v1`
Partner Hub	`https://partner.morisbox.com`
Documentação para parceiros	`https://docs.morisbox.com/partners`
Documentação para desenvolvedores	`https://developers.morisbox.com/developers`
Application Client	`https://morisbox.com`

Não existe uma chave de API pública compartilhada. Cada parceiro usa suas próprias credenciais.

Lista de verificação dos smoke tests (parceiro)

Novo parceiro → sandbox padrão
POST /messages sem telefone permitido → 403 sandbox_restricted
Definir o telefone permitido → enviar para esse número → 201
Enviar para outro número → 403
POST /broadcasts no sandbox → 403
Solicitar Live → aprovação do administrador → enviar para qualquer telefone

curl do parceiro (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"}'