Meetings API Detalles técnicos

Product deprecation notice

Starting on August 31st 2024, users will no longer be able to create Meetings API applications. Existing applications will continue to work uninterrupted until June 30th, 2025. If you are looking to build with video, please consider Vonage Video API or Vonage Video Express services, or contact your account managers or support for help.

Contenido

¿Meetings API o Video API?

Tanto la Meetings API como la Video API le permiten utilizar reuniones de vídeo interactivas de alta calidad en sus aplicaciones web. La Meetings API es ideal para quienes desean reuniones plug and play con una personalización limitada; sólo se necesitan unas pocas líneas de código para generar una reunión e incrustarla en su aplicación. La Video API es ideal para quienes desean una mayor personalización y flexibilidad, pero requerirá un mayor esfuerzo de desarrollo.

Eche un vistazo al Video API para más información.

Terminología

  • Habitación: el espacio virtual en el que tiene lugar la videoconferencia. Véase Tipos de habitaciones abajo.
  • Participantes:
    • PropietarioCreador de la sala: suele ser el creador de la sala, esta persona tiene capacidades especiales de administración.
    • Invitadopersonas asistentes a la reunión. Los invitados tienen acceso a los servicios de reunión estándar.
    • Cada sala puede albergar hasta 250 participantes con 25 secuencias de vídeo activas.
  • Instalación y configuración:
    • Solicitar: el fragmento de código que envíe para crear una sala.
    • Respuesta: los datos que se devuelven de su solicitud.
    • ID de la sala de reuniones: el ID es un identificador de sesión que se devuelve en la respuesta a una solicitud de reunión.
    • Sesión: se define como todos los eventos que ocurren durante este tiempo, desde que se incorpora el primer participante, hasta que se marcha el último.
    • URL para invitados: sala de reuniones URL utilizada por los huéspedes.
    • URL del host: URL de la sala de reuniones con funciones de administración de reuniones utilizada por el anfitrión.
    • Tema: el conjunto de colores, logotipos y estilos que se aplicarán a determinadas habitaciones de la Account.
  • Características:
    • Marca blancaCapacidad para crear salas con marcas o combinaciones de colores específicas.
    • Chatespacio para enviar mensajes escritos que sean visibles para todos los asistentes en la sala.
    • Grabación: puede iniciar una grabación manualmente durante una reunión, o configurar la reunión para que se grabe automáticamente al enviar una solicitud. También puede optar por grabar únicamente al propietario de la sala.
    • Gestión de salas: puede eliminar, actualizar o recuperar información sobre las habitaciones.
    • Devoluciones de llamada: permiten recibir información sobre una sesión.
    • Sala de espera: establece el nivel de aprobación necesario para unirse a la reunión. Los participantes se incorporarán a la sala de espera hasta que el propietario se haya incorporado o hasta que el propietario los haya admitido, en función del nivel de aprobación necesario.

Tipos de habitaciones

Hay dos tipos de habitaciones:

  • Habitación instantánea:
    • Creado para una reunión que está teniendo lugar ahora.
    • Activa durante diez (10) minutos hasta que el primer participante se una a la sala. Si nadie se une a la sala en esos diez minutos, la sala se elimina.
    • Activa durante diez minutos después de que se vaya el último participante, después se borra.
  • Habitación de larga duración:
    • Permanece vivo hasta la fecha de caducidad que especifiques (máximo un año).
    • Normalmente vinculado a una reunión, persona o recurso recurrente.
    • Le pedirá que especifique una fecha de caducidad (en formato ISO).
    • Permite solicitar que una sala se elimine automáticamente diez minutos después de que el último participante abandone la sala.

Nota: puede crear hasta mil habitaciones por aplicación. Si necesita más que esto, póngase en contacto con el equipo de Meetings API.

Inserción en sitios web y aplicaciones

Una reunión creada a través de la API puede incrustarse en su sitio web y aplicaciones móviles. Para ello, genere el enlace de la reunión y cree un iFrame utilizando la función GUEST_URL:

<iframe src="$GUEST_URL" title="Embedded Meeting" allow="camera;microphone;display-capture"></iframe>

Actualmente es compatible tanto para ordenadores de sobremesa como para teléfonos móviles utilizando los siguientes navegadores:

  • Escritorio - Compatible con los navegadores Firefox y Chrome.
  • iOS 14+ - Compatible con Safari, Edge o Firefox.
  • Android - Compatible con los navegadores Chrome o Samsung v14+.

La reunión puede visualizarse en cualquier tamaño superior a 360PX, aunque el número de funciones disponibles depende del tamaño del iFrame:

Característica 360-500PX 500-600PX 600PX+
Micrófono
Vídeo
Registro ¹
Compartir pantalla
Reacciones
Privacidad
Pizarra
Ver juntos
Mesa redonda
Fin de la reunión

¹ La grabación sigue estando disponible en las reuniones 360-500PX configurando la opción auto_record en la llamada a la API.

También deberá enviar una solicitud por correo electrónico a la dirección Equipo Meetings API para etiquetar el dominio del sitio web en el que se utiliza el iFrame.

Precios

El precio se basa en los minutos de grabación y de participación.

Actas de los participantes

El minuto de participante se cobra por participante y por minuto de sesión; la tarifa por minuto se determina en función de cuántos minutos de participante utilice al mes:

En A Tasa por minuto
0 100,000 €0.00475
100,000 1,000,000 €0.00428
1,000,000 5,000,000 €0.00385
5,000,000 15,000,000 €0.00327
15,000,000 Adelante €0.00262

Por ejemplo, si ha utilizado hasta 100.000 minutos de participante, le costaría 1,14 euros una llamada de una hora con 4 participantes, tarificada a 0,00475 euros por minuto.

Registro de actas

Un minuto de grabación se cobra por minuto de grabación de una sesión; la tarifa por minuto se determina en función de cuántos minutos de grabación utilice al mes:

En A Tasa por minuto
0 50,000 €0.035
50,001 250,000 €0.029
250,001 500,000 €0.027
500,001 1,000,000 €0.023
1,000,001 2,000,000 €0.0185
2,000,001 Adelante €0.016

Por ejemplo, si ha utilizado hasta 50.000 minutos, le costaría 2,10 euros grabar una llamada de una hora, cobrada a 0,035 euros por minuto.

El coste total de una llamada realizada a través de la Meetings API = Minutos de participante + Minutos de grabación. En los ejemplos anteriores, el coste total sería €1.14 + €2.10 = €3.24

Referencia