Invia un evento dall'agente a un utente.
Gli eventi dell'agente possono essere utilizzati per indicare che l'agente ha letto un messaggio dell'utente o che l'agente sta digitando (il che aggiunge un elemento umano all'esperienza RCS for Business). Se l'utente non ha attivato RCS, la piattaforma RCS for Business restituisce un errore NOT_FOUND (HTTP 404). Se l'utente ha attivato RCS, ma al momento non è raggiungibile, la piattaforma restituisce una risposta 200 OK e gestisce la consegna in base al tipo di evento. Gli eventi dell'agente vengono inseriti in una coda store-and-forward per un massimo di 30 giorni e vengono inviati quando l'utente torna online. Solo gli eventi IS_TYPING sono effimeri e non vengono messi in coda.
A differenza dei messaggi dell'agente, gli eventi dell'agente non possono essere revocati dopo l'invio.
Richiesta HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents
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 nel formato E.164. Ad esempio, per un utente con il numero di telefono statunitense +1-222-333-4444, il valore sarebbe phones/+12223334444 e l'endpoint risultante sarebbe https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents. |
Parametri di query
| Parametri | |
|---|---|
eventId |
L'ID dell'evento, assegnato dall'agente. Deve essere un UUID, come definito in https://tools.ietf.org/html/rfc4122. La piattaforma RCS for Business 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 AgentEvent.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di AgentEvent appena creata.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
Per saperne di più, consulta la OAuth 2.0 Overview.