Meetings API Détails techniques

Contenu

• Meetings API ou Video API ?: Déterminer l'API la plus adaptée à votre projet.
• Terminologie: Termes clés et définitions pour la Meetings API.
• Types de chambres: Définit les types de chambres disponibles.
• Embarquement sur le site web et l'application: Utilisez un iFrame pour intégrer une réunion dans un site web ou une application.
• Référence: Plus d'informations sur l'API Meetings.
• Tarification: Informations sur les coûts d'utilisation de la Meetings API.

Meetings API ou Video API ?

Les API Meetings et Video API vous permettent d'utiliser des réunions vidéo interactives de haute qualité dans vos applications web. L'API Meetings est idéale pour ceux qui souhaitent des réunions prêtes à l'emploi avec une personnalisation limitée ; il suffit de quelques lignes de code pour générer une réunion et l'intégrer dans votre application. L'API Video est idéale pour ceux qui souhaitent davantage de personnalisation et de flexibilité, mais elle nécessitera plus d'efforts de développement.

Jetez un coup d'œil à la Video API pour plus d'informations.

Terminologie

• Chambre: l'espace virtuel dans lequel se déroule la réunion vidéo. Voir Types de chambres ci-dessous.
• Les participants:
  • PropriétaireLe créateur de l'espace : généralement le créateur de l'espace, cette personne dispose de capacités d'administration particulières.
  • Invité: personnes participant à la réunion. Les invités ont accès aux fonctions standard des réunions.
  • Chaque salle peut accueillir jusqu'à 250 participants avec 25 flux vidéo actifs.
• Mise en place et configuration:
  • Demande: l'extrait de code que vous soumettez pour configurer une salle.
  • Réponse: les données qui sont renvoyées à la suite de votre demande.
  • ID de la salle de réunion: le ID est un identifiant de session qui est renvoyé dans la réponse à une demande de réunion.
  • SessionLa durée de l'enquête : définie comme l'ensemble des événements qui se produisent pendant cette période, depuis l'arrivée du premier participant jusqu'au départ du dernier.
  • URL de l'invité: salle de réunion URL utilisée par les hôtes.
  • URL de l'hôteURL de la salle de réunion : URL de la salle de réunion avec des fonctionnalités d'administration de la réunion utilisées par l'hôte.
  • Thème: l'ensemble des couleurs, logos et styles à appliquer à des pièces données du Account.
• Caractéristiques:
  • Label blancla possibilité de créer des salles avec des marques ou des couleurs spécifiques.
  • Chat: espace permettant d'envoyer des messages écrits visibles par tous les participants de la salle.
  • EnregistrementEnregistrement des réunions : vous pouvez lancer un enregistrement manuellement pendant une réunion, ou programmer l'enregistrement automatique de la réunion lors de l'envoi d'une demande. Vous pouvez également choisir de n'enregistrer que le propriétaire de la salle.
  • Gestion des sallesLe système de gestion des salles : vous pouvez supprimer, mettre à jour ou récupérer des informations sur les salles.
  • RappelsLes informations relatives à une session : vous permettent de recevoir des informations sur une session.
  • Salle d'attente: définit le niveau d'approbation requis pour participer à la réunion. Les participants rejoindront la salle d'attente jusqu'à ce que le propriétaire les ait rejoints ou jusqu'à ce que le propriétaire les ait admis, en fonction du niveau d'approbation requis.

Types de chambres

Il existe deux types de chambres :

• Chambre instantanée:
  • Créé pour une réunion en cours.
  • Il est actif pendant dix (10) minutes jusqu'à ce que le premier participant rejoigne la salle. Si personne ne rejoint la salle dans les dix minutes, la salle est supprimée.
  • Il est actif pendant dix minutes après le départ du dernier participant, puis il est supprimé.
• Chambre à long terme:
  • Reste en vie jusqu'à la date d'expiration que vous avez spécifiée (maximum un an).
  • Généralement lié à une réunion, une personne ou une ressource récurrente.
  • Vous devrez spécifier une date d'expiration (au format ISO).
  • Permet de demander qu'une salle soit automatiquement supprimée dix minutes après le départ du dernier participant.

Intégration de sites web et d'applications

Une réunion créée via l'API peut être intégrée à votre site web et à vos applications mobiles. Pour ce faire, générez le lien de la réunion et créez une iFrame à l'aide de la fonction GUEST_URL:

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

Ce service est actuellement pris en charge à la fois par les ordinateurs de bureau et les téléphones portables utilisant les navigateurs suivants :

• Desktop - Pris en charge par les navigateurs Firefox et Chrome.
• iOS 14+ - Prise en charge sur Safari, Edge ou Firefox.
• Android - Pris en charge par le navigateur Chrome ou Samsung v14+.

La réunion peut être affichée dans n'importe quelle taille supérieure à 360PX, mais le nombre de fonctionnalités disponibles dépend de la taille de l'iFrame :

¹ L'enregistrement est toujours possible dans les réunions 360-500PX en réglant le paramètre auto_record dans l'appel à l'API.

Tarification

Le prix est basé sur le nombre de minutes du participant et de l'enregistrement.

Procès-verbal du participant

Une minute-participant est facturée par participant et par minute dans une session ; le tarif par minute est déterminé par le nombre de minutes-participant que vous utilisez par mois :

Par exemple, si vous avez utilisé jusqu'à 100 000 minutes de participation, il vous en coûtera 1,14 € pour un appel d'une heure avec 4 participants, facturé à 0,00475 € par minute.

Enregistrement du procès-verbal

Une minute d'enregistrement est facturée par minute d'enregistrement d'une session ; le tarif par minute est déterminé par le nombre de minutes d'enregistrement que vous utilisez par mois :

Par exemple, si vous avez utilisé jusqu'à 50 000 minutes, il vous en coûtera 2,10 euros pour enregistrer un appel d'une heure, facturé 0,035 euro par minute.

Référence

• Référence de l'API Meetings