Node.js

Configure sus requisitos previos

Hay algunos requisitos previos que debes cumplir antes de poder seguir este tutorial. Si ya has completado alguno de ellos, no dudes en saltarte ese paso.

Puedes crear una Account de Vonage a través de la página Cuadro de mandos.

Dentro del panel puedes crear Applications y comprar números de Vonage. También puedes realizar estas tareas usando la función CLI de Vonage.

Siga los pasos descritos en el Primeros pasos con la CLI de Vonage para instalar y configurar la línea de comandos.

Existen dos métodos para crear una aplicación de voz:

Uso de la CLI de Vonage
Uso del panel de control

Cada uno de estos métodos se describe en las secciones siguientes.

Cómo crear una aplicación de voz con la CLI de Vonage

Para crear tu aplicación utilizando la CLI de Vonage, introduce el siguiente comando en el intérprete de comandos sustituyendo a NGROK_HOST_NAME con el host ngrok que obtuvo cuando configuró ngrok:

Para crear su aplicación utilizando la función CLI de Vonageintroduzca el siguiente comando:

vonage apps create 'Your application'

✅ Creating Application
Saving private key ... Done!
Application created

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
  None Enabled

vonage apps create 'Your application'

✅ Creating Application
Saving private key ... Done!
Application created

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
  None Enabled

A continuación, añada funciones de voz a su aplicación (utilice el nombre de host de ngrok en lugar de example.com)

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

Este comando crea una Aplicación de Vonage con Voz capacidad. En
configura la Aplicación con sus URL de respuesta y de webhook de eventos y genera un archivo de clave privada. private.key, que deberá guardar en el directorio de su proyecto.

El comando devuelve un ID de aplicación único. Usa este ID de aplicación para vincular tu número virtual de Vonage con tu aplicación ejecutando lo siguiente:

vonage apps numbers link 00000000-0000-0000-0000-000000000000 16127779311

✅ Fetching Application
Fetching Owned numbers [===============================================] 1/1 100%

Number linked

Number: 16127779311
Country: 🇺🇸 United States
Type: Toll-free
Features: MMS, SMS, VOICE
Monthly Cost: Not Set
Setup Cost: Not Set
Linked Application ID: 00000000-0000-0000-0000-000000000000
Voice Callback: app
Voice Callback Value: 00000000-0000-0000-0000-000000000000
Voice Status Callback: Not Set

vonage apps numbers link 00000000-0000-0000-0000-000000000000 16127779311

✅ Fetching Application
Fetching Owned numbers [===============================================] 1/1 100%

Number linked

Number: 16127779311
Country: 🇺🇸 United States
Type: Toll-free
Features: MMS, SMS, VOICE
Monthly Cost: Not Set
Setup Cost: Not Set
Linked Application ID: 00000000-0000-0000-0000-000000000000
Voice Callback: app
Voice Callback Value: 00000000-0000-0000-0000-000000000000
Voice Status Callback: Not Set

Esto vinculará ese número virtual de Vonage a tu aplicación, lo que hará que todos los eventos de voz que se produzcan para ese número se dirijan a tus URL designadas. número se dirijan a tus URL designadas.

Cómo crear una aplicación de voz con el panel de control

Puede crear aplicaciones de voz en la sección Cuadro de mandos.

Para crear su aplicación utilizando el Panel de control:

En Applications en el Panel de control, haga clic en el botón Crear una nueva aplicación botón.
En NombreIntroduzca el nombre de la aplicación. Elija un nombre para facilitar futuras referencias.
Pulse el botón Generar clave pública y privada. Esto creará un par de claves pública/privada y la clave privada será descargada por su navegador. Guarde la clave privada generada.
En Capacidades seleccione el Voz botón.
En el Respuesta URL introduzca la URL de su webhook de llamadas entrantes, por ejemplo, http://example.com/webhooks/answer.
En el URL del evento introduzca la URL de su webhook de estado de llamada, por ejemplo, http://example.com/webhooks/events.
Haga clic en el botón Generar nueva aplicación botón.
Ahora pasarás al siguiente paso del procedimiento Crear solicitud, donde deberás vincular tu número de Vonage a la solicitud.

