Invia un messaggio dall'agente a un utente.
L'utente deve essere abilitato RCS e raggiungibile dalla piattaforma RBM affinché l'agente possa inviare correttamente un messaggio. Una volta inviato il messaggio, la chiamata viene restituita senza alcun errore. In caso contrario, l'agente riceve un codice di errore.
Se l'utente è online, la piattaforma RBM consegna il messaggio immediatamente. In caso contrario, la piattaforma RBM mette in coda il messaggio e lo consegna quando l'utente si trova di nuovo online.
La piattaforma RBM ignora qualsiasi messaggio dell'agente inviato con un ID utilizzato da un messaggio o evento precedente inviato dallo stesso agente.
I messaggi dell'agente possono essere revocati tra il momento in cui vengono inviati e il momento in cui vengono recapitati.
Richiesta HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri | |
|---|---|
parent |
"phones/{E.164}", dove {E.164} è il numero di telefono dell'utente in formato E.164. Ad esempio, per il numero di telefono statunitense +1-222-333-4444, il valore sarà phone/+12223334444 e l'endpoint risultante sarebbe https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages. |
Parametri di ricerca
| Parametri | |
|---|---|
messageId |
L'ID univoco del messaggio assegnato dall'agente. Deve essere un UUID, come definito in https://tools.ietf.org/html/rfc4122. La piattaforma RBM ignora qualsiasi messaggio dell'agente inviato con un ID utilizzato da un messaggio o evento precedente inviato dallo stesso agente. |
agentId |
Obbligatorio. L'identificatore univoco dell'agente. |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di AgentMessage.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di AgentMessage appena creata.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.