Trabajar con las API de Vonage

¡Bienvenido a la plataforma de API de Vonage! Vonage ofrece un conjunto de API que te permiten comunicarte con tus clientes a través de los canales que prefieras.

Esta página web ofrece documentación exhaustiva sobre todas nuestras API y, en la sección correspondiente, encontrarás todo lo que necesitas saber para trabajar con una API concreta.

Sin embargo, hay algunos conceptos fundamentales que debe comprender y herramientas que pueden ayudarle y que se aplican a todas nuestras API:

Crear una Account

Para trabajar con nuestras API, necesitará crear una Account. Esto le proporcionará una clave API y un secreto que podrá utilizar para acceder a nuestras API.

Acceso al panel de control para desarrolladores

Una vez que tengas una cuenta, podrás iniciar sesión en el Panel de control para desarrolladores. El Developer Dashboard es una interfaz gráfica de usuario para gestionar su Account:

  • Ver su clave y secreto API. Los necesitará para autenticar sus solicitudes a nuestras API
  • Gestione el saldo de su Account. El acceso a nuestras API se cobra por solicitud. Le daremos algo de crédito gratis cuando abra su Account por primera vez y podrá aumentar cuando se te acabe.
  • Alquilar números virtuales. Puedes utilizar números virtuales proporcionado por Vonage para enviar y recibir llamadas y mensajes. Ver alquilar un número virtual.
  • Gestionar aplicaciones. Algunas de nuestras API (como «Voz» y «Mensajes») requieren que crees un Aplicacionesque actúa como contenedor de la información de seguridad y configuración. Puede crear y gestionar estas Applications en el Developer Dashboard.
  • Gestiona tu Account. Puede realizar otras tareas administrativas aquí.

Uso de la CLI de Vonage

Opcionalmente, puedes realizar muchas de las tareas del panel desde la línea de comandos, usando la CLI de Vonage. Esto suele ser más rápido y también te permite programar estas operaciones.

La CLI de Vonage está escrita con oclif y puede instalarse mediante el gestor de paquetes Node (npm). En README en el Repositorio de GitHub de Vonage CLI te muestra cómo instalar y trabajar con la CLI de Vonage.

Autenticación

Al utilizar las API de Vonage, tus solicitudes deben ser autenticado. Normalmente esto se hace utilizando Autenticación básica o JWT. Puedes generar un JWT adecuado mediante la CLI de Vonage o nuestra herramienta en línea. Aunque Autenticación básica funcionará, pero no le permitirá recibir webhooks - éstos sólo pueden activarse utilizando JWT.

Si se utiliza la autenticación silenciosa con Verify, debe ser el primer canal de la matriz de flujos de trabajo.

Experimentar con nuestras API

Al final, lo que querrás es crear una aplicación en tu lenguaje de programación elegido. Pero, para empezar, quizá te interese realizar algunas solicitudes de prueba a nuestras API para comprobar que has introducido los parámetros correctos y que recibes las respuestas que esperas.

Si está familiarizado con la herramienta de línea de comandos Rizar, encontrarás fragmentos de código Curl para cada una de nuestras API que puedes copiar, pegar y modificar.

Cartero

Existen varias herramientas GUI más fáciles de usar que Curl. Una de las más populares es Cartero. Lee nuestra guía sobre utilizar Postman para trabajar con nuestras API. Vonage también ofrece un conjunto de Colecciones de carteros, que ofrece una forma de empezar a utilizar las API de inmediato.

OpenAPI

Cada una de nuestras API tiene su propio Especificación OpenAPI. Puede obtener más información sobre OpenAPI en nuestro documentación. Nuestras especificaciones se ajustan a la versión 3 de la especificación OpenAPI, también conocida como OAS3.

Uso de un SDK de servidor

Cuando esté listo para empezar a crear su aplicación, querrá utilizar uno de nuestros SDK de servidor en lugar de codificar cada solicitud a mano. Puedes encontrar enlaces a todos nuestros SDKs en la página Herramientas página.

Trabajar con Webhooks

Una vez que haya aprendido a realizar solicitudes a nuestras API para realizar llamadas, enviar mensajes, etc., querrá aprender a recibir comunicaciones entrantes en su número virtual.

Cuando nuestras API quieren notificar algo a tu aplicación, ya sea una llamada entrante, un mensaje o una actualización de estado, necesitan que tu aplicación exponga un punto final URL al que nuestra plataforma pueda hacer una petición. Estas deben ser accesibles a través de la Internet pública.

Estos puntos finales se denominan Webhooks. Más información sobre webhooks. Una vez que haya creado su gancho web, debe indicar a nuestra plataforma API que lo utilice. El proceso para hacerlo depende de la API que esté utilizando y las instrucciones completas se pueden encontrar en la documentación de esa API.

Hacer que estos webhooks sean públicamente accesibles durante el desarrollo puede ser complicado, por lo que recomendamos una herramienta llamada Ngrok.

Echa un vistazo a nuestra guía sobre pruebas con Ngrok para aprender a utilizarlo.

Formato de los Numbers

En las API de Vonage, todos los números de teléfono están en Formato E.164. Esto significa que los números:

  • Omitir tanto la inicial + y el código de acceso internacional como 00 o 001.
  • No contener caracteres especiales, como espacios, () o -

Por ejemplo, un número estadounidense tendría el formato 14155550101. Un número del Reino Unido tendría el formato 447700900123.

Si no sabes cómo dar formato al número, el Number Insight API se puede utilizar para encontrar información correcta sobre un número.

Ver también Formato de los Numbers en la documentación de la Voice API.

Concepts

Hay una serie de conceptos comunes a las API de Vonage: el uso de tokens web JSON (JWT), las solicitudes firmadas y los webhooks. Las guías que figuran a continuación explican detalladamente cómo utilizar estos elementos.

  • Applications - Información sobre seguridad y configuración necesaria para conectarse a los terminales de Vonage.
  • Autenticación - Claves API y JSON Web Tokens (JWTs).
  • Firma de mensajes - cómo firmar criptográficamente mensajes y verificar firmas de mensajes.
  • Webhooks – La API de Vonage puede enviar datos a tu servidor web a través de un webhook.
  • OpenAPI – Todas las API de Vonage cuentan con descripciones OpenAPI que puedes aprovechar en tu propio proceso de desarrollo.
  • Glosario – Un glosario de términos habituales que se utilizan en toda la plataforma de Vonage.

Qué hacer a continuación

Esta guía le presenta algunos de los conceptos y herramientas fundamentales que debe conocer cuando trabaje con nuestras API.

Una vez que comprenda estos conceptos fundamentales y haya instalado las herramientas que va a utilizar, estará listo para empezar a construir. Ver la documentación de la API elegida para empezar.

Si encuentra alguna dificultad, consulte nuestro Slack de la comunidad, o echa un vistazo a nuestra base de conocimientos y ponte en contacto con nosotros para solicitar ayuda si es necesario en nuestro sitio de asistencia.