Notificaciones de llamada

• Call notifications_send_summary_events: Si marca esta casilla, se incluirán resúmenes de llamadas con las notificaciones de llamada. Tenga en cuenta: Intelligence debe estar habilitado para que esto funcione.
• Call notifications_send_transcription_events: Si marca esta casilla, se incluirán transcripciones de llamadas con las notificaciones de llamada. Tenga en cuenta: Intelligence debe estar habilitado para que esto funcione.
• Descripción: Asigne a esta notificación de llamada un nombre que reconozca de un vistazo. Solo lo verá su equipo, nunca quien llama.
• Servicio: Elija dónde se envía esta notificación: seleccione Personalizado para configurarla usted mismo, o Robin para enviarla directamente a la integración Robin.
• URL de webhook: Pegue la URL completa del webhook, incluyendo https://, donde desea que se envíen estas notificaciones.

Durante una llamada, la información se envía a la URL especificada en seis momentos diferentes para llamadas entrantes, internas y salientes: Creada, Sonando, Respondida, Transferencia asistida, Transferencia directa y Colgada. Las notificaciones se envían a la URL especificada en varios eventos importantes durante una llamada. Las notificaciones se envían como una solicitud POST con los datos en un documento JSON. A continuación, puede ver qué información se envía exactamente.

Creada

Un evento created se activa cuando se inicia una llamada entrante.

• call_id: Una cadena única para identificar la llamada.
• timestamp: La fecha y hora en que se genera el webhook, en formato ISO 8601.
• status: El estado de la llamada. Para este tipo de notificación, es created.
• version: Un atributo de versión que puede utilizarse en el futuro para migrar a otra versión de los webhooks. Actualmente, siempre es v2.
• direction: Indica si una llamada es entrante (inbound) o saliente (outbound). El evento creado solo se envía para llamadas entrantes.
• caller: Información sobre quien llama.
• number: El número de teléfono que está utilizando quien llama.
• name: El nombre de quien llama.
• account_number: Esta información no se envía con el evento created.
• user_numbers: Esta información no se envía con el evento created.
• user_emails: Esta información no se envía con el evento created.
• destination: Información sobre el destino de la llamada.
• number: El número de teléfono que marcó quien llama.

Sonando

Una notificación ringing se envía cuando los teléfonos comienzan a sonar debido a una llamada entrante.

Es posible que se envíen varias notificaciones ringing en sucesión a medida que nuevos dispositivos comienzan a sonar.

• call_id: Una cadena única para identificar la llamada.
• timestamp: La fecha y hora en que se genera el webhook, en formato ISO 8601.
• status: El estado de la llamada. Para este tipo de notificación, es ringing.
• version: Un atributo de versión que puede utilizarse en el futuro para migrar a otra versión de los webhooks. Actualmente, siempre es v2.
• direction: Indica si una llamada es entrante (inbound) o saliente (outbound). Las llamadas entre compañeros se marcan como outbound.
• caller: Información sobre quien llama.
• number: El número de teléfono que está utilizando quien llama.
• name: El nombre de quien llama.
• account_number: Esta información no se envía con el evento ringing.
• user_numbers: Esta información no se envía con el evento ringing.
• user_emails: Esta información no se envía con el evento ringing.
• destination: Información sobre el destino de la llamada.
• number: El número de teléfono que marcó quien llama.
• targets: Los teléfonos que están sonando para esta llamada. Los teléfonos que no están accesibles no se muestran.
• number: El número al que se está llamando. Normalmente es el mismo que destination.number, pero puede cambiar si la llamada se desvía.
• name: El nombre de la persona a la que se llama. Para llamadas entrantes, casi siempre es null.
• account_number: Los números internos de los usuarios que han configurado su Cuenta VoIP para estar disponibles (cuando esté disponible, puede ser un array vacío).
• user_numbers: Los números internos de los usuarios que están disponibles (cuando esté disponible, puede ser un array vacío).
• user_emails: Las direcciones de correo electrónico de los usuarios.

Respondida (en curso)

Se envía una notificación in-progress cuando se responde una llamada.

Nota: El target que responde la llamada no siempre es uno de los dispositivos que sonaron inicialmente. Debido a la captura de llamadas, puede ocurrir que la llamada se responda en un dispositivo diferente.

• call_id: Una cadena única para identificar la llamada.
• timestamp: La fecha y hora en que se genera el webhook, en formato ISO 8601.
• status: El estado de la llamada. Para este tipo de notificación, es in-progress.
• version: Un atributo de versión que puede utilizarse en el futuro para migrar a otra versión de los webhooks. Actualmente, siempre es v2.
• direction: Si una llamada es entrante (inbound) o saliente (outbound). Las llamadas entre compañeros se marcan como outbound.
• caller: Información sobre la persona que llama.
• number: El número de teléfono que utiliza la persona que llama.
• name: El nombre de la persona que llama.
• account_number: El número interno de la Cuenta VoIP (cuando está disponible, para las llamadas entrantes casi siempre es null).
• user_numbers: Los números internos de los Usuarios que son accesibles (cuando está disponible, puede ser un array vacío).
• user_emails: Las direcciones de correo electrónico de los Usuarios.
• destination: Información sobre el destino de la llamada.
• number: El número de teléfono que marcó la persona que llama.
• targets: Los teléfonos que están sonando para esta llamada. Los teléfonos que no son accesibles no se muestran.
• number: El número al que se llama. Normalmente es el mismo que destination.number, pero puede cambiar si la llamada se desvía.
• name: El nombre de la persona a la que se llama. Para las llamadas entrantes, casi siempre es null.
• account_number: Los números internos de los Usuarios que han configurado su Cuenta VoIP para ser accesibles (cuando está disponible, puede ser un array vacío).
• user_numbers: Los números internos de los Usuarios que son accesibles (cuando está disponible, puede ser un array vacío).
• user_emails: Las direcciones de correo electrónico de los Usuarios.

Transferencia asistida

Se envía una notificación warm-transfer cuando una llamada se transfiere de forma "asistida". En una transferencia asistida, la persona que transfiere primero llama al nuevo participante, el nuevo participante responde, habla con la persona que transfiere, y luego se transfiere la llamada.

La llamada de la persona que transfiere a la tercera parte también genera notificaciones ringing e in-progress con su propio call_id. Durante una transferencia, estas dos llamadas se fusionan esencialmente en una sola llamada. El call_id de una de las dos llamadas se utiliza entonces para la llamada posterior a la transferencia. El otro call_id se incluye en la transferencia como merged_id y luego se descarta.

• call_id: Una cadena única para identificar la llamada, heredada de una de las llamadas anteriores.
• merged_id: El call_id de la otra llamada anterior, que ya no se utilizará.
• timestamp: La fecha y hora en que se genera el webhook, en formato ISO 8601.
• status: El estado de la llamada. Para este tipo de notificación, es transfer.
• version: Un atributo de versión que puede utilizarse en el futuro para migrar a otra versión de los webhooks. Actualmente, siempre es v2.
• direction: Si una llamada es entrante (inbound) o saliente (outbound). Las llamadas entre compañeros se marcan como outbound.
• caller: Información sobre la persona que llama.
• number: El número de teléfono que utiliza la persona que llama.
• name: El nombre de la persona que llama.
• account_number: El número interno de la Cuenta VoIP (cuando está disponible, para las llamadas entrantes casi siempre es null).
• user_numbers: Los números internos de los Usuarios que son accesibles (cuando está disponible, puede ser un array vacío).
• user_emails: Las direcciones de correo electrónico de los Usuarios.
• destination: Información sobre el destino de la llamada.
• number: El número de teléfono que marcó la persona que llama.
• targets: Los teléfonos que están sonando para esta llamada. Los teléfonos que no son accesibles no se muestran.
• number: El número al que se llama. Normalmente es el mismo que destination.number, pero puede cambiar si la llamada se desvía.
• name: El nombre de la persona a la que se llama. Para las llamadas entrantes, casi siempre es null.
• account_number: Los números internos de los Usuarios que han configurado su Cuenta VoIP para ser accesibles (cuando está disponible, puede ser un array vacío).
• user_numbers: Los números internos de los Usuarios que son accesibles (cuando está disponible, puede ser un array vacío).
• user_emails: Las direcciones de correo electrónico de los Usuarios.
• redirector: Información sobre el participante que realizó la transferencia.
• number: El número de teléfono que utiliza la persona que redirige.
• name: El nombre de la persona que redirige.
• account_number: El número interno de la Cuenta VoIP (cuando está disponible, para las llamadas entrantes casi siempre es null).
• user_numbers: Los números internos de los Usuarios que son accesibles (cuando está disponible, puede ser un array vacío).
• user_emails: Las direcciones de correo electrónico de los Usuarios.

Transferencia en frío

Se envía una notificación de cold-transfer cuando una llamada se transfiere en frío. En una transferencia en frío, quien transfiere llama al nuevo participante, pero transfiere la llamada sin esperar a ver si alguien contesta o quién lo hace.

Existen dos diferencias clave entre un cold-transfer y un warm-transfer:

• En una transferencia en caliente siempre hay una parte llamada, mientras que en una transferencia en frío puede haber varias (por ejemplo, si la llamada se transfiere a un Grupo de llamadas).
• Para una transferencia en caliente, primero se generan notificaciones de ringing e in-progress. En una transferencia en frío, solo se envía una notificación de ringing, y una notificación de in-progress solo sigue si el tercero contesta la llamada.

La llamada de quien transfiere al tercero también genera una notificación de ringing con su propio call_id. Durante una transferencia, estas dos llamadas se fusionan esencialmente en una sola llamada. El call_id de una de las dos llamadas se utiliza entonces para la llamada después de la transferencia. El otro call_id se incluye en la transferencia como merged_id y luego se descarta.

• call_id: Una cadena única para identificar la llamada, heredada de una de las llamadas anteriores.
• merged_id: El call_id de la otra llamada anterior, que ya no se utilizará.
• timestamp: La fecha y hora en que se genera el webhook, en formato ISO 8601.
• status: El estado de la llamada. Para este tipo de notificación, es transfer.
• version: Un atributo de versión que puede utilizarse en el futuro para migrar a otra versión de los webhooks. Actualmente, siempre es v2.
• direction: Si una llamada es entrante o saliente. Actualmente, solo se admiten Llamadas Entrantes, por lo que este valor es siempre inbound.
• caller: Información sobre el interlocutor.
• number: El número de teléfono que está utilizando el interlocutor.
• name: El nombre del interlocutor.
• account_number: El número interno de la Cuenta VoIP (cuando esté disponible; para Llamadas Entrantes casi siempre es null).
• user_numbers: Los números internos de los Usuarios que son localizables (cuando esté disponible, puede ser un array vacío).
• user_emails: Las direcciones de correo electrónico de los Usuarios.
• destination: Información sobre el destino de la llamada.
• number: El número de teléfono que marcó el interlocutor.
• targets: Los teléfonos que están sonando para esta llamada. Los teléfonos que no son localizables no se muestran.
• number: El número al que se llama. Normalmente es el mismo que destination.number, pero puede cambiar si la llamada se desvía.
• name: El nombre de la persona a la que se llama. Para Llamadas Entrantes, casi siempre es null.
• account_number: Los números internos de los Usuarios que han configurado su Cuenta VoIP para ser localizables (cuando esté disponible, puede ser un array vacío).
• user_numbers: Los números internos de los Usuarios que son localizables (cuando esté disponible, puede ser un array vacío).
• user_emails: Las direcciones de correo electrónico de los Usuarios.
• redirector: Información sobre el participante que realizó la transferencia.
• number: El número de teléfono que está utilizando quien redirige.
• name: El nombre de quien redirige.
• account_number: El número interno de la Cuenta VoIP (cuando esté disponible; para Llamadas Entrantes casi siempre es null).
• user_numbers: Los números internos de los Usuarios que son localizables (cuando esté disponible, puede ser un array vacío).
• user_emails: Las direcciones de correo electrónico de los Usuarios.

Colgar (finalizada)

Se envía una notificación de ended cuando una llamada finaliza. Existen varios motivos por los que una llamada puede terminar.

Se puede enviar una notificación de ended después de una notificación de in-progress si la llamada fue colgada por uno de los participantes, después de una notificación de ringing si nadie contestó, o como única notificación si no había dispositivos localizables.

• call_id: Una cadena única para identificar la llamada.
• timestamp: La fecha y hora en que se genera el webhook, en formato ISO 8601.
• status: El estado de la llamada. Para este tipo de notificación, es ended.
• reason: El motivo por el que finalizó la llamada. El motivo puede ser uno de los siguientes valores:
1. completed: La llamada se completó correctamente.
2. busy: La llamada fue rechazada, el destinatario estaba ocupado.
3. no-answer: Nadie contestó la llamada por diversos motivos.
4. failed: Se produjo un error que impidió que se estableciera la llamada.
5. cancelled: El interlocutor colgó antes de que alguien pudiera contestar.
6. abandon: El interlocutor colgó mientras esperaba en la Cola.
• version: Un atributo de versión que puede utilizarse en el futuro para migrar a otra versión de los webhooks. Actualmente, siempre es v2.
• direction: Si una llamada es entrante (inbound) o saliente (outbound). Las Llamadas entre compañeros se marcan como outbound.
• caller: Información sobre el interlocutor.
• number: El número de teléfono que está utilizando el interlocutor.
• name: El nombre de quien llama.
• account_number: El número interno de la Cuenta VoIP (cuando esté disponible; para llamadas entrantes esto es casi siempre null).
• user_numbers: Los números internos de los Usuarios que son localizables (cuando estén disponibles, puede ser un array vacío).
• user_emails: Las direcciones de correo electrónico de los Usuarios.
• destination: Información sobre el destino de la llamada.
• number: El número de teléfono al que llamó quien llama.

Transcripción creada

Se envía una notificación call_transcription cuando la transcripción está lista.

Si Voys Intelligence está habilitado. Este es el primer evento que seguirá a una notificación ended. Si los resúmenes de llamadas están habilitados, el evento summary seguirá pronto.

{            
  "call_id": "ua0-grq-prd-1780997460.58680",
  "call_transcription": "Speaker 1: Hi how are you.\nSpeaker 2: Hey great that you called.",        
}

Resumen creado

Se envía una notificación summary cuando el resumen de la llamada está listo.

Si Voys Intelligence está habilitado. Este es el último evento para una llamada específica.

{
  "call_id": "ua0-grq-prd-1780997460.58680", 
  "summary": "This was a great call."
}

• ringing - A llama a B
• in-progress - A llama a B
• ended - A llama a B (motivo: completed)

Llamada simple con Voys Intelligence habilitado

Una llamada exitosa con dos participantes:

• ringing - A llama a B
• in-progress - A llama a B
• ended - A llama a B (motivo: completed)
• call_transcription - la transcripción de la llamada está lista
• summary - el resumen de la llamada está listo

Sin respuesta

El teléfono de la persona llamada suena pero no se contesta.

• ringing - A llama a B
• ended - A llama a B (motivo: busy o no-answer dependiendo del dispositivo)

Persona llamada no disponible

La persona llamada no está disponible (por ejemplo, el teléfono está configurado en No molestar), por lo que el teléfono no suena y la llamada no se contesta.

• ended - A llama a B (motivo: busy)

Transferencia atendida

En una transferencia atendida (transferencia cálida), A primero llama a B, luego uno de los participantes transfiere la llamada a C. El participante primero llama a C, y después de haber hablado, la llamada se transfiere. Solo los participantes A y C permanecen en la llamada.

• ringing - A llama a B
• in-progress - A llama a B
• ringing - B llama a C
• in-progress - B llama a C
• warm-transfer - B conecta a A y C
• ended - A y C cuelgan (motivo: completed)
• call_transcription - la transcripción de la llamada está lista (una por tramo de llamada, si está habilitado)
• summary - el resumen de la llamada está listo (uno por tramo de llamada, si está habilitado)

Transferencia ciega

En una transferencia ciega (transferencia fría), A primero llama a B, luego uno de los participantes transfiere la llamada a C sin esperar para ver si C está disponible.

• ringing - A llama a B
• in-progress - A llama a B
• ringing - B llama a C
• cold-transfer - B conecta a A y C
• in-progress - A llama a C
• ended - A ya no llama a C (motivo: completed)
• call_transcription - la transcripción de la llamada está lista
• summary - el resumen de la llamada está listo

Transferencia semi-atendida

En una transferencia semi-atendida (transferencia tibia), A llama primero a B, luego uno de los participantes transfiere la llamada a C. El participante intenta llamar a C primero pero transfiere la llamada antes de que C conteste.

• ringing - A llama a B
• in-progress - A llama a B
• ringing - B llama a C
• cold-transfer - B conecta a A y C
• in-progress - A llama a C
• ended - A ya no llama a C (motivo: completed)
• call_transcription - la transcripción de la llamada está lista
• summary - el resumen de la llamada está listo

Respuesta de llamada

Cuando dos teléfonos están en el mismo Grupo de respuesta, es posible responder desde un teléfono una llamada destinada a otro teléfono.

• ringing - A llama a B
• in-progress - A llama a C
• ended - A ya no llama a C (motivo: completed)
• call_transcription - la transcripción de la llamada está lista
• summary - el resumen de la llamada está listo

Desvío de llamadas

Cuando un Usuario configura su teléfono para desviar automáticamente las llamadas entrantes a otro número.

• ringing - A llama a B
• ringing - A llama a B y C
• in-progress o ended, dependiendo de si alguien contesta.
• call_transcription - la transcripción de la llamada está lista
• summary - el resumen de la llamada está listo

Se envían varias notificaciones para cada llamada. Las notificaciones enviadas dependen de cómo se gestione la llamada. A continuación se muestra el orden de notificaciones para los tipos de llamadas más comunes.

Llamada simple

Una llamada exitosa con dos participantes:

• Vaya a Notificaciones de llamada.
• Haga clic en Añadir.
• Introduzca una descripción en el campo Descripción para especificar el propósito de la notificación.
• Elija 'Personalizado' en las Opciones de Paquete a menos que prefiera usar una opción estándar.
• Complete la URL donde deben enviarse las notificaciones de conversación.
• Complete el Token de API si su paquete seleccionado proporciona uno.

Nota: esto solo es necesario si su paquete emite un token de API.

• Pulse Guardar.