Ya ha creado su aplicación.

NOTA: Antes de probar su aplicación, asegúrese de que sus webhooks están configurados y de que su servidor webhook está en funcionamiento.

Uso del panel de control

Primero puede navegar sus números actuales.

Si no le sobran Numbers, puede comprar uno.

Uso de la CLI de Vonage

Una vez que haya encontrado un número que le satisfaga, puede comprarlo utilizando el botón vonage numbers buy mando:

vonage numbers buy US 16127779311 
✅ Searching for numbers
Are you sure you want to purchase the number 16127779311 for €0.90? [y/n] y

✅ Purchasing number
Number 16127779311 purchased

Number: 16127779311 
Country: 🇺🇸 United States
Type: Mobile
Features: MMS, SMS, VOICE
Monthly Cost: €0.90
Setup Cost: €0.00
Linked Application ID: Not linked to any application
Voice Callback: Not Set
Voice Callback Value: Not Set
Voice Status Callback: Not Set

vonage numbers buy US 16127779311 
✅ Searching for numbers
Are you sure you want to purchase the number 16127779311 for €0.90? [y/n] y

✅ Purchasing number
Number 16127779311 purchased

Number: 16127779311 
Country: 🇺🇸 United States
Type: Mobile
Features: MMS, SMS, VOICE
Monthly Cost: €0.90
Setup Cost: €0.00
Linked Application ID: Not linked to any application
Voice Callback: Not Set
Voice Callback Value: Not Set
Voice Status Callback: Not Set

Uso del panel de control

Encuentre su solicitud en la sección Cuadro de mandos.
Haga clic en la aplicación en la lista "Sus Applications". A continuación, haz clic en la pestaña Numbers.
Haz clic en el botón Vincular para vincular un número de Vonage con esa aplicación.

Uso de la CLI de Vonage

Una vez que tengas un número adecuado, puedes vincularlo con tu aplicación de Vonage ejecutando este comando

vonage apps numbers link 00000000-0000-0000-0000-000000000000 16127779311

✅ Fetching Application
Fetching Owned numbers [===============================================] 1/1 100%

Number linked

Number: 16127779311
Country: 🇺🇸 United States
Type: Toll-free
Features: MMS, SMS, VOICE
Monthly Cost: Not Set
Setup Cost: Not Set
Linked Application ID: 00000000-0000-0000-0000-000000000000
Voice Callback: app
Voice Callback Value: 00000000-0000-0000-0000-000000000000
Voice Status Callback: Not Set

vonage apps numbers link 00000000-0000-0000-0000-000000000000 16127779311

✅ Fetching Application
Fetching Owned numbers [===============================================] 1/1 100%

Number linked

Number: 16127779311
Country: 🇺🇸 United States
Type: Toll-free
Features: MMS, SMS, VOICE
Monthly Cost: Not Set
Setup Cost: Not Set
Linked Application ID: 00000000-0000-0000-0000-000000000000
Voice Callback: app
Voice Callback Value: 00000000-0000-0000-0000-000000000000
Voice Status Callback: Not Set

Debes hacer que tu webhook sea accesible a las API de Vonage a través de la Internet pública. Una manera sencilla de lograrlo durante el desarrollo sin instalar tu propio servidor es usar Ngrok. Para saber más, lea nuestra documentación sobre Ngrok.

Descargue e instale ngrok, luego ejecute el siguiente comando para exponer su aplicación en el puerto 3000 a la Internet pública:

./ngrok http 3000

Si es abonado de pago, puede escribir:

./ngrok http 3000 -subdomain=your_domain

NOTA: En este ejemplo, Ngrok desviará los webhooks de Vonage que especificó al crear su aplicación de Vonage a localhost:3000. Aunque aquí se muestra el puerto 3000, puede utilizar cualquier puerto libre que le convenga.