Call Media - Send Dtmf Tones

Servizio:

Communication

Versione API:

2025-05-15

Inviare toni dtmf.

POST {endpoint}/calling/callConnections/{callConnectionId}:sendDtmfTones?api-version=2025-05-15

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
callConnectionId	path	True	string	ID connessione di chiamata
endpoint	path	True	string (url)	Endpoint della risorsa di comunicazione di Azure.
api-version	query	True	string	Versione dell'API da richiamare.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Authorization	True	string	Token di accesso utente di Servizi di comunicazione di Azure.
Repeatability-Request-ID		string (uuid)	Se specificato, il client indirizza che la richiesta è ripetibile; ovvero, che il client può effettuare la richiesta più volte con la stessa ripetibilità-Request-Id e ottenere una risposta appropriata senza che il server eseeseguono la richiesta più volte. Il valore di Repeatability-Request-Id è una stringa opaca che rappresenta un identificatore univoco generato dal client per la richiesta. Si tratta di un UUID versione 4 (casuale).
Repeatability-First-Sent		string (date-time-rfc1123)	Se viene specificata l'intestazione Repeatability-Request-ID, è necessario specificare anche l'intestazione Repeatability-First-Sent. Il valore deve essere la data e l'ora in cui la richiesta è stata creata per la prima volta, espressa utilizzando il formato IMF-fixdate di HTTP-date. Esempio: Sun, 06 Novembre 1994 08:49:37 GMT.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
targetParticipant	True	CommunicationIdentifierModel
tones	True	Tone[]	Elenco di toni da inviare al partecipante di destinazione.
operationCallbackUri		string	Impostare un URI di callback che esegue l'override dell'URI di callback predefinito impostato da CreateCall/AnswerCall per questa operazione. Questa configurazione è per azione. Se non è impostato, verrà usato l'URI di callback predefinito impostato da CreateCall/AnswerCall.
operationContext		string	Valore per identificare il contesto dell'operazione.

Risposte

Nome	Tipo	Descrizione
202 Accepted	SendDtmfTonesResult	Il servizio ha accettato la richiesta di invio dei toni dtmf e inizierà a elaborarlo. Riceverai l'evento SendDtmfTonesCompleted o SendDtmfTonesFailed nell'URI di callback specificato per aggiornarti sullo stato della richiesta.
Other Status Codes	CommunicationErrorResponse	Errore

Sicurezza

Authorization

Token di accesso utente di Servizi di comunicazione di Azure.

Tipo: apiKey
In: header

Esempio

CallMedia_SendDtmfTones

Esempio di richiesta

HTTP

POST https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c:sendDtmfTones?api-version=2025-05-15

{
  "tones": [
    "zero"
  ],
  "targetParticipant": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_da7be3a9-8788-42a6-85c6-56b2cf784fce"
    }
  },
  "operationContext": "sendDtmf operation context",
  "operationCallbackUri": "https://app.contoso.com/callback"
}

Risposta di esempio

Codice di stato:

202

{
  "operationContext": "sendDtmf operation context"
}

Definizioni

Nome	Descrizione
SendDtmfTonesRequest
SendDtmfTonesResult
Tone

SendDtmfTonesRequest

Object

Nome	Tipo	Descrizione
operationCallbackUri	string	Impostare un URI di callback che esegue l'override dell'URI di callback predefinito impostato da CreateCall/AnswerCall per questa operazione. Questa configurazione è per azione. Se non è impostato, verrà usato l'URI di callback predefinito impostato da CreateCall/AnswerCall.
operationContext	string	Valore per identificare il contesto dell'operazione.
targetParticipant	CommunicationIdentifierModel
tones	Tone[]	Elenco di toni da inviare al partecipante di destinazione.

SendDtmfTonesResult

Object

Nome	Tipo	Descrizione
operationContext	string	Contesto dell'operazione fornito dal client.

Tone

Enumerazione

Valore	Descrizione
zero
one
two
three
four
five
six
seven
eight
nine
a
b
c
d
pound
asterisk