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