Home Documentazione Guida Rapida

Guida Rapida

Questa guida ti accompagnerà nella creazione del tuo account UniMsg e nella configurazione iniziale per iniziare a inviare messaggi.

1. Creazione Account

Per iniziare a utilizzare UniMsg, devi prima creare un account:

  1. Vai alla pagina di registrazione
  2. Inserisci i tuoi dati:
    • Nome e Cognome
    • Email aziendale
    • Password (minimo 8 caratteri)
    • Nome azienda
  3. Accetta i Termini di Servizio e la Privacy Policy
  4. Clicca su "Registrati"
  5. Verifica la tua email cliccando sul link di conferma
Nota: Con la registrazione riceverai automaticamente 100 crediti gratuiti per testare il servizio.

2. Primo Accesso

Dopo aver verificato la tua email:

  1. Accedi alla Dashboard con le tue credenziali
  2. Completa il profilo aziendale (opzionale ma consigliato)
  3. Esplora la dashboard per familiarizzare con l'interfaccia

3. Ottenere le Credenziali API

Per utilizzare le API di UniMsg, hai bisogno delle credenziali OAuth2:

  1. Dalla Dashboard, vai su Impostazioni → API
  2. Nella sezione "Credenziali API" troverai:
    • Client ID - Identificativo pubblico
    • Client Secret - Chiave segreta (clicca per visualizzare)
  3. Copia e conserva queste credenziali in modo sicuro
Importante: Non condividere mai il tuo Client Secret. Trattalo come una password.

Esempio di credenziali

Client ID: demo_xxxxxxxxxxxx
Client Secret: sk_test_xxxxxxxxxxxx

4. Testare la Connessione

Verifica che le tue credenziali funzionino ottenendo un access token:

curl -X POST https://api.unimsg.app/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=demo_xxxxxxxxxxxx" \
  -d "client_secret=sk_test_xxxxxxxxxxxx"

Risposta attesa:

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

5. Inviare il Primo Messaggio

Ora sei pronto per inviare il tuo primo SMS:

curl -X POST https://api.unimsg.app/v1/sms/send \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+39123456789",
    "message": "Ciao! Questo è il mio primo messaggio con UniMsg.",
    "sender": "UniMsg"
  }'

Risposta di successo:

{
  "success": true,
  "data": {
    "message_id": "msg_xxxxxxxxxxxx",
    "status": "queued",
    "credits_used": 1
  }
}
Congratulazioni! Hai inviato il tuo primo messaggio con UniMsg.

Prossimi Passi

Panoramica Dashboard