¿Qué son las notificaciones de llamada?
El módulo de Notificaciones de llamada le permite enviar automáticamente datos de llamadas a una URL de su elección. Estas notificaciones de llamada se envían a la URL especificada para todas las llamadas dentro de su entorno del portal.
Al integrar estas notificaciones de llamada con su software CRM, puede ver quién llamó, la hora de la llamada y su duración.
Las notificaciones de llamada se activan para llamadas entrantes, internas y salientes. También puede utilizar las notificaciones de llamada para otros fines, como medir estadísticas de llamadas.
Asegúrese de consultar Webhooks para maximizar las capacidades de su servicio telefónico.
Los activadores de notificación de llamada
Durante una llamada, se envía información a la URL especificada en seis momentos diferentes para llamadas entrantes, internas y salientes: Creada, Sonando, Respondida, Transferencia caliente, Transferencia fría 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 leer 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: Si una llamada es entrante (
inbound) o saliente (outbound). El evento created solo se envía para llamadas entrantes. - caller: Información sobre la persona que llama.
- number: El número de teléfono que está utilizando la persona que llama.
- name: El nombre de la persona que 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 hacia dónde se dirige la llamada.
- number: El número de teléfono que marcó la persona que llama.
Sonando
Se envía una notificación ringing cuando los teléfonos comienzan a sonar debido a una llamada entrante.
Es posible que se envíen múltiples notificaciones ringing de forma sucesiva 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: Si una llamada es entrante (
inbound) o saliente (outbound). Las llamadas entre compañeros se marcan comooutbound. - caller: Información sobre la persona que llama.
- number: El número de teléfono que está utilizando la persona que llama.
- name: El nombre de la persona que 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 hacia dónde se dirige 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 está llamando. Generalmente 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, esto es casi siempre
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.
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 suceder 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: Indica si una llamada es entrante (
inbound) o saliente (outbound). Las llamadas entre colegas se marcan comooutbound. - caller: Información sobre la persona que llama.
- number: El número de teléfono que está utilizando 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 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ó la persona que llama.
- 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 está llamando. Normalmente es el mismo que destination.number, pero puede cambiar si la llamada es desviada.
- 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.
Transferencia asistida
Se envía una notificación warm-transfer cuando una llamada es transferida de forma "asistida". En una transferencia asistida, quien transfiere primero llama al nuevo participante, este responde, habla con quien transfiere y luego se transfiere la llamada.
La llamada de quien transfiere al tercero 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: Indica si una llamada es entrante (
inbound) o saliente (outbound). Las llamadas entre colegas se marcan comooutbound. - caller: Información sobre la persona que llama.
- number: El número de teléfono que está utilizando 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 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ó la persona que llama.
- 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 está llamando. Normalmente es el mismo que destination.number, pero puede cambiar si la llamada es desviada.
- 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.
Transferencia directa
Se envía una notificación cold-transfer cuando una llamada es transferida de forma directa. En una transferencia directa, quien transfiere llama al nuevo participante pero transfiere la llamada sin esperar a ver si alguien responde o quién responde.
Hay dos diferencias clave entre una cold-transfer y una warm-transfer:
- En una transferencia asistida siempre hay un destinatario, mientras que en una transferencia directa puede haber varios (por ejemplo, si la llamada se transfiere a un Grupo de llamadas).
- Para una transferencia asistida, primero se generan notificaciones
ringingein-progress. En una transferencia directa, solo se envía una notificaciónringing, y una notificaciónin-progressse envía únicamente si el tercero responde a la llamada.
La llamada del transferidor a la tercera parte también genera una notificación 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 siempre es
inbound. - caller: Información sobre el llamante.
- number: El número de teléfono que utiliza el llamante.
- name: El nombre del llamante.
- 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 están 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 marcado por el llamante.
- targets: Los teléfonos que están sonando para esta llamada. Los teléfonos que no están localizables 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 localizables (cuando estén disponibles; puede ser un array vacío).
- user_numbers: Los números internos de los Usuarios que están localizables (cuando estén disponibles; 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 el redireccionador.
- name: El nombre del redireccionador.
- 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 están localizables (cuando estén disponibles; puede ser un array vacío).
- user_emails: Las direcciones de correo electrónico de los Usuarios.
Colgar (ended)
Se envía una notificación ended cuando finaliza una llamada. Existen varias razones por las que una llamada puede terminar.
Se puede enviar una notificación ended después de una notificación in-progress si la llamada fue colgada por uno de los participantes, después de una notificación 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:
- completed: The call was successfully completed.
- busy: The call was rejected, the callee was busy.
- no-answer: No one answered the call for various reasons.
- failed: An error occurred preventing the call from being established.
- cancelled: The caller hung up before anyone could answer.
- abandon: The caller hung up while waiting in the queue.
- 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 comooutbound. - caller: Información sobre el llamante.
- number: El número de teléfono que utiliza el llamante.
- name: El nombre del llamante.
- 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 están 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 marcado por el llamante.
Orden de las notificaciones
Se envían múltiples notificaciones para cada llamada. Las notificaciones enviadas dependen de cómo se gestione la llamada. A continuación se muestra el orden de las notificaciones para los tipos de llamadas más comunes.
Llamada simple
Una llamada exitosa con dos participantes:
- ringing - A llama a B
- in-progress - A llama a B
- ended - A llama a B (motivo:
completed)
Sin respuesta
El teléfono de la persona llamada suena pero no se responde.
- ringing - A llama a B
- ended - A llama a B (motivo:
busyono-answerdependiendo 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 responde.
- 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, se transfiere la llamada. 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 y C
- ended - A y C cuelgan (motivo:
completed)
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 a 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 y C
- in-progress - A llama a C
- ended - A ya no llama a C (motivo:
completed)
Transferencia semiatendida
En una transferencia semiatendida (transferencia tibia), A primero llama 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 responda.
- ringing - A llama a B
- in-progress - A llama a B
- ringing - B llama a C
- cold-transfer - B conecta A y C
- in-progress - A llama a C
- ended - A ya no llama a C (motivo:
completed)
Captura de llamada
Cuando dos teléfonos están en el mismo grupo de respuesta, es posible capturar 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)
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 responde.
Configuración de notificaciones de llamada
- 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 utilizar 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.
- Pulse Guardar.
Nota: esto solo es necesario si su paquete emite un token de API.
Ejemplos de integraciones
A continuación, algunos ejemplos de integraciones en combinación con Zapier:
- Enviar un mensaje a Slack para una llamada perdida.
- Enviar un correo electrónico para una llamada perdida.
- Integración con Robin.
- Integración con Microsoft Flow
- Integración con Zapier
Y un ejemplo con N8N y nuestra API de transcripción de llamadas
Obtener transcripciones de llamadas automáticamente usando N8NPreguntas frecuentes
Los webhooks se activan en un punto específico del plan de marcado y solo funcionan para llamadas entrantes. Si es necesario, se puede utilizar una URL diferente para cada webhook configurado. Un webhook se activa en un único momento.
Las notificaciones de llamada funcionan tanto para llamadas entrantes como salientes. Para más detalles, consulte:
WebhooksCon las notificaciones de llamada, la URL puede activarse en seis puntos diferentes del ciclo de vida de la llamada.
Llamadas entrantes, salientes e internas.
Se envía un formulario en formato JSON a la URL del cliente.
- Para webhooks, utilice una solicitud GET.
- Para notificaciones de llamada, utilice una solicitud POST.
Páginas relacionadas
