Passa al contenuto principale
Version: 1.0.0

AgileTelecom RCS API

API REST per l'invio di messaggi RCS (Rich Communication Services). Supporta messaggi di testo, card ricche, caroselli e suggerimenti interattivi con fallback su WhatsApp e SMS.

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 messaggi RCS: testo, card ricche, caroselli
  • Suggerimenti interattivi (bottoni, link, risposte rapide)
  • Fallback automatico su WhatsApp e SMS
  • Notifiche di consegna, lettura e messaggi in ingresso (webhook)

Webhooks​

I seguenti callback vengono inviati via HTTP POST al tuo URL configurato in piattaforma.

DELIVERY​

{
  "channel": "RCS",
  "eventType": "DELIVERY",
  "messageId": "uuid",
  "destination": "+393401234567",
  "statusCode": 3,
  "description": "delivered",
  "eventDate": "2025-10-16T10:42:18Z"
}

statusCode: 3 = consegnato, 6 = non consegnabile

READ​

{
  "channel": "RCS",
  "eventType": "READ",
  "messageId": "uuid",
  "destination": "+393401234567",
  "eventDate": "2025-10-16T10:43:00Z"
}

INBOUND​

{
  "channel": "RCS",
  "eventType": "INBOUND",
  "messageId": "msg-id",
  "source": "+393471488489",
  "destination": "+393209998877",
  "receivedDate": "2025-10-31T10:59:05.099Z",
  "messageType": "TEXT",
  "text": "Messaggio di risposta dell'utente"
}

messageType: TEXT, IMAGE, AUDIO, VIDEO. Per media, il campo mediaKey contiene la chiave per il download via /api/files/{mediaKey}.

Authentication​

API Key fornita da AgileTelecom

Security Scheme Type:

apiKey

Header parameter name:

X-Api-Key

Contact

AgileTelecom:

URL: https://agiletelecom.com

Ultimo aggiornamento il