View a markdown version of this page

Invio di messaggi di testo RCS - AWS SMS di messaggistica per l'utente finale
In che modo i messaggi di testo RCS differiscono dagli SMSRcsMessageContent struttura per i messaggi di testoInvio di un messaggio di testoFallback tramite SMS o MMSLimiti per i messaggi di testoQuando usare i messaggi di testo

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Invio di messaggi di testo RCS

A TextMessage è il tipo di contenuto più semplice che puoi inviare con l'SendRcsMessageAPI. È costituito da un testo semplice (fino a 3.072 caratteri) con chip di suggerimento opzionali che appaiono come pulsanti interattivi sotto il messaggio.

In che modo i messaggi di testo RCS differiscono dagli SMS

I messaggi di testo inviati tramite (SMS) SendRcsMessage differiscono da quelli inviati tramite SendTextMessage (SMS) in due modi:

  • Chip di suggerimento: puoi allegare fino a 11 chip di suggerimento a un messaggio di testo RCS. Con questi chip, i destinatari possono rispondere, aprire un URL, chiamare un numero di telefono, condividere una posizione o creare un evento sul calendario in un unico passaggio. Gli SMS non supportano i suggerimenti.

  • Single-message consegna: un messaggio di testo RCS arriva come messaggio singolo indipendentemente dalla lunghezza (fino a 3.072 caratteri). I corrieri suddividono i messaggi SMS più lunghi di 160 caratteri in più segmenti, che potrebbero arrivare fuori ordine o con ritardi tra i segmenti.

Per informazioni dettagliate su tutti i tipi di suggerimenti disponibili e sui relativi parametri, consulta. Configurazione dei suggerimenti RCS

RcsMessageContent struttura per i messaggi di testo

Quando si chiamaSendRcsMessage, si passa il payload del messaggio come RcsMessageContent parametro. Per un messaggio di testo, impostate il Content campo su un TextMessage oggetto contenente una Body stringa. Per includere chip di suggerimento, aggiungi un Suggestions array come fratello di primo livello di. Content

Il seguente frammento di codice JSON mostra la struttura di un messaggio di RcsMessageContent testo con suggerimenti:

{
  "Content": {
    "TextMessage": {
      "Body": "What would you like to do?"
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Check order status",
        "PostbackData": "action=check_order"
      }
    },
    {
      "OpenUrl": {
        "Text": "View details",
        "PostbackData": "action=view",
        "Url": "https://example.com/orders/1234"
      }
    }
  ]
}

In questo esempio:

  • Content.TextMessage.Bodycontiene il testo del messaggio (obbligatorio, da 1 a 3.072 caratteri).

  • Suggestionsè un array di primo livello (opzionale, fino a 11 elementi). Ogni suggerimento richiede un Text campo (fino a 25 caratteri) e un PostbackData campo (fino a 2.048 caratteri).

L'Suggestionsarray supporta sei tipi di azioni:Reply,,OpenUrl, DialPhoneShowLocation, RequestLocation e. CreateCalendarEvent È possibile combinare diversi tipi di suggerimenti in un unico messaggio. Per i dettagli completi su ciascun tipo, vedereConfigurazione dei suggerimenti RCS.

Invio di un messaggio di testo

Per inviare un messaggio di testo RCS, chiamate SendRcsMessage con i seguenti parametri obbligatori:

  • DestinationPhoneNumber: il numero di telefono del destinatario in E.164 formato.

  • OriginationIdentity: l'ID del pool o l'agente AWS RCS che invia il messaggio.

  • RcsMessageContent: La stringa JSON Content contenente un TextMessage oggetto.

Puoi chiamare l'API utilizzando l'AWS CLI (aws pinpoint-sms-voice-v2 send-rcs-message) o un SDK AWS come il client boto3. pinpoint-sms-voice-v2

Fallback tramite SMS o MMS

Se il dispositivo del destinatario non supporta RCS o è temporaneamente irraggiungibile sul canale RCS, puoi configurare il messaggio in modo che ritorni a SMS o MMS. Per abilitare il fallback, includi un oggetto nella richiesta. FallbackConfiguration SendRcsMessage FallbackConfigurationspecifica il canale di fallback (SMSoMMS), il corpo del messaggio di fallback e l'identità di origine (un numero di telefono o un ID mittente) da utilizzare per il messaggio di fallback.

Il fallback è facoltativo. Se si omette FallbackConfiguration e il destinatario non può ricevere RCS, il messaggio non viene recapitato.

Per ulteriori informazioni sulla configurazione del comportamento di fallback, consulta. Invio di messaggi RCS complessi

Limiti per i messaggi di testo

Risorsa Limite Note
Corpo del messaggio (Body) 3.072 caratteri () UTF-8 Obbligatorio. Deve contenere almeno 1 carattere.
Suggerimenti per messaggio 11 Totale combinato di risposte e azioni.
Testo di visualizzazione del suggerimento () Text 25 caratteri Si applica a tutti i tipi di suggerimenti.
Dati di postback () PostbackData 2,048 caratteri Obbligatorio per tutti i tipi di suggerimenti.

Quando usare i messaggi di testo

Utilizzare TextMessage per:

  • Notifiche come conferme d'ordine, aggiornamenti sulla spedizione e promemoria degli appuntamenti.

  • One-time password e codici di verifica.

  • Prompt conversazionali che offrono opzioni di risposta come chip di suggerimento, che consentono interazioni guidate senza immissione di testo libero.

  • Brevi aggiornamenti di stato in cui il contenuto non richiede immagini o layout strutturati.

Per i messaggi che richiedono immagini, video o layout strutturati con titoli e descrizioni, utilizza invece rich card o caroselli. Per informazioni, consulta Invio di messaggi RCS complessi.