Method: phones.testers.create

Invita un utente a testare un agente.

L'utente invitato deve essere abilitato per RCS e raggiungibile dalla piattaforma RBM. Quando un agente invita un utente a diventare tester, un agente di gestione della piattaforma RBM invia un messaggio all'utente per chiedergli di confermare che vuole essere un tester dell'agente. Dopo la conferma, l'utente diventa un tester.

Un agente non ancora lanciato può interagire soltanto con gli utenti che sono tester dell'agente. Se un agente non avviato tenta di inviare un messaggio, un evento o un callback di funzionalità a un non tester, la piattaforma RBM restituisce un errore 403 PERMISSION_DENIED.

Un agente può inviare 20 richieste di tester al giorno per un massimo di 200 richieste di tester. Se invii richieste di tester superiori a questi limiti, la piattaforma RBM restituisce una risposta 429 RESOURCE_EXHAUSTED.

Richiesta HTTP

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

"phones/{E.164}", dove {E.164} è il numero di telefono dell'utente in formato E.164. Ad esempio, con il numero di telefono statunitense +1-222-333-4444, l'endpoint risultante sarebbe https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/.

Parametri di ricerca

Parametri
agentId

string

Obbligatorio. L'identificatore univoco dell'agente.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Tester.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Tester 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.