JavaScript

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.

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

Visite el portal de administración VBC e inicia sesión.
En el menú de navegación, seleccione Tienda > Complementos.
Busca "smart" para filtrar la lista de complementos:
Haga clic en Añadir para añadir Smart Numbers a su cesta de la compra.
Anote la cuota mensual periódica y haga clic en Pedido.
En el Vista previa del pedido Verify your Account payment method and click Enviar pedido.

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

Cada aplicación Smart Numbers que cree debe estar asociada a una aplicación Nexmo Voice.

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 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 Cuadro de mandos 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 el segundo, las API de Nexmo publicarán detalles sobre eventos que puedan interesar a su aplicación, como la respuesta o finalización de una llamada.

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á 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.

Iniciar sesión el portal de administración VBC
En el menú de navegación de la izquierda, seleccione Aplicaciones de negocios > Smart Numbers opción de menú.

Nota: Si no ve el Números inteligentes debe activar el complemento.
Cada fila de la tabla hace referencia a un Smart Numbers. Haga clic en uno de sus Smart Numbers no configurados para editarlo.
En el Editar el servicio Smart Numbers página:
Introduzca un nombre para el servicio.
Seleccione al menos un número de marcación directa al que llamará para acceder a la aplicación Nexmo Voice API.
Introduce tu Voice API de Nexmo application_id.
Asegúrese de que Conmutador de estado de los Smart Numbers se establece en Activo.
Haga clic en el botón Guardar botón.