Skip to main content
Sandbox é o simulador de voo da Notifique: você treina a integração inteira sem risco de mandar mensagem real ou gastar crédito.

​
O que é o sandbox?

É o ambiente de testes da Notifique. A API é a mesma (https://api.notifique.dev/v1/...); o que muda é a chave: use sk_test_... em vez de sk_live_.... Pense no simulador de voo: mesmo painel, mesmas manobras, só que ninguém decola de verdade.

​
Para que serve?

Com sandbox você pode:
  • Integrar sua aplicação sem mandar SMS, e-mail ou WhatsApp real
  • Testar webhooks, templates e fluxos antes do go-live
  • Simular status de entrega (entregue, lido, falha) na Caixa sandbox
  • Validar payloads e erros sem debitar crédito
Nada do sandbox afeta dados ou envios de produção.

​
Quando usar?

​
Como usar

​
1. Crie uma chave de teste

Abra Developer → API Keys, crie uma chave Sandbox e copie sk_test_... na hora. Precisa de ajuda? Veja Chaves de API.

​
2. Chame a API normalmente

Mesma URL, mesmos endpoints. Só troque a chave no header:
Não precisa de header extra de ambiente. A chave define tudo.

​
3. Acompanhe na Caixa sandbox

Abra Developer → Caixa sandbox. Lá você:
  • Confere o payload de cada envio
  • Libera mensagens agendadas com Liberar agora
  • Simula status: entregue, lido, clique, falha (conforme o canal)

​
4. Teste webhooks

Os eventos têm os mesmos nomes da produção. O payload inclui sandbox: true em data para você filtrar no mesmo endpoint. Mais em Webhooks.

​
5. Vá para produção

Quando estiver pronto, troque sk_test_... por sk_live_... nos mesmos caminhos. É trocar o simulador pelo voo real.

​
O que funciona e o que não

​
WhatsApp oficial (Cloud API) no sandbox

Com sk_test_, os endpoints POST /v1/whatsapp/messages e POST /v1/templates/send não chamam a Graph nem o gate de pagamento Meta:
  • Sem ping de token → não marca a instância real como DISCONNECTED
  • Sem META_PAYMENT_METHOD_REQUIRED / META_TEMPLATE_REQUIRED reais
  • O payload aparece na Caixa sandbox como nos outros canais
Use produção (sk_live_) para validar template aprovado, janela de 24h e cartão no WhatsApp Manager. Detalhes: Templates oficiais Meta.
Operações que dependem de provedor real (QR WhatsApp, DNS de e-mail) podem retornar 403 ou 501 no sandbox.

​
Limites

​
Sandbox x Produção

​
Próximos passos