# Sandbox: cum îți testezi integrarea fără să trimiți SMS-uri

- Language: Romanian
- URL: https://calisero.ro/developer/knowledge-base/manual-sandbox
- English version: https://calisero.ro/en/developers/knowledge-base/manual-sandbox
- Published: 2026-09-27; last updated: 2026-10-24
- Summary: Cum folosești sandbox-ul Calisero: tot contul sau doar o cheie API, ce se simulează (livrare, callback-uri), unde vezi mesajele de test și cum treci live.

Sandbox-ul îți permite să-ți testezi integrarea cap-coadă fără să trimiți SMS-uri reale și fără să plătești. Faci exact aceleași apeluri API ca în producție, iar Calisero le tratează la fel — doar că mesajele nu pleacă spre rețele.

## La ce îți folosește

- **dezvoltare și staging** — scrii și testezi codul fără să trimiți SMS-uri către numere reale;
- **teste automate** — rulezi suita de teste oricât de des, fără costuri;
- **callback-uri** — verifici că serverul tău primește și procesează corect rapoartele de livrare;
- **OTP / 2FA** — testezi fluxul de verificare fără telefon: codul îl vezi în dashboard;
- **demo-uri** — îți arăți integrarea fără să trimiți nimic.

## Ce se întâmplă cu un mesaj de test

- **trece prin aceleași validări** ca un mesaj real: formatul numărului, lungimea textului, senderul aprobat. Dacă o cerere e greșită în sandbox, va fi greșită și în producție;
- **nu ajunge la destinatar** și **nu se taxează**;
- primește imediat statusul **„Livrat”**;
- dacă ai trimis un `callback_url`, **primești callback-urile** cu statusurile simulate, ca într-o livrare reală;
- **nu apare** în lista de mesaje, în cifre, grafice sau facturi;
- se înregistrează în **Loguri API** și îl poți urmări în **Debug** după trace ID, ca pe orice cerere — vezi [depanarea cu trace ID](https://calisero.ro/developer/knowledge-base/depanare-cu-trace-id).

Un mesaj rămâne de test chiar dacă oprești sandbox-ul înainte să fie trimis (de exemplu, un mesaj programat).

## Două moduri: tot contul sau doar o cheie

### Tot contul în sandbox

Se pornește din **Dezvoltatori → Sandbox**. Cât timp e pornit, **orice mesaj** al contului devine de test: trimis cu oricare cheie API, din dashboard („Trimite SMS”) sau ca verificare OTP. Nimic nu ajunge la destinatari.

Folosește-l când contul este doar pentru teste sau înainte de prima lansare. Cât timp e pornit, dashboard-ul îți afișează un avertisment, ca să nu uiți de el.

**Atenție:** dacă pornești sandbox-ul pe un cont care trimite deja în producție, oprești și trimiterile reale. Când îl oprești, mesajele noi ajung din nou la destinatari și se taxează.

### Doar o cheie de sandbox

Din **Dezvoltatori → Chei API** creezi o cheie nouă sau o modifici pe una existentă și bifezi **Cheie de sandbox**. Doar mesajele și verificările OTP trimise cu acea cheie sunt de test; **celelalte chei trimit în continuare normal**.

Este varianta recomandată când ai deja trafic real: cheia de producție rămâne activă, iar staging-ul sau mediul local folosesc cheia de sandbox. Treci în producție schimbând doar cheia, fără să modifici codul.

Pe scurt:

| | Tot contul | Cheie de sandbox |
|---|---|---|
| Ce devine test | toate mesajele contului | doar mesajele trimise cu acea cheie |
| Mesajele trimise din dashboard | da, sunt de test | nu, se trimit normal |
| Celelalte chei | trimit mesaje de test | trimit normal |
| Recomandat pentru | cont doar de test, înainte de lansare | staging și dezvoltare, lângă producție |

## Unde vezi mesajele de test

În **Dezvoltatori → Sandbox**. Pagina îți arată ce este pornit acum (tot contul sau câte chei de sandbox ai) și lista mesajelor de test, pe care o poți filtra și exporta în CSV. Fiecare mesaj se deschide pe pagina obișnuită de mesaj, cu tot istoricul lui. La verificările OTP de test, codul îl vezi direct în dashboard, pentru că SMS-ul nu pleacă spre telefon.

Mesajele de test se șterg automat după un număr limitat de zile, împreună cu logurile lor; pagina Sandbox îți spune câte.

## Trecerea în producție

1. Folosește o cheie fără sandbox (sau oprește sandbox-ul contului).
2. Verifică senderul: în producție, câmpul `sender` trebuie să fie un sender aprobat — vezi [cum obții aprobarea unui sender](https://calisero.ro/developer/knowledge-base/manual-cerere-sender).
3. Trimite un mesaj real către propriul număr și urmărește-l în Debug până la callback.