call: subscribeToTone
Espacio de nombres: microsoft.graph
Suscríbase a DTMF (señalización multifrecuencia de tono dual) que le permite recibir notificaciones cuando el usuario presiona las teclas en un "dialpad".
Nota:
La acción subscribeToTone solo se admite para las llamadas que se inician con serviceHostedMediaConfig.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
---|---|---|
Delegado (cuenta profesional o educativa) | No admitida. | No admitida. |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | Calls.AccessMedia.All | No disponible. |
Nota: Es posible que los datos de tono proporcionados no se conserven. Asegúrese de que cumple con las leyes y regulaciones de su área con respecto a la protección de datos y la confidencialidad de las comunicaciones. Consulte las Condiciones de uso y consulte con su asesor legal para obtener más información.
Solicitud HTTP
POST /communications/calls/{id}/subscribeToTone
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.
Parámetro | Tipo | Descripción |
---|---|---|
clientContext | Cadena | Cadena de contexto de cliente única. Puede tener un máximo de 256 caracteres. |
Respuesta
Si se ejecuta correctamente, este método devuelve el código de respuesta 200 OK
.
Ejemplo
En el siguiente ejemplo se muestra cómo llamar a esta API.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/v1.0/communications/calls/{id}/subscribeToTone
Content-Type: application/json
Content-Length: 46
{
"clientContext": "fd1c7836-4d84-4e24-b6aa-23188688cc54"
}
Respuesta
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-Type: application/json
Location: https://graph.microsoft.com/v1.0/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896/operations/0fe0623f-d628-42ed-b4bd-8ac290072cc5
{
"@odata.type": "#microsoft.graph.subscribeToToneOperation",
"clientContext": "clientContext-value",
"id": "0fe0623f-d628-42ed-b4bd-8ac290072cc5",
"status": "completed"
}
Notificación: notificación de tono
La notificación contiene información del tono presionado en el recurso toneinfo .
POST https://bot.contoso.com/api/calls
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.commsNotifications",
"value": [
{
"@odata.type": "#microsoft.graph.commsNotification",
"changeType": "updated",
"resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896",
"resourceData": {
"@odata.type": "#microsoft.graph.call",
"state": "established",
"toneInfo": {
"@odata.type": "#microsoft.graph.toneInfo",
"sequenceId": 1,
"tone": "tone1"
}
}
}
]
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de