Invia un evento dall'agente a un utente.
Gli eventi agente possono essere utilizzati per indicare che l'agente ha letto un messaggio dell'utente o che l'agente è in fase di digitazione (aggiunta di un elemento umano all'esperienza RBM). Se RBM non è in grado di raggiungere l'utente, la piattaforma restituisce 404 NOT_FOUND
.
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 in formato E.164. Ad esempio, per un utente con 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/agentEvents. |
Parametri di ricerca
Parametri | |
---|---|
eventId |
L'ID dell'evento 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 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 ulteriori informazioni, consulta la Panoramica di OAuth 2.0.