Gestión de las capacidades
En vonage apps capabilities se puede usar para agregar, actualizar y eliminar las capacidades de la API de Vonage asociadas con tu aplicación.
Añadir y actualizar una capacidad
Para añadir una nueva capacidad a una aplicación, o actualizar la configuración de una capacidad que una aplicación ya ha sido configurada para utilizar, ejecute el comando vonage apps capabilities update <application-id> <capability>.
Cada API tiene un conjunto diferente de banderas para sus ajustes asociados a configurar; la lista de banderas para cada API se puede encontrar en la sección correspondiente a continuación.
Funciones de red
| Bandera | Descripción | Tipo |
|---|---|---|
--network-app-id | ID de solicitud de registro en la red | Cadena |
--network-redirect-url | URL para redirigir al código de intercambio del token | Cadena |
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
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
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
Mensajes
| Bandera | Descripción | Tipo |
|---|---|---|
--messages-inbound-url | URL para mensajes entrantes | Cadena |
--messages-status-url | URL para mensajes de estado | Cadena |
--messages-version | Versión de los datos del webhook. Debe ser "v0.1" o "v1". | Cadena |
--messages-authenticate-media | Autenticar los medios entrantes | Booleano |
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
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
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
| Bandera | Descripción | Tipo |
|---|---|---|
--verify-status-url | URL para mensajes de estado de Verify | Cadena |
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
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
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
Voz
| Bandera | Descripción | Tipo |
|---|---|---|
--voice-signed-callbacks | Activar las retrollamadas firmadas | Booleano |
--voice-conversations-ttl | Tiempo de vida de las conversaciones (en segundos) | |
--voice-leg-persistence-time | La duración de la persistencia de las piernas (medida en días) | |
--voice-region | Todas las llamadas entrantes, programables SIP y SIP connect se enviarán a la región seleccionada. Si la llamada utiliza un punto final regional, esto anulará la configuración de la aplicación. | Cadena |
--voice-answer-url | Dirección URL del Webhook de respuesta | Cadena |
--voice-answer-http | Respuesta Webhook Método HTTP | Cadena |
--voice-answer-connection-timeout | Tiempo de espera de la conexión de respuesta | |
--voice-answer-socket-timeout | Tiempo de espera del socket de respuesta | |
--voice-event-url | Dirección URL del evento Webhook | Cadena |
--voice-event-http | Evento Webhook Método HTTP | Cadena |
--voice-event-connection-timeout | Tiempo de espera de la conexión de eventos | |
--voice-event-socket-timeout | Tiempo de espera del socket de eventos | |
--voice-fallback-url | Dirección URL del webhook de reserva | Cadena |
--voice-fallback-http | Método HTTP Fallback Webhook | Cadena |
--voice-fallback-connection-timeout | Tiempo de espera de la conexión fallback | |
--voice-fallback-socket-timeout | Tiempo de espera del socket fallback |
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
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
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
Vídeo
| Bandera | Descripción | Tipo |
|---|---|---|
--video-archive-status-url | URL del archivo | Cadena |
--video-archive-status-secret | Secreto para la URL del archivo | Cadena |
--video-broadcast-status-url | URL de estado de emisión | Cadena |
--video-broadcast-status-secret | Secreto para la URL de difusión | Cadena |
--video-captions-status-url | URL para el estado de los subtítulos | Cadena |
--video-captions-status-secret | Secreto para el estado de los subtítulos | Cadena |
--video-connection-created-url | URL de las conexiones creadas | Cadena |
--video-connection-created-secret | Secreto de la URL de conexión creada | Cadena |
--video-connection-destroyed-url | URL para conexiones destruidas | Cadena |
--video-connection-destroyed-secret | Secreto para conexiones destruidas | Cadena |
--video-render-status-url | URL para el estado de representación | Cadena |
--video-render-status-secret | Secreto de estado | Cadena |
--video-sip-call-created-url | URL para llamadas creadas por SIP | Cadena |
--video-sip-call-created-secret | Secreto para SIP creado | Cadena |
--video-sip-call-destroyed-url | URL para SIP destruido | Cadena |
--video-sip-call-destroyed-secret | Secreto para SIP destruido | Cadena |
--video-sip-call-mute-forced-url | URL para llamada SIP silenciada | Cadena |
--video-sip-call-mute-forced-secret | Secreto para llamada silenciada SIP | Cadena |
--video-sip-call-updated-url | URL para SIP actualizada | Cadena |
--video-sip-call-updated-secret | Secreto para SIP actualizado | Cadena |
--video-stream-created-url | URL del flujo creado | Cadena |
--video-stream-created-secret | Secreto para el flujo creado | Cadena |
--video-stream-destroyed-url | URL del flujo destruido | Cadena |
--video-stream-destroyed-secret | Secreto para arroyo destruido | Cadena |
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
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
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
Eliminar una capacidad
Puede eliminar una capacidad ejecutando el comando vonage apps capabilities rm <application-id> <capability>donde <application-id> es el ID de la aplicación que desea actualizar, y <capability> es la capacidad de la API que desea eliminar.
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
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