Quick Start

Invia il tuo primo SMS in 3 minuti con la REST API di Agile Telecom.

Prerequisiti

• Account wholesale Agile Telecom attivo (registrati qui)
• API key (la trovi nella dashboard del tuo account)
• Un numero di destinazione in formato internazionale (es. +393351234567)

Endpoint

POST https://wholesale.agiletelecom.com/services/sms/send

Invia il tuo primo SMS

cURL

curl -X POST https://wholesale.agiletelecom.com/services/sms/send \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: your_api_key_here" \
  -d '{
    "enableConcatenated": true,
    "enableUnicode": true,
    "enableDelivery": true,
    "messages": [
      {
        "destinations": ["+393351234567"],
        "sender": "Agile",
        "body": "Ciao! Questo è il tuo primo SMS via Agile Telecom."
      }
    ]
  }'

Python

import requests

url = "https://wholesale.agiletelecom.com/services/sms/send"
headers = {
    "Content-Type": "application/json",
    "X-Api-Key": "your_api_key_here",
}
payload = {
    "enableConcatenated": True,
    "enableUnicode": True,
    "enableDelivery": True,
    "messages": [
        {
            "destinations": ["+393351234567"],
            "sender": "Agile",
            "body": "Ciao! Questo è il tuo primo SMS via Agile Telecom.",
        }
    ],
}

response = requests.post(url, json=payload, headers=headers, timeout=10)
print(response.status_code, response.json())

Node.js

const axios = require('axios');

const url = 'https://wholesale.agiletelecom.com/services/sms/send';
const headers = {
  'Content-Type': 'application/json',
  'X-Api-Key': 'your_api_key_here',
};
const payload = {
  enableConcatenated: true,
  enableUnicode: true,
  enableDelivery: true,
  messages: [
    {
      destinations: ['+393351234567'],
      sender: 'Agile',
      body: 'Ciao! Questo è il tuo primo SMS via Agile Telecom.',
    },
  ],
};

axios
  .post(url, payload, { headers })
  .then((res) => console.log(res.status, res.data))
  .catch((err) => console.error(err.response?.status, err.response?.data));

Risposta

Una submission riuscita restituisce HTTP 200 con un body JSON simile a:

{
  "globalId": "req_1234567890",
  "accepted": true,
  "results": [
    {
      "destination": "+393351234567",
      "id": "msg_abc123",
      "accepted": true,
      "statusCode": 200
    }
  ]
}

Campi chiave

• globalId — Il tuo ID di correlazione (echo del campo che hai inviato o generato automaticamente).
• id — Identificativo univoco per messaggio. Usalo per correlare il delivery report.
• accepted: true — Il messaggio è stato accettato dalla piattaforma, non ancora consegnato. La consegna è asincrona.
• statusCode — Codice di submission per destinazione (200 = accettato, vedi Gestione errori).

Accepted ≠ Delivered

Quando accepted: true, il messaggio è entrato in coda di invio. Usa i delivery report per sapere se è effettivamente arrivato al telefono.

Prossimi passi

1. Invio SMS — Encoding, sender ID, schedulazione, invio massivo.
2. Delivery Report — Notifiche di consegna in tempo reale.
3. Autenticazione — Proteggi la tua API key in produzione.
4. Best Practice — Throughput, retry, opt-out.

Servono i reference completi? Apri la SMS API sul portale wholesale.