Fähigkeiten verwalten
Die vonage apps capabilities können Sie die Ihrer Anwendung zugeordneten Vonage API-Funktionen hinzufügen, aktualisieren und entfernen.
Hinzufügen und Aktualisieren einer Fähigkeit
Um einer Anwendung eine neue Fähigkeit hinzuzufügen oder die Einstellungen einer Fähigkeit zu aktualisieren, für deren Verwendung eine Anwendung bereits konfiguriert wurde, führen Sie den Befehl vonage apps capabilities update <application-id> <capability>.
Jede API hat einen anderen Satz von Flags für die zugehörigen Einstellungen, die konfiguriert werden müssen; die Liste der Flags für jede API finden Sie im entsprechenden Abschnitt unten.
Netzwerk-Funktionen
| Flagge | Beschreibung | Typ |
|---|---|---|
--network-app-id | Netzregistrierungsanwendung ID | Zeichenfolge |
--network-redirect-url | URL für die Umleitung zum Austausch des Codes für das Token | Zeichenfolge |
vonage apps capabilities update 00000000-0000-0000-0000-000000000000 networkApis \ --network-app-id'00000000-0000-0000-0000-000000000000' \ --network-redirect-url='https://example.com/network/redirect' ✅ Fetching Application ✅ Adding network capability to application 00000000-0000-0000-0000-000000000000 Name: Your application Application ID: 00000000-0000-0000-0000-000000000000 Improve AI: Off Private/Public Key: Set Capabilities: NETWORK APIS: Redirect URL: [GET] https://example.com/network/redirect
Nachrichten
| Flagge | Beschreibung | Typ |
|---|---|---|
--messages-inbound-url | URL für eingehende Nachrichten | Zeichenfolge |
--messages-status-url | URL für Statusmeldungen | Zeichenfolge |
--messages-version | Version für Webhook-Daten. Muss entweder "v0.1" oder "v1" sein | Zeichenfolge |
--messages-authenticate-media | Eingehende Medien authentifizieren | Boolesche |
vonage apps capabilities update 00000000-0000-0000-0000-000000000000 messages \ --messages-inbound-url='https://example.com/webhooks/messages/inbound' \ --messages-status-url='https://example.com/webhooks/messages/status' \ --messages-version='v1' \ --messages-authenticate-media [boolean] ✅ Fetching Application ✅ Adding messages capability to application 00000000-0000-0000-0000-000000000000 Name: Your application Application ID: 00000000-0000-0000-0000-000000000000 Improve AI: Off Private/Public Key: Set Capabilities: MESSAGES: Authenticate Inbound Media: On Webhook Version: v1 Status URL: [POST] https://manchuck.com/meetings/status Inbound URL: [POST] https://manchuck.com/meetings/inbound
Verify
| Flagge | Beschreibung | Typ |
|---|---|---|
--verify-status-url | URL für Verify-Statusmeldungen | Zeichenfolge |
vonage apps capabilities update 00000000-0000-0000-0000-000000000000 verify \ --verify-status-url='https://example.com/webhooks/verify/status' ✅ Fetching Application ✅ Adding voice capability to application 00000000-0000-0000-0000-000000000000 Name: Your application Application ID: 00000000-0000-0000-0000-000000000000 Improve AI: Off Private/Public Key: Set Capabilities: VERIFY: Webhook Version: v2 Status URL: [POST] https://example.com/webhooks/verify/status
Stimme
| Flagge | Beschreibung | Typ |
|---|---|---|
--voice-signed-callbacks | Signierte Rückrufe einschalten | Boolesche |
--voice-conversations-ttl | Die Lebenszeit für Gespräche (gemessen in Sekunden) | |
--voice-leg-persistence-time | Die Persistenzdauer für die Beine (gemessen in Tagen) | |
--voice-region | Alle eingehenden, programmierbaren SIP- und SIP-Connect-Anrufe werden an die ausgewählte Region gesendet. Wenn der Anruf einen regionalen Endpunkt verwendet, hat dies Vorrang vor den Einstellungen der Anwendung | Zeichenfolge |
--voice-answer-url | Antwort Webhook-URL-Adresse | Zeichenfolge |
--voice-answer-http | Antwort Webhook HTTP-Methode | Zeichenfolge |
--voice-answer-connection-timeout | Zeitüberschreitung bei der Antwort | |
--voice-answer-socket-timeout | Socket-Timeout beantworten | |
--voice-event-url | Ereignis-Webhook-URL-Adresse | Zeichenfolge |
--voice-event-http | Ereignis Webhook HTTP-Methode | Zeichenfolge |
--voice-event-connection-timeout | Zeitüberschreitung der Ereignisverbindung | |
--voice-event-socket-timeout | Zeitüberschreitung der Ereignissteckdose | |
--voice-fallback-url | Fallback-Webhook-URL-Adresse | Zeichenfolge |
--voice-fallback-http | Fallback Webhook HTTP Methode | Zeichenfolge |
--voice-fallback-connection-timeout | Zeitüberschreitung der Fallback-Verbindung | |
--voice-fallback-socket-timeout | Fallback-Socket-Zeitüberschreitung |
vonage apps capabilities update 00000000-0000-0000-0000-000000000000 voice \ --voice-answer-url='https://example.com/webhooks/voice/answer' \ --voice-event-url='https://example.com/webhooks/voice/event' \ --voice-fallback-url='https://example.com/webhooks/voice/fallback' ✅ Fetching Application ✅ Adding voice capability to application 00000000-0000-0000-0000-000000000000 Name: Your application Application ID: 00000000-0000-0000-0000-000000000000 Improve AI: Off Private/Public Key: Set Capabilities: VOICE: Uses Signed callbacks: On Conversation TTL: 41 hours Leg Persistence Time: 6 days Event URL: [POST] https://example.com/webhooks/voice/event Answer URL: [POST] https://example.com/webhooks/voice/answer Fallback URL: [POST] https://example.com/webhooks/voice/fallback
Video
| Flagge | Beschreibung | Typ |
|---|---|---|
--video-archive-status-url | URL für Archiv | Zeichenfolge |
--video-archive-status-secret | Geheimnis für Archiv-URL | Zeichenfolge |
--video-broadcast-status-url | Übertragungsstatus-URL | Zeichenfolge |
--video-broadcast-status-secret | Geheimnis für Broadcast-URL | Zeichenfolge |
--video-captions-status-url | URL für Beschriftungsstatus | Zeichenfolge |
--video-captions-status-secret | Geheimnis für den Untertitel Status | Zeichenfolge |
--video-connection-created-url | URL für erstellte Verbindungen | Zeichenfolge |
--video-connection-created-secret | Geheimnis für die erstellte Verbindungs-URL | Zeichenfolge |
--video-connection-destroyed-url | URL für zerstörte Verbindungen | Zeichenfolge |
--video-connection-destroyed-secret | Geheimnis für zerstörte Verbindungen | Zeichenfolge |
--video-render-status-url | URL für den Rendering-Status | Zeichenfolge |
--video-render-status-secret | Geheimnis für den Rendering-Status | Zeichenfolge |
--video-sip-call-created-url | URL für über SIP erstellte Anrufe | Zeichenfolge |
--video-sip-call-created-secret | Geheimnis für SIP erstellt | Zeichenfolge |
--video-sip-call-destroyed-url | URL für SIP zerstört | Zeichenfolge |
--video-sip-call-destroyed-secret | Geheimnis für SIP zerstört | Zeichenfolge |
--video-sip-call-mute-forced-url | URL für stummgeschalteten SIP-Anruf | Zeichenfolge |
--video-sip-call-mute-forced-secret | Geheimnis für stummgeschaltete SIP-Anrufe | Zeichenfolge |
--video-sip-call-updated-url | URL für SIP aktualisiert | Zeichenfolge |
--video-sip-call-updated-secret | Geheimnis für SIP aktualisiert | Zeichenfolge |
--video-stream-created-url | URL für erstellten Stream | Zeichenfolge |
--video-stream-created-secret | Geheimnis für Stream erstellt | Zeichenfolge |
--video-stream-destroyed-url | URL für zerstörten Stream | Zeichenfolge |
--video-stream-destroyed-secret | Geheimnis für zerstörten Strom | Zeichenfolge |
vonage apps capabilities update 00000000-0000-0000-0000-000000000000 video \ --video-archive-status-url='https://example.com/video/archive-status' \ --video-archive-status-secret='your status secret' \ --video-broadcast-status-url='https://example.com/video/broadcast-status' \ --video-broadcast-status-secret='your broadcast secret' \ --video-captions-status-url='https://example.com/video/caption-status' \ --video-captions-status-secret='your caption status secret' \ --video-connection-created-url='https://example.com/video/connected-created' \ --video-connection-created-secret='your connection created secret' \ --video-connection-destroyed-url='https://example.com/video/connection-destroyed' \ --video-connection-destroyed-secret='your connection destroyed secret' \ --video-render-status-url='https://example.com/video/render-status' \ --video-render-status-secret='yoru render status secret' \ --video-sip-call-created-url='https://example.com/video/sip1' \ --video-sip-call-created-secret='your sip created secret' \ --video-sip-call-destroyed-url='https://example.com/video/sip3' \ --video-sip-call-destroyed-secret='your sip destroyed secret' \ --video-sip-call-mute-forced-url='https://example.com/video/sip4' \ --video-sip-call-mute-forced-secret='your sip mute forced secret' \ --video-sip-call-updated-url='https://example.com/video/sip2' \ --video-sip-call-updated-secret='your sip updated secret' \ --video-stream-created-url='https://example.com/video/stream-created' \ --video-stream-created-secret='your stream created secret' \ --video-stream-destroyed-url='https://example.com/video/stream-destroyed' \ --video-stream-destroyed-secret='your stream destroyed secret ✅ Fetching Application ✅ Adding video capability to application 00000000-0000-0000-0000-000000000000 Name: Your application Application ID: 00000000-0000-0000-0000-000000000000 Improve AI: Off Private/Public Key: Set Capabilities: VIDEO: Archive Status URL: [POST] https://example.com/video/archive-status Archive Status Signature Secret: your status secret Broadcast Status URL: [POST] https://example.com/video/broadcast-status Broadcast Status Signature Secret: your broadcast secret Caption Status URL: [POST] https://example.com/video/caption-status Caption Status Signature Secret: your caption status secret Connection Created URL: [POST] https://example.com/video/connected-created Connection Created Signature Secret: your connection created secret Connection Destroyed URL: [POST] https://example.com/video/connection-destroyed Connection Destroyed Signature Secret: your connection destroyed secret Render Status URL: [POST] https://example.com/video/render-status Render Status Signature Secret: yoru render status secret SIP Call Created URL: [POST] https://example.com/video/sip1 SIP Call Created Signature Secret: your sip created secret SIP Call Destroyed URL: [POST] https://example.com/video/sip3 SIP Call Destroyed Signature Secret: your sip destroyed secret SIP Call Mute Forced URL: [POST] https://example.com/video/sip4 SIP Call Mute Forced Signature Secret: your sip mute forced secret SIP Call Updated URL: [POST] https://example.com/video/sip2 SIP Call Updated Signature Secret: your sip updated secret Stream Created URL: [POST] https://example.com/video/stream-created Stream Created Signature Secret: your stream created secret Stream Destroyed URL: [POST] https://example.com/video/stream-destroyed Stream Destroyed Signature Secret: your stream destroyed secret
Eine Fähigkeit entfernen
Sie können eine Fähigkeit entfernen, indem Sie den Befehl vonage apps capabilities rm <application-id> <capability>, wobei <application-id> ist die ID der Anwendung, die Sie aktualisieren möchten, und <capability> ist die API-Fähigkeit, die Sie entfernen möchten.
vonage apps capabilities rm 00000000-0000-0000-0000-000000000000 messages
✅ Fetching Application
Remove Messages capability from testing (00000000-0000-0000-0000-000000000000)? [y/n]
✅ Removing messages capability from application
Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set
Capabilities:
None Set
vonage apps capabilities rm 00000000-0000-0000-0000-000000000000 messages ✅ Fetching Application Remove Messages capability from testing (00000000-0000-0000-0000-000000000000)? [y/n] ✅ Removing messages capability from application Name: Your application Application ID: 00000000-0000-0000-0000-000000000000 Improve AI: Off Private/Public Key: Set Capabilities: None Set