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 é como a mensagem é tratada — por chave (sk_test_) ou por destino de teste do workspace. 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
  • Pré-visualizar mensagens na Inbox sandbox (bolha, HTML, push, RCS, voz)
  • Validar HTML de e-mail com o checker de Compatibilidade
  • Simular status de entrega (entregue, lido, falha) na Inbox sandbox
  • Validar payloads e erros sem debitar crédito
Nada do sandbox afeta dados ou envios de produção.

​
Duas formas de entrar no sandbox

Não misture destino sandbox e destino real na mesma requisição → 422 SANDBOX_MIXED_RECIPIENTS. Não use o e-mail ou telefone sandbox de outro workspace → 422 SANDBOX_IDENTITY_FOREIGN.

​
Destinos de teste por workspace

Cada workspace tem identidades fixas, derivadas do slug na criação: No painel: Developer → Inbox sandbox → Seus destinos de teste (copiar e-mail, telefone e device). Os compositores de envio (Novo e-mail, SMS, etc.) mostram o mesmo atalho. Exemplo com chave de produção — só cai na inbox se o destino bate:
Com sk_test_, qualquer to funciona; o domínio de origem não precisa estar verificado.

​
Quando usar?

​
Como usar

​
1. Crie uma chave de teste (opcional)

Abra Developer → API Keys, crie uma chave Sandbox e copie sk_test_... na hora. Precisa de ajuda? Veja Chaves de API. Com destinos de teste do workspace, você também pode usar sk_live_ sem mandar nada para o cliente.

​
2. Chame a API normalmente

Mesma URL, mesmos endpoints. Troque a chave ou o destinatário:
Não precisa de header extra de ambiente.

​
3. Acompanhe na Inbox sandbox

Abra Developer → Inbox sandbox. Lá você:
  • Pré-visualiza cada mensagem na aba Pré-visualização (como no detalhe de produção)
  • Para e-mail, usa a aba Compatibilidade (checker de HTML: CSS, imagens, links, deliverability)
  • Confere payload bruto e metadados (Detalhes, Payload)
  • Libera mensagens agendadas com Liberar agora
  • Simula status: entregue, lido, clique, falha (conforme o canal)
  • Consulta exemplos de webhook por canal na aba Webhooks

​
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. Envios interceptados por destino incluem intercepted: true nos metadados da inbox. Mais em Webhooks.

​
5. Templates e e-mail no sandbox

  • Editor de template: Teste de pré-visualização do template → destino Sandbox → mensagem na inbox, sem provedor real nem cobrança.
  • API: POST /templates/:id/send-test com "sandbox": true (painel) ou POST /v1/templates/send com destinos de teste / sk_test_.
  • E-mail: POST /v1/email/messages ou E-mail → Novo e-mail no painel; pré-visualização HTML e checker de compatibilidade no composer.
Detalhes de templates: Variáveis e CRUD.

​
6. Vá para produção

Quando estiver pronto, use destinatários reais com sk_live_.... É 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 Inbox 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, conexão Instagram) podem retornar 403 ou 501 no sandbox.

​
Limites

​
Sandbox x Produção

​
Próximos passos