JavaScript

Configura los requisitos previos

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

Para utilizar Smart Numbers, debe activar el complemento Smart Number en su Account:

  1. Visite el portal de administración de VBC e inicia sesión.
  2. En el menú de navegación, selecciona Tienda > Complementos.
  3. Busca "smart" para filtrar la lista de complementos: Enable the Smart Numbers add-on
  4. Haz clic Añadir para añadir Smart Number a tu cesta de la compra.
  5. Anote la cuota mensual periódica y haga clic en Finalizar compra.
  6. En el Vista previa del pedido Verify your Account payment method and click Enviar pedido.

Ya has activado «Smart Numbers». El siguiente paso es Crear una aplicación Nexmo Voice.

Cada aplicación de Smart Numbers que crees debe estar asociada a una aplicación de voz de Nexmo.

Nota: Para evitar confusiones, Application aquí se refiere a la Aplicación Nexmo. La aplicación que está construyendo se denominará "aplicación".

Una Aplicación Nexmo almacena información de configuración, como los detalles de los Smart Numbers y las URL de devolución de llamada de webhook que utiliza su aplicación. Para que sus llamadas a VBC Smart Numbers sean de tarifa cero en Nexmo, debe crear una Aplicación con la etiqueta vbc y voice mediante la función API de aplicaciones de Nexmo.

Uso de la API de aplicaciones

Para crear una Nexmo Application para trabajar con Smart Numbers, emita el comando curl que se muestra a continuación, sustituyendo NEXMO_API_KEY y NEXMO_API_SECRET con tu clave y secreto de la API de Nexmo respectivamente. Puede encontrar esta información en Panel de control para desarrolladores de Nexmo.

Las dos URL que proporcione se refieren a los puntos finales de webhook que su aplicación expondrá a los servidores de Nexmo:

  • El primero es el webhook al que las APIs de Nexmo harán una petición cuando se reciba una llamada en tu Smart Number.
  • En segundo lugar, las API de Nexmo publicarán información sobre eventos que puedan ser de interés para tu aplicación, como, por ejemplo, cuando se responde a una llamada o cuando esta finaliza.
curl -X POST \ https://api.nexmo.com/v2/applications \ -H 'Authorization: Basic Base64($NEXMO_API_KEY:$NEXMO_API_SECRET)' \ -H 'Content-Type: application/json' \ -d '{ "name": "My Nexmo VBC Application", "capabilities": { "vbc": {}, "voice": { "webhooks": { "answer_url": { "address": "https://example.com/webhooks/answer", "http_method": "POST" }, "event_url": { "address": "https://example.com/webhooks/event", "http_method": "POST" } } } } }'

La respuesta es un objeto JSON que contiene la Aplicación Nexmo id que utilizarás para interactuar con la Voice API de Nexmo.

{
  "id": "27aa0583-7246-4822-aabb-17b03c25d52e",
  "name": "My Nexmo VBC Application",
  "keys": {
    "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvAIBADANBgkq...
    -----END PRIVATE KEY-----\n",
    "public_key": "-----BEGIN PUBLIC_KEY-----\nMIIBIjANBgkqh...
    -----END PUBLIC KEY-----\n"
  },
  "capabilities": {
    "voice": {
      "webhooks": {
        "event_url": {
            "address": "https://example.com/webhooks/event",
            "http_method": "POST"
        },
        "answer_url": {
            "address": "https://example.com/webhooks/answer",
            "http_method": "POST"
        }
      }
    },
    "vbc": {}
  },
  "_links": {
    "self": {
      "href": "/v2/applications/27aa0583-7246-4822-aabb-17b03c25d52e"
    }
  }
}

El siguiente paso es provision Smart Numbers utilizando la Aplicación Nexmo id.

Una vez que haya habilitado el complemento Smart Numbers en su cuenta VBC y haya creado una Nexmo Voice API Application, estará listo para aprovisionar el servicio Smart Numbers. Esto implica seleccionar qué números utilizar y asociarlos a su aplicación Voice API Nexmo.

  1. Iniciar sesión el portal de administración de VBC

  2. En el menú de navegación de la izquierda, seleccione Aplicaciones empresariales > Numbers opción de menú.

    Nota: Si no ves el Números inteligentes debe activar el complemento.

  3. Cada fila de la tabla hace referencia a un Smart Numbers. Haga clic en uno de sus Smart Numbers no configurados para editarlo.

  4. En el Editar el servicio «Números inteligentes» página:

  5. Introduzca un nombre para el servicio.

  6. Seleccione al menos un número de marcación directa al que llamará para acceder a la aplicación Nexmo Voice API.

  7. Introduce tu Voice API de Nexmo application_id.

  8. Asegúrate de que el Conmutador de estado de los Smart Numbers se establece en Activo.

  9. Haz clic en el Guardar botón.

Edit your Smart Number

Ya ha aprovisionado el servicio Smart Numbers y está listo para empezar a desarrollar su aplicación. Consulte lista de recursos para empezar.

Smart Numbers IVR

Redirigir llamadas desde su número inteligente a otro número

Disponible en:
JavaScript
Pasos
1
Introducción a esta tarea
2
Prerequisites
3
Modificar el código de ejemplo
4
Ejecutar la aplicación
5
¿Y ahora qué?