Ambiente sandbox: testar integração sem enviar SMS (nem e-mail) de verdade

Integrar mensagens costuma dar medo no começo: e se disparar para o cliente errado? E se gastar crédito à toa? O ambiente sandbox do Notifique existe para você exercitar a mesma API (/v1) sem falar com operadoras, Meta, provedor de e-mail ou push de verdade.

Na prática, você cria uma API Key do tipo Sandbox no painel (Configurações → API Keys → Nova API Key → escolha Sandbox). A chave começa com `sk_test_`. Nas requisições, envie como sempre: cabeçalho `Authorization: Bearer sk_test_...` ou `x-api-key`. O “modo” vem da própria chave: não precisa de header extra para dizer que é teste.

Tudo que você envia com sk_test_ aparece na Caixa sandbox (menu Developer no painel). Ali dá para ver canal, destino, payload, status e, se for agendamento, usar Release now para simular a liberação. Também dá para simular eventos como entregue, lido ou falha — e o Notifique dispara os webhooks com os mesmos nomes da produção, só que com `sandbox: true` no payload para o seu sistema separar teste de produção.

Existem limites pensados para uso de teste: até 50 mensagens sandbox por dia (UTC) por workspace e linhas guardadas por 7 dias. Agendamentos em sandbox não disparam sozinhos no relógio: ficam esperando você no painel até clicar em Release now — assim você controla o momento do teste.

O onboarding do workspace continua necessário (como na API ao vivo); o que muda é que não há cobrança nem envio real pelos canais simulados. Para o que ainda depende de provedor real (ex.: criar instância com QR), o painel e a API podem responder com erro de “não suportado em sandbox” — use sandbox para caminho feliz da mensagem e webhooks, e produção quando precisar validar operador de ponta a ponta.

Resumo do fluxo: crie a chave sandbox → aponte seu ambiente de dev/staging para ela → envie mensagens e automações como faria em produção → acompanhe na Caixa sandbox e nos webhooks → troque para sk_live_ só quando for valendo.

Documentação técnica completa (limites, webhooks, o que não entra no MVP): https://docs.notifique.dev/sandbox .

GET https://api.notifique.dev/v1/... 
Authorization: Bearer sk_test_sua_chave_aqui

Se você integra Notifique em produto próprio ou CRM, trate o sandbox como primeiro ambiente de homologação: menos surpresa na go-live e time de suporte com histórico claro do que foi testado.