técnico · resposta com fontes
O que é o modo sandbox do SendGrid?
O modo sandbox do SendGrid é um ambiente restrito que permite aos desenvolvedores testar integrações de API e configurações SMTP sem enviar e-mails para destinatários reais. Nesse modo, o sistema valida a requisição e retorna uma resposta de sucesso, mas o e-mail não é de fato entregue ao endereço de destino, para evitar spam acidental ou uso indevido durante o desenvolvimento.
Como funciona o modo sandbox
Quando uma conta está em modo sandbox, o SendGrid processa a chamada de API ou a requisição SMTP recebida para garantir que o payload esteja sintaticamente correto e que a autenticação seja válida. A API retorna o código de status 202 Accepted, indicando que a requisição foi recebida. No entanto, o agente de transferência de e-mail não repassa a mensagem para a internet externa. Isso permite aos desenvolvedores verificar a lógica do código e o tratamento de erros sem arriscar a reputação do remetente nem gerar custos.
Requisitos de verificação
Para sair do modo sandbox, os usuários precisam concluir um processo de verificação. Normalmente, isso envolve fornecer os dados da conta e verificar uma identidade de remetente. O SendGrid exige essa etapa para reduzir o risco de a plataforma ser usada para fins maliciosos. Até que a conta seja totalmente aprovada, qualquer tentativa de enviar e-mails para endereços não verificados fará a mensagem ser descartada, mesmo com a API retornando uma resposta de sucesso.
Estratégias de teste
Os desenvolvedores devem usar o modo sandbox para testar a integração da aplicação com a API do SendGrid. Depois de confirmar que as respostas da API são bem-sucedidas, o próximo passo é verificar um único endereço de e-mail remetente ou um domínio completo. As ferramentas gratuitas do SendHQ ajudam os desenvolvedores a garantir que os registros DNS estejam configurados corretamente antes de ir para produção, evitando falhas de entrega.
Como passar para a produção
Passar para a produção exige concluir o processo de ativação da conta e configurar a autenticação de domínio. Isso envolve adicionar registros SPF e DKIM às configurações de DNS do domínio de envio. Quando o status da conta muda de sandbox para ativa, os e-mails passam a ser roteados para os destinatários reais. Os desenvolvedores devem fazer um teste final com um endereço interno conhecido antes de enviar para a lista completa de usuários.
Perguntas que as equipes fazem
Por que recebo uma resposta 202, mas nenhum e-mail chega?
Esse é o comportamento esperado do modo sandbox. O status 202 significa que a requisição de API era válida, mas o e-mail não foi entregue porque a conta ainda está restrita.
Como desativo o modo sandbox?
Você precisa concluir o processo de verificação da conta e fornecer as informações comerciais solicitadas à equipe do SendGrid para aprovação.
Posso enviar para o meu próprio e-mail no modo sandbox?
Em geral, não. A menos que o endereço de e-mail esteja verificado especificamente como remetente ou faça parte de uma identidade verificada, o modo sandbox bloqueia a entrega para todos os endereços.
O modo sandbox tem custo?
Não. As requisições feitas no modo sandbox não contam para a sua cota mensal de envio, já que nenhum e-mail é de fato entregue.
Fontes primárias
- SendGrid Documentation — Twilio SendGrid (em inglês)
- SendGrid Pricing — Twilio SendGrid (em inglês)