Meetings API Rückrufe

Die Meetings API Callbacks ermöglichen es Ihnen, Informationen über Sitzungsereignisse, Teilnehmeraktivitäten, Aufzeichnungsdetails und Raumabläufe zu erhalten.

Konfigurieren von Rückrufen

Um Rückrufe zu verwenden, aktivieren Sie die Meetings API-Funktion in Ihrer Anwendung über die Vonage API Dashboard. Es gibt drei URLs, die Sie konfigurieren können:

Enable the Meetings API for your application using the dashboard
  • Zimmer-URL - Erhalten Sie Informationen über die von Ihnen verwalteten Konferenzräume.
  • URL der Sitzungen - Informieren Sie sich über die Sitzungen, z. B. über die Anfangszeit, die Teilnehmer und vieles mehr.
  • Aufnahme-URL - Sie erhalten Informationen zur Aufzeichnung und Download-Links, sobald sie verfügbar sind.

Arten von Rückrufen

In der folgenden Tabelle werden die einzelnen Arten von Rückrufmeldungen beschrieben:

Name Beschreibung
room:expired Der Raum ist inaktiv. Für inaktive Räume können keine Sitzungen erstellt werden.
session:started Eine Sitzung hat begonnen.
session:ended Eine Sitzung ist beendet.
recording:started Eine Aufzeichnung beginnt innerhalb einer Sitzung.
recording:ended Eine Aufzeichnung wurde innerhalb einer Sitzung gestoppt.
recording:uploaded Eine Aufnahme steht zum Herunterladen bereit.
participant:joined Jemand hat sich einer Sitzung angeschlossen.
session:participant:left Jemand hat eine Sitzung verlassen.

Beispiel-Nutzlasten

Zimmer Abgelaufen

Eine Benachrichtigung, dass ein Raum abgelaufen ist. Für inaktive Räume können keine Sitzungen erstellt werden.

{
   "event": "room:expired",
   "room_id": "9f6fe8ae-3458-4a72-b532-8276d5533e97",
   "room_type": "instant",
   "expires_at": "2023-06-06T06:55:07.134Z",
   "created_at": "2023-06-06T06:45:07.135Z"
}

Begonnene Sitzung

Eine Benachrichtigung, dass eine Sitzung begonnen hat.

{
    "event": "session:started",
    "session_id": "2_MX40NjMzOTg5Mn5-MTYzNTg2ODQwODY4NH41cXIzMDdSa1BZa05BUDFpYnhxcTV4MCt-fg",
    "room_id": "b307d837-c0ce-4619-8c5c-70e418ef9693",
    "started_at": "2021-11-02T15:53:28.753Z"
}

Sitzung beendet

Eine Benachrichtigung, dass eine Sitzung beendet wurde.

{
   "event": "session:ended",
   "session_id": "2_MX40NjMwODczMn5-MTU3NTgyODEwNzQ2MH5OZDJrVmdBRUNDbG5MUzNqNX20yQ1Z-fg",
   "room_id": "9f6fe8ae-3458-4a72-b532-8276d5533e97",
   "started_at": "2023-06-06T07:15:13.974Z",
   "ended_at": "2023-06-06T08:15:13.974Z"
}

Aufnahme gestartet

Eine Benachrichtigung, dass die Aufzeichnung für eine Sitzung begonnen hat.

{
   "event": "recording:started",
   "recording_id": "9f6fe8ae-3458-4a72-b532-8276d5533e97",
   "session_id": "2_MX40NjMwODczMn5-MTU3NTgyODEwNzQ2MH5OZDJrVmdBRUNDbG5MUzNqNX20yQ1Z-fg"
}

Aufnahme Beendet

Eine Benachrichtigung, dass die Aufzeichnung für eine Sitzung beendet wurde.

{
   "event": "recording:ended",
   "recording_id": "9f6fe8ae-3458-4a72-b532-8276d5533e97",
   "session_id": "2_MX40NjMwODczMn5-MTU3NTgyODEwNzQ2MH5OZDJrVmdBRUNDbG5MUzNqNX20yQ1Z-fg",
   "started_at": "2023-06-06T07:15:13.974Z",
   "ended_at": "2023-06-06T08:15:13.974Z",
   "duration": 3600
}

Aufnahme hochgeladen

Eine Benachrichtigung, dass eine Aufzeichnung einer Sitzung hochgeladen wurde und über die url.

{
   "event": "recording:uploaded",
   "recording_id": "9f6fe8ae-3458-4a72-b532-8276d5533e97",
   "session_id": "2_MX40NjMwODczMn5-MTU3NTgyODEwNzQ2MH5OZDJrVmdBRUNDbG5MUzNqNX20yQ1Z-fg",
   "room_id": "9f6fe8ae-3458-4a72-b532-8276d5533e97",
   "started_at": "2023-06-06T07:15:13.974Z",
   "ended_at": "2023-06-06T08:15:13.974Z",
   "duration": "2023-06-06T08:15:13.974Z",
   "url": "https://prod-meetings-recordings.s3.amazonaws.com/123/9f6fe8ae-3458-4a72-b532-8276d5533e97/archive.mp4"
}

Teilnehmer Verbunden

Eine Benachrichtigung über den Eintritt einer Person in eine Sitzung.

{
    "event": "session:participant:joined",
    "participant_id": "b424e1c4-e988-4ce2-8ab9-e3efea7de542",
    "session_id": "2_MX40NjMzOTg5Mn5-MTYzNTg2ODQwODY4NH41cXIzMDdSa1BZa05BUDFpYnhxcTV4MCt-fg",
    "room_id": "b307d837-c0ce-4619-8c5c-70e418ef9693",
    "name": "New Joiner",
    "type": "Guest",
    "is_host": true
}

Eine Benachrichtigung darüber, dass jemand eine Sitzung verlässt.

{
   "event": "session:participant:left",
   "participant_id": "9f6fe8ae-3458-4a72-b532-8276d5533e97",
   "session_id": "2_MX40NjMwODczMn5-MTU3NTgyODEwNzQ2MH5OZDJrVmdBRUNDbG5MUzNqNX20yQ1Z-fg",
   "room_id": "9f6fe8ae-3458-4a72-b532-8276d5533e97",
   "name": "John Doe",
   "type": "Guest",
   "is_host": true
}