Quick Start

Invia il tuo primo messaggio in 3 minuti. Scegli il tuo canale e segui l'esempio per il tuo linguaggio preferito.

Prerequisiti

• Account Qlara attivo
• API key (trovala nella tua dashboard account)

Invia SMS

Endpoint: POST https://lora-api.agiletelecom.com/api/message-server/sms/send

SMS è raggiungimento universale. Nessun template o approvazioni necessari.

cURL

curl -X POST https://lora-api.agiletelecom.com/api/message-server/sms/send \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: your_api_key_here" \
  -d '{
    "phoneNumber": "+393901234567",
    "message": "Hello! This is your first SMS via Qlara.",
    "senderName": "Qlara"
  }'

Python

import requests

url = "https://lora-api.agiletelecom.com/api/message-server/sms/send"
headers = {
    "Content-Type": "application/json",
    "X-Api-Key": "your_api_key_here"
}
payload = {
    "phoneNumber": "+393901234567",
    "message": "Hello! This is your first SMS via Qlara.",
    "senderName": "Qlara"
}

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

Node.js

const axios = require('axios');

const url = 'https://lora-api.agiletelecom.com/api/message-server/sms/send';
const headers = {
  'Content-Type': 'application/json',
  'X-Api-Key': 'your_api_key_here'
};
const payload = {
  phoneNumber: '+393901234567',
  message: 'Hello! This is your first SMS via Qlara.',
  senderName: 'Qlara'
};

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

Invia RCS

Endpoint: POST https://lora-api.agiletelecom.com/api/message-server/rcs/send

RCS fornisce rich media su Android. Richiede un template approvato.

cURL

curl -X POST https://lora-api.agiletelecom.com/api/message-server/rcs/send \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: your_api_key_here" \
  -d '{
    "phoneNumber": "+393901234567",
    "templateId": "template_123",
    "variables": {
      "name": "John"
    }
  }'

Python

import requests

url = "https://lora-api.agiletelecom.com/api/message-server/rcs/send"
headers = {
    "Content-Type": "application/json",
    "X-Api-Key": "your_api_key_here"
}
payload = {
    "phoneNumber": "+393901234567",
    "templateId": "template_123",
    "variables": {
        "name": "John"
    }
}

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

Node.js

const axios = require('axios');

const url = 'https://lora-api.agiletelecom.com/api/message-server/rcs/send';
const headers = {
  'Content-Type': 'application/json',
  'X-Api-Key': 'your_api_key_here'
};
const payload = {
  phoneNumber: '+393901234567',
  templateId: 'template_123',
  variables: {
    name: 'John'
  }
};

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

Invia WhatsApp

Endpoint: POST https://lora-api.agiletelecom.com/api/message-server/whatsapp/send

I messaggi WhatsApp devono utilizzare template approvati da Meta. I messaggi liberi sono consentiti entro 24 ore dall'interazione con il cliente.

cURL

curl -X POST https://lora-api.agiletelecom.com/api/message-server/whatsapp/send \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: your_api_key_here" \
  -d '{
    "phoneNumber": "+393901234567",
    "templateId": "template_456",
    "variables": {
      "name": "John",
      "code": "ABC123"
    }
  }'

Python

import requests

url = "https://lora-api.agiletelecom.com/api/message-server/whatsapp/send"
headers = {
    "Content-Type": "application/json",
    "X-Api-Key": "your_api_key_here"
}
payload = {
    "phoneNumber": "+393901234567",
    "templateId": "template_456",
    "variables": {
        "name": "John",
        "code": "ABC123"
    }
}

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

Node.js

const axios = require('axios');

const url = 'https://lora-api.agiletelecom.com/api/message-server/whatsapp/send';
const headers = {
  'Content-Type': 'application/json',
  'X-Api-Key': 'your_api_key_here'
};
const payload = {
  phoneNumber: '+393901234567',
  templateId: 'template_456',
  variables: {
    name: 'John',
    code: 'ABC123'
  }
};

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

Formato della Risposta

Tutti i canali restituiscono la stessa struttura di risposta:

{
  "messageId": "msg_1234567890",
  "customerMessageId": "your_reference_id",
  "simulation": false,
  "results": [
    {
      "phoneNumber": "+393901234567",
      "accepted": true,
      "channel": "sms",
      "statusCode": 200
    }
  ]
}

Campi Chiave:

• messageId: Identificatore univoco per questo messaggio (usalo per il tracciamento)
• customerMessageId: Il tuo ID di riferimento (se fornito nella richiesta)
• accepted: true significa che il messaggio è stato accettato per l'invio, non consegnato. La consegna avviene in modo asincrono.
• channel: Il canale utilizzato per la consegna
• statusCode: Stato HTTP della richiesta (200 = successo)

Importante: Accettato ≠ Consegnato

Quando accepted: true, il messaggio è entrato nella coda di invio. Non è stato ancora consegnato. Usa webhook o polling per monitorare lo stato di consegna effettivo.

Passaggi Successivi

1. Configura Webhook — Ricevi notifiche di consegna in tempo reale
2. Configura Template — Pre-approva messaggi per RCS e WhatsApp
3. Implementa Fallback — Lascia che l'API tenti automaticamente canali alternativi
4. Autenticazione — Proteggi la tua API key correttamente

Hai bisogno di documentazione dettagliata? Vedi il Riferimento API per tutti i parametri e i codici di errore.