Referencia de sucesos de registro de CDR
Para los sucesos cdr_logged
enviados por un webhook de registro, el objeto payload
contiene datos sobre un suceso de CDR (Registro de detalles de llamadas) gestionado por la integración telefónica. El objeto payload
para un suceso CDR contiene las propiedades siguientes.
Propiedad | Tipo | Descripción |
---|---|---|
primary_phone_number |
serie | Número de teléfono al que se ha llamado. |
global_session_id |
serie | Identificador de sesión exclusivo. |
failure_occurred |
booleano | Si se ha producido una anomalía durante la llamada. |
failure_details |
serie | Detalles sobre cualquier anomalía que se haya producido. |
transfer_occurred |
booleano | Si se intentó transferir una llamada. |
active_calls |
Número | Número de llamadas activas al iniciar la llamada. |
x-global-sip-trunk-call-id |
serie |
Valor del encabezado de ID de llamada troncal SIP extraído de la solicitud inicial SIP
|
call |
Objecto | Información sobre la llamada. Consulte call . |
session_initiation_protocol |
Objecto | Detalles relacionados con el protocolo SIP. Consulte session_initiation_protocol . |
max_response_milliseconds |
Objecto | Latencia máxima para los servicios utilizados durante la llamada. Consulte max_response_milliseconds . |
assistant_interaction_summaries |
Matriz | Detalles sobre las interacciones de watsonx Assistant que tuvieron lugar durante la llamada. Consulte assistant_interaction_summaries . |
injected_custom_data |
Objecto | Conjunto de pares clave/valor extraídos de la variable de contexto cdr_custom_data . |
warnings_and_errors |
Matriz | Advertencias o errores registrados durante la llamada. Consulte warnings_and_errors . |
realtime_transport_network_summary |
Objecto | Estadísticas para la corriente de entrada del objeto inbound_stream y estadísticas para la corriente de salida del objeto outbound_stream . Sólo se incluye si se ha habilitado RTCP. Consulte realtime_transport_network_summary . |
call
El objeto call
contiene las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
start_timestamp |
Serie | Hora de inicio de la llamada, en formato ISO ( yyyy-MM-ddTHH:mm:ss.SSSZ ). |
stop_timestamp |
Serie | Hora a la que finalizó la llamada, en formato ISO ( yyyy-MM-ddTHH:mm:ss.SSSZ ). |
milliseconds_elapsed |
Número | Duración de la llamada, en milisegundos. |
end_reason |
serie | Razón por la que ha finalizado la llamada. Las razones posibles son: -assistant_transfer -assistant_hangup -caller_hangup -failed |
security.media_encrypted |
Boolean | Si el soporte se ha cifrado. |
security.signaling_encrypted |
Boolean | Si la señalización SIP se ha cifrado. |
security.sip_authenticated |
Boolean | Si se ha utilizado la autenticación de SIP para autenticar al interlocutor. |
session_initiation_protocol
El objeto session_initiation_protocol
contiene las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
invite_arrival_timestamp |
Serie | Hora a la que ha llegado la solicitud INVITE , en formato ISO (yyyy-MM-ddTHH:mm:ss.SSSZ ). |
setup_milliseconds |
Número | Tiempo que tardó en establecerse la llamada, en milisegundos. Tiempo transcurrido entre la recepción de la solicitud SIP INVITE inicial y la recepción de la solicitud SIP ACK final. |
headers.call_id |
Serie | Campo de cabecera SIP Call-ID extraído del SIP INVITE relacionado con la llamada. |
headers.from_uri |
Serie | URI SIP de la cabecera inicial SIP INVITE From . |
headers.to_uri |
Serie | URI SIP de la cabecera inicial SIP INVITE To . |
assistant_interaction_summaries
El objeto assistant_interaction_summaries
contiene las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
assistant_id |
Serie | Identificador único del asistente. |
session_id |
Serie | Identificador único de la sesión. |
turns |
Matriz | Una matriz de objetos que describen las interacciones de watsonx Assistant que se han producido durante la conversación. Consulte assistant_interaction_summaries.turns[] . |
assistant_interaction_summaries.turns[]
Los objetos de la matriz assistant_interaction_summaries.turns
contienen las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
assistant.log_id |
Serie | Identificador exclusivo para el suceso registrado, que se puede utilizar para correlacionar entre registros de mensajes y sucesos CDR. |
assistant.start_timestamp |
Serie | Hora a la que se envió la solicitud al asistente, en formato ISO ( yyyy-MM-ddTHH:mm:ss.SSSZ ). |
assistant.response_milliseconds |
Número | Tiempo (en milisegundos) transcurrido entre el envío de la solicitud y la recepción de la respuesta del asistente. |
request |
Objecto | Solicitud enviada al asistente. Consulte assistant_interaction_summaries.turns[].request . |
response |
Matriz | Matriz de los objetos response asociados a la solicitud. |
assistant_interaction_summaries.turns[].request
El objeto assistant_interaction_summaries.turns[].request
contiene las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
type |
Serie |
Tipo de solicitud:
|
streaming_statistics |
Objecto | Información y estadísticas relacionadas con el reconocimiento Speech to Text. Consulte assistant_interaction_summaries.turns[].request.streaming_statistics . |
assistant_interaction_summaries.turns[].request.streaming_statistics
El objeto assistant_interaction_summaries.turns[].request.streaming_statistics
contiene las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
transaction_id |
Serie | Identificador único de la transacción. |
start_timestamp |
Serie | Hora de inicio de la transacción, en formato ISO ( yyyy-MM-ddTHH:mm:ss.SSSZ ). |
stop_timestamp |
Serie | Hora a la que finalizó la transacción, en formato ISO ( yyyy-MM-ddTHH:mm:ss.SSSZ ). |
response_milliseconds |
Número | Latencia, en milisegundos, entre el momento en el que se detecta el silencio en el discurso del interlocutor y el momento en el que se recibe un resultado final del asistente. |
echo_detected |
Boolean | Si se ha detectado un eco. |
confidence |
Número | Puntuación de confianza del enunciado final. |
assistant_interaction_summaries.turns[].response
El objeto assistant_interaction_summaries.turns[].response
contiene las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
type |
Serie |
Tipo de respuesta:
|
barge_in_occurred |
Boolean | Si se ha producido alguna irrupción durante el turno. |
streaming_statistics |
Objecto | Información y estadísticas relacionadas con la síntesis y reproducción Text to Speech. Consulte assistant_interaction_summaries.turns[].response.streaming_statistics . |
Correlación entre los tipos de respuesta de CDR y de watsonx Assistant
Los valores de la propiedad type
corresponden a los tipos de respuesta watsonx Assistant.
Tipo de respuesta de CDR | Tipo de respuesta de watsonx Assistant |
---|---|
text_to_speech |
text |
url |
audio |
dtmf |
dtmf , command_info.type : send |
sms |
user_defined , vgwAction.command : vgwActSendSMS |
transfer |
connect_to_agent |
text_to_speech_config |
text_to_speech , command_info.type : configure |
speech_to_text_config |
speech_to_text , command_info.type : configure |
unpause_speech_to_text |
start_activities , type :speech_to_text_recognition |
pause_speech_to_text |
stop_activities , type :speech_to_text_recognition |
unpause_dtmf |
start_activities , type :dtmf_collection |
pause_dtmf |
stop_activities , type :dtmf_collection |
enable_speech_barge_in |
text_to_speech , command_info.type : enable_barge_in |
disable_speech_barge_in |
text_to_speech , command_info.type : disable_barge_in |
enable_dtmf_barge_in |
dtmf , command_info.type : enable_barge_in |
disable_dtmf_barge_in |
dtmf , command_info.type : disable_barge_in |
hangup |
end_session |
assistant_interaction_summaries.turns[].response.streaming_statistics
El objeto assistant_interaction_summaries.turns[].response.streaming_statistics
contiene las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
transaction_id |
Serie | Identificador único de la transacción. |
start_timestamp |
Serie | Hora de inicio de la transacción, en formato ISO ( yyyy-MM-ddTHH:mm:ss.SSSZ ). |
stop_timestamp |
Serie | Hora a la que finalizó la transacción, en formato ISO ( yyyy-MM-ddTHH:mm:ss.SSSZ ). |
response_milliseconds |
Número | Tiempo (en milisegundos) entre el momento en que se envía un texto al asistente y el momento en que la integración telefónica recibe el primer paquete de audio sintetizado. |
warnings_and_errors
El objeto warnings_and_errors
contiene advertencias y errores que se registraron durante la llamada, que se enumeran por orden de aparición. Se incluyen advertencias para las siguientes afecciones.
- Mensajes cuando las expresiones se filtran según el umbral de puntuación de confianza.
- Subdesbordamientos de Text to Speech, que se producen cuando la síntesis de Text to Speech no puede seguir el ritmo de la velocidad de transmisión de la integración telefónica y es posible que se produzcan saltos en el audio.
- Avisos de red RTP, como, por ejemplo, un alto nivel de pérdida de paquetes o un jitter promedio alto, si se ha habilitado RTCP.
El ejemplo siguiente muestra la estructura del objeto warnings_and_errors
:
"warnings_and_errors": [
{
"message": "CWSMR0032W: A Watson Speech to Text final utterance has a confidence score of 0.1, which does not meet the confidence score threshold of 0.2. The utterance will be ignored.",
"id": "CWSMR0032W"
},
{
"message": "CWSMR0031W: The synthesis stream from the Watson Text-to-Speech service can't keep up with the playback rate to the caller, so audio might skip. transaction ID=a1b2c3d4e5",
"id": "CWSMR0031W"
}
]
El objeto de cada aviso contiene las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
message |
Serie | Texto del mensaje de advertencia. |
id |
Serie | Identificador de mensaje exclusivo. |
max_response_milliseconds
El objeto max_response_milliseconds
contiene las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
assistant |
Número | Latencia máxima de ida y vuelta (en milisegundos), calculada a partir de todas las solicitudes watsonx Assistant relacionadas con la llamada. |
text_to_speech |
Número | Tiempo máximo (en milisegundos) entre el momento en que se envía una expresión de texto al servicio Text to Speech y el momento en que la integración telefónica recibe el primer paquete de audio sintetizado. Este valor se calcula a partir de todas las solicitudes de Text to Speech relacionadas con la llamada. |
speech_to_text |
Número | Latencia máxima (en milisegundos) entre el momento en que se detecta silencio en el habla de la persona que llama y el momento en que se recibe un resultado final del servicio Speech to Text. Este valor se calcula a partir de todos los resultados de reconocimiento de Speech to Text relacionados con la llamada. |
realtime_transport_network_summary
Si se habilita RTCP, el objeto realtime_transport_network_summary
proporciona estadísticas para la corriente de entrada en el objeto inbound_stream
y estadísticas para la corriente de salida en el objeto outbound_stream
.
El siguiente ejemplo muestra la estructura del objeto realtime_transport_network_summary
.
"realtime_transport_network_summary": {
"inbound_stream": {
"maximum_jitter": 5,
"average_jitter": 1,
"packets_lost": 0,
"packets_transmitted": 1000,
"canonical_name": "user@example.com",
"tool_name": "User SIP Phone"
},
"outbound_stream": {
"maximum_jitter": 5,
"average_jitter": 1,
"packets_lost": 0,
"packets_transmitted": 2000,
"canonical_name": "voice.gateway@127.0.0.1",
"tool_name": "IBM Voice Gateway/1.0.0.5"
}
}
El objeto de cada flujo contiene las siguientes propiedades.
Propiedades | Tipo | Descripción |
---|---|---|
maximum_jitter |
Número | Fluctuación máxima durante la llamada. |
average_jitter |
Número | Fluctuación media calculada sobre la duración de la llamada. |
packets_lost |
Número | Estimación del número de paquetes que se han perdido durante la llamada. |
packets_transmitted |
Número | Estimación del número total de paquetes transmitidos durante la llamada. |
canonical_name |
Serie | Identificador único del remitente del flujo, normalmente en formato @ . |
tool_name |
Serie | Nombre de la aplicación o herramienta donde se originó el flujo. Para la integración telefónica, el valor predeterminado es IBM Voice Gateway/ . |