Messaggi

Visualizza la cronologia dei messaggi della tua organizzazione.

Elencare i messaggi

GET /v1/messages

Recupera una lista paginata di messaggi (SMS, email, ecc.).

Scope richiesto: messages:read

Parametri di query

Parametro	Tipo	Descrizione
page	integer	Numero pagina (default: 1)
limit	integer	Risultati per pagina (default: 20, max: 100)
channel	string	Filtra per canale: sms, email, whatsapp

Esempio

curl "https://api.replicer.ai/v1/messages?channel=sms&limit=10" \
  -H "Authorization: Bearer rpl_live_your_key"

Risposta 200 OK

{
  "data": [
    {
      "id": "clx-msg-001",
      "channel": "sms",
      "direction": "OUTBOUND",
      "status": "delivered",
      "fromAddress": "+0987654321",
      "toAddress": "+1234567890",
      "subject": null,
      "body": "Ciao Mario, confermo il tuo appuntamento domani alle 14.",
      "externalId": "ext-sms-abc",
      "errorMessage": null,
      "createdAt": "2026-04-05T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 30,
    "totalPages": 3
  },
  "requestId": "req-abc123"
}

Campi del messaggio

Campo	Tipo	Descrizione
id	string	ID univoco del messaggio
channel	string	Canale di consegna (sms, email, whatsapp)
direction	string	INBOUND o OUTBOUND
status	string	Stato della consegna
fromAddress	string	Indirizzo/numero mittente
toAddress	string	Indirizzo/numero destinatario
subject	string | null	Oggetto email (null per SMS)
body	string	Contenuto del messaggio
externalId	string | null	ID messaggio del provider esterno
errorMessage	string | null	Dettagli errore se la consegna è fallita
createdAt	string	Timestamp ISO 8601

---

Inviare SMS

POST /v1/messages/sms

In arrivo

Questo endpoint è pianificato ma non ancora disponibile. Attualmente restituisce 503 Not Implemented.

Scope richiesto: messages:write

Un worker di messaggistica dedicato in Go è in fase di sviluppo. Una volta disponibile, questo endpoint ti permetterà di inviare SMS in modo programmatico.