Call Media - Send Dtmf Tones

Serviço:

Communication

Versão da API:

2024-09-15

Envie tons dtmf.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
callConnectionId	path	True	string	O ID de conexão de chamada
endpoint	path	True	string url	O ponto de extremidade do recurso de Comunicação do Azure.
api-version	query	True	string	Versão da API a invocar.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
Authorization	True	string	Um token de acesso de usuário dos Serviços de Comunicação do Azure.
Repeatability-Request-ID		string uuid	Se especificado, o cliente direciona que a solicitação é repetível; ou seja, que o cliente pode fazer a solicitação várias vezes com o mesmoRequest-Id de repetibilidade e obter de volta uma resposta apropriada sem que o servidor execute a solicitação várias vezes. O valor daRequest-Id Repeatability- é uma cadeia de caracteres opaca que representa um identificador exclusivo gerado pelo cliente para a solicitação. É uma versão 4 (aleatória) UUID.
Repeatability-First-Sent		string date-time-rfc1123	Se o cabeçalho Repeatability-Request-ID for especificado, o cabeçalho Repeatability-First-Sent também deverá ser especificado. O valor deve ser a data e a hora em que a solicitação foi criada pela primeira vez, expressa usando a forma IMF-fixdate de HTTP-date. Exemplo: Sun, 06 nov 1994 08:49:37 GMT.

Corpo do Pedido

Name	Necessário	Tipo	Description
targetParticipant	True	CommunicationIdentifierModel
tones	True	Tone[]	Lista de tons a enviar ao participante-alvo.
operationCallbackUri		string	Defina um URI de retorno de chamada que substitua o URI de retorno de chamada padrão definido por CreateCall/AnswerCall para esta operação. Esta configuração é por ação. Se isso não estiver definido, o URI de retorno de chamada padrão definido por CreateCall/AnswerCall será usado.
operationContext		string	O valor para identificar o contexto da operação.

Respostas

Name	Tipo	Description
202 Accepted	SendDtmfTonesResult	O serviço aceitou o pedido de envio de tons dtmf e começará a processá-lo. Você receberá o evento SendDtmfTonesCompleted ou SendDtmfTonesFailed no URI de retorno de chamada especificado para atualizá-lo sobre o status da solicitação.
Other Status Codes	CommunicationErrorResponse	Erro

Segurança

Authorization

Um token de acesso de usuário dos Serviços de Comunicação do Azure.

Tipo: apiKey
Em: header

Exemplos

CallMedia_SendDtmfTones

Pedido de amostra

HTTP

POST https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c:sendDtmfTones?api-version=2024-09-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"
}

Resposta da amostra

Código de estado:

202

{
  "operationContext": "sendDtmf operation context"
}

Definições

Name	Description
SendDtmfTonesRequest
SendDtmfTonesResult
Tone

SendDtmfTonesRequest

Name	Tipo	Description
operationCallbackUri	string	Defina um URI de retorno de chamada que substitua o URI de retorno de chamada padrão definido por CreateCall/AnswerCall para esta operação. Esta configuração é por ação. Se isso não estiver definido, o URI de retorno de chamada padrão definido por CreateCall/AnswerCall será usado.
operationContext	string	O valor para identificar o contexto da operação.
targetParticipant	CommunicationIdentifierModel
tones	Tone[]	Lista de tons a enviar ao participante-alvo.

SendDtmfTonesResult

Name	Tipo	Description
operationContext	string	O contexto da operação fornecido pelo cliente.

Tone

Name	Tipo	Description
a	string
asterisk	string
b	string
c	string
d	string
eight	string
five	string
four	string
nine	string
one	string
pound	string
seven	string
six	string
three	string
two	string
zero	string