Skip to main content
A API da Salvy oferece dois ambientes: sandbox e produção. Você não precisa trocar a URL da API para alternar entre eles. O ambiente é definido pela chave de API utilizada.
  • Produção: executa ações reais, como envio de SMS, e-mails, notificações e cobranças.
  • Sandbox: ambiente isolado para desenvolvimento e testes. Nenhuma ação externa real (SMS, e-mail, notificações e outras) é executada.
Você pode usar a mesma URL em desenvolvimento e produção. Para trocar de ambiente, basta trocar a chave de API.

​
Sandbox vs. Produção

Chaves de API anteriores a 07/2026 não tem prefixo

​
Como o ambiente é escolhido

Você não muda o endereço nem envia nenhum parâmetro especial. Basta usar a chave do ambiente desejado no cabeçalho Authorization:
Produção
Sandbox
Você pode identificar o ambiente de uma chave pelo prefixo: chaves de sandbox começam com salvy_test_ e chaves de produção com salvy_prod_.

​
Primeiros passos no sandbox

Para começar a testar, crie uma chave de API de sandbox. O passo a passo está no guia de Chaves de API. Quando você cria a primeira chave de sandbox, a Salvy cria automaticamente um ambiente de testes para a sua empresa. Esse ambiente copia apenas o perfil da empresa (como razão social, CNPJ e endereço). Os dados operacionais começam vazios e as próximas chaves de sandbox utilizam esse mesmo ambiente.

​
O que é replicado

  • O perfil da sua empresa é copiado, para que o sandbox represente a sua organização.
  • Os dados (linhas virtuais, colaboradores, equipamentos) não são copiados: o sandbox começa vazio. Você cria os dados de teste via API, da mesma forma que faria em produção.
  • Tudo o que você cria no sandbox, colaboradores, ativos, linhas e ouo. tros recursos ficam isolados de produção.

​
Comportamento no sandbox

Uma resposta 2xx significa que a Salvy processou a requisição com sucesso. No sandbox, isso não significa que uma mensagem foi enviada para um destinatário real.
Nenhuma operação no sandbox gera cobrança.

​
Números virtuais no sandbox

No sandbox, a criação de uma linha virtual sempre retorna o mesmo número de demonstração, para qualquer empresa. Nenhum número real é reservado, e a criação não depende da disponibilidade de DDD. A listagem de DDDs no sandbox retorna apenas o DDD desse número de demonstração.

​
Simular o recebimento de SMS

Como nenhuma mensagem real trafega no sandbox, use o endpoint exclusivo do sandbox para simular o recebimento de um SMS em uma linha virtual e disparar o webhook de SMS recebido.

​
Boas práticas e segurança

Não misture as chaves. Como o endereço é o mesmo nos dois ambientes, usar uma chave de produção (salvy_prod_) em um teste executa ações reais, incluindo envios e cobranças. Confirme sempre o prefixo da chave antes de usá-la.
  • Use chaves de sandbox (salvy_test_) em desenvolvimento e testes automatizados.
  • Guarde as chaves de produção e de sandbox separadamente e com nomes descritivos. Veja Chaves de API.
  • Valide toda a sua integração no sandbox antes de trocar para uma chave de produção.