Home Documentazione FAQ

Domande Frequenti

Risposte alle domande più comuni su UniMsg. Non trovi quello che cerchi? Contattaci.

Generali

Cos'è UniMsg?

UniMsg è una piattaforma di messaggistica unificata che permette di inviare SMS, WhatsApp, Email e Telegram attraverso un'unica API. Semplifica l'integrazione e la gestione delle comunicazioni multicanale.

Quali canali supporta UniMsg?

Attualmente supportiamo:

È necessaria una carta di credito per registrarsi?

No, la registrazione è gratuita e non richiede carta di credito. Riceverai 100 crediti gratuiti per testare il servizio.

Account e Crediti

Come funzionano i crediti?

I crediti sono la valuta interna di UniMsg. Ogni messaggio consuma un certo numero di crediti in base al canale (SMS = 1, WhatsApp = 2, Email = 0.5, Telegram = 0.5). I crediti non scadono mai.

I crediti scadono?

No, i crediti acquistati non hanno scadenza e rimangono disponibili sul tuo account finché non li utilizzi.

Come posso ricaricare i crediti?

Dalla Dashboard vai su Crediti → Acquista, seleziona il pacchetto desiderato e completa il pagamento con carta, PayPal o bonifico.

Posso ottenere un rimborso?

I crediti non utilizzati possono essere rimborsati entro 14 giorni dall'acquisto. Contatta il supporto per assistenza.

API e Integrazione

Quali linguaggi di programmazione supportate?

La nostra API REST funziona con qualsiasi linguaggio. Forniamo esempi in PHP, Python, Node.js e cURL. La documentazione include snippet per tutti i principali linguaggi.

Come ottengo le credenziali API?

Dopo la registrazione, vai su Dashboard → Impostazioni → API per trovare il tuo Client ID e Client Secret.

L'access token è scaduto, cosa faccio?

Gli access token durano 1 ora. Quando scade, richiedi un nuovo token usando le tue credenziali. Non è necessario ri-autenticarsi.

C'è un limite alle chiamate API?

Sì, il rate limiting standard è di 100 richieste al minuto. I piani Enterprise hanno limiti personalizzabili. In caso di superamento riceverai un errore 429.

Come testo l'API senza inviare messaggi reali?

Puoi usare l'ambiente sandbox aggiungendo sandbox: true nelle tue richieste. I messaggi non verranno realmente inviati ma riceverai le stesse risposte.

SMS

Posso usare un mittente personalizzato?

Sì, puoi specificare un mittente alfanumerico (max 11 caratteri) o numerico. Alcuni paesi hanno restrizioni sui mittenti alfanumerici.

Quanto costa un SMS lungo?

Un SMS standard è 160 caratteri (1 credito). Messaggi più lunghi vengono divisi in segmenti da 153 caratteri ciascuno. Ogni segmento costa 1 credito.

Perché alcuni SMS non vengono consegnati?

Le cause più comuni sono: numero non valido, telefono spento, memoria piena, operatore che blocca. Controlla lo stato nella Dashboard per i dettagli.

WhatsApp

Devo creare un account WhatsApp Business?

No, UniMsg gestisce l'integrazione con WhatsApp Business API. Non hai bisogno di un account separato.

Cosa sono i template message?

I template sono messaggi pre-approvati da Meta che puoi inviare in qualsiasi momento. I messaggi "session" invece possono essere inviati solo entro 24h dall'ultima risposta dell'utente.

Come faccio approvare un nuovo template?

Contatta il supporto con il testo del template desiderato. Ci occuperemo noi della richiesta di approvazione a Meta.

Email

Come miglioro la deliverability delle email?

Configura i record SPF, DKIM e DMARC per il tuo dominio. La documentazione include i valori da aggiungere.

Posso tracciare aperture e click?

Sì, il tracking è attivo di default. Puoi disattivarlo passando track_opens: false e track_clicks: false.

Qual è la dimensione massima degli allegati?

25 MB totali per email, massimo 10 allegati.

Webhook

I webhook sono obbligatori?

No, sono opzionali. Puoi sempre controllare lo stato dei messaggi via API polling. I webhook sono consigliati per notifiche real-time.

Cosa succede se il mio endpoint non risponde?

UniMsg ritenterà l'invio fino a 5 volte con ritardi crescenti (1min, 5min, 30min, 2h). Dopo 5 tentativi falliti, il webhook viene segnato come non consegnato.

Come verifico che un webhook sia autentico?

Ogni webhook include l'header X-UniMsg-Signature con firma HMAC-SHA256. Verifica la firma usando il tuo Webhook Secret.

Sicurezza

I dati sono sicuri?

Sì, utilizziamo:

Dove sono conservati i dati?

I nostri server sono in Europa (UE). Siamo conformi al GDPR.

Posso limitare l'accesso API per IP?

Sì, dalla Dashboard puoi configurare una whitelist di IP autorizzati per le chiamate API.

Supporto

Come contatto il supporto?

Puoi contattarci via:

Quali sono i tempi di risposta?

Piano Starter: 48h lavorative. Piano Pro: 24h. Piano Enterprise: 4h con SLA garantito.

C'è documentazione API completa?

Sì, consulta la Documentazione Sviluppatori per il riferimento API completo con tutti gli endpoint, parametri e codici di errore.

Non hai trovato risposta? Contatta il nostro team di supporto a support@unimsg.app.
API Quickstart Documentazione Dev