Crear una aplicación de la plataforma API de Vonage
Cada aplicación de Smart Numbers que crees debe estar asociada con una aplicación de voz de la plataforma API de Vonage.
Nota: Para evitar confusiones, Application aquí se refiere a la aplicación de la plataforma API de Vonage. La aplicación que estás construyendo se denominará "aplicación".
Una aplicación de la plataforma API de Vonage almacena información de configuración, como los detalles de los Smart Numbers y las URL de devolución de llamadas de webhook que usa tu aplicación. Para que tus llamadas a VBC Smart Numbers tengan tarifa cero en la plataforma de API de Vonage, debes crear una aplicación con la función vbc y voice mediante la función Plataforma API de Vonage Aplicaciones API.
Uso de la API de aplicaciones
Para crear una aplicación de la plataforma API de Vonage para trabajar con Smart Numbers, emite el comando curl que se muestra a continuación, sustituyendo VONAGE_API_KEY y VONAGE_API_SECRET con tu clave y secreto de la API de la plataforma API de Vonage respectivamente. Puedes encontrar esta información en Panel para desarrolladores de la plataforma API de Vonage.
Las dos URL que proporcionas se refieren a los puntos finales de webhook que tu aplicación expondrá a los servidores de la plataforma de API de Vonage:
- El primero es el webhook al cual las API de la plataforma API de Vonage harán una solicitud cuando se reciba una llamada en tu número inteligente.
- La segunda es donde las API de la plataforma API de Vonage publicarán detalles sobre eventos en los que tu aplicación podría estar interesada, como la respuesta o finalización de una llamada.
La respuesta es un objeto JSON que contiene la aplicación de la plataforma API de Vonage id que utilizarás para interactuar con la API de voz de la plataforma API de Vonage.
{
"id": "27aa0583-7246-4822-aabb-17b03c25d52e",
"name": "My VAPI 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 Vonage API Platform id.