> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salvy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambientes

> Entenda os ambientes de sandbox e produção da API da Salvy e como alternar entre eles

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.

<Tip>
  Você pode usar a mesma URL em desenvolvimento e produção. Para trocar de
  ambiente, basta trocar a chave de API.
</Tip>

## Sandbox vs. Produção

|                                              | Produção                            | Sandbox                              |
| -------------------------------------------- | ----------------------------------- | ------------------------------------ |
| Endereço base                                | `https://api.salvy.com.br`          | `https://api.salvy.com.br` (o mesmo) |
| Prefixo da chave                             | `salvy_prod_` (apenas chaves novas) | `salvy_test_` (apenas chaves novas)  |
| Envios reais (SMS, e-mail, WhatsApp, notif.) | Sim                                 | Não, simulados                       |
| Cobranças                                    | Sim                                 | Não                                  |
| Acesso ao dashboard                          | Sim                                 | Não                                  |
| Dados                                        | Reais, da sua empresa               | Isolados, apenas de teste            |

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

## 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`:

```bash Produção theme={null}
curl -X GET "https://api.salvy.com.br/api/v1/virtual-phone-accounts" \
-H "Authorization: Bearer salvy_prod_sua_chave_aqui"
```

```bash Sandbox theme={null}
curl -X GET "https://api.salvy.com.br/api/v1/virtual-phone-accounts" \
-H "Authorization: Bearer salvy_test_sua_chave_aqui"
```

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](/api-reference/api-keys).

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

<Warning>
  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.
</Warning>

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](/api-reference/virtual-phone-accounts/list-area-codes) 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](/api-reference/virtual-phone-accounts/simulate-sms) em uma linha virtual e disparar o webhook de [SMS recebido](/api-reference/webhooks/sms-received).

## Boas práticas e segurança

<Warning>
  **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.
</Warning>

* 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](/api-reference/api-keys).
* Valide toda a sua integração no sandbox antes de trocar para uma chave de produção.