Version: 1.0.0

AgileTelecom SMS Universal API

API REST per l'invio di messaggi SMS in modalità Universal. Supporta placeholder, concatenazione automatica, UDH, pianificazione invio e notifiche di consegna.

Autenticazione

Tutte le richieste richiedono una delle seguenti modalità:

• API Key — Header X-Api-Key: <api-key>
• Basic Auth — Header Authorization: Basic <base64(username:password)>

Funzionalità principali

• Invio SMS con mittente alfanumerico o numerico
• Supporto placeholder dinamici nel testo del messaggio
• Concatenazione automatica per messaggi lunghi (multipart)
• Dati UDH personalizzati per SMS binari
• Pianificazione invio (scheduled send)
• Modalità simulazione per test
• Notifiche di consegna via webhook

Webhook — Notifiche di consegna

Quando enableNotification è abilitato, il sistema invia callback HTTP POST al tuo URL configurato in piattaforma.

Formato callback

{
  "channel": "SMS",
  "eventType": "DELIVERY",
  "messageId": "uuid",
  "statusCode": 3,
  "statusDescription": "Delivered",
  "price": 0.035,
  "numPart": 1,
  "totalParts": 1,
  "timestamp": "2024-01-15T10:30:00Z"
}

Campo	Tipo	Descrizione
channel	string	Sempre "SMS"
eventType	string	Sempre "DELIVERY"
messageId	string	UUID del messaggio inviato
statusCode	integer	3 = Delivered, 6 = Not Delivered
statusDescription	string	Descrizione leggibile dello stato
price	number	Costo del messaggio
numPart	integer	Numero della parte consegnata
totalParts	integer	Totale parti del messaggio concatenato
timestamp	string	Timestamp ISO 8601 della notifica

Authentication

API Key: ApiKeyAuth

API Key fornita da AgileTelecom

Security Scheme Type:	apiKey
Header parameter name:	X-Api-Key

HTTP: Basic Auth

Credenziali username/password

Security Scheme Type:	http
HTTP Authorization Scheme:	basic

Contact

AgileTelecom:

URL: https://agiletelecom.com