Primeros pasos con la Messages API

Esta página te guiará a través de todos los pasos necesarios para empezar a utilizar la Messages API de Vonage. La Messages API ofrece una forma sencilla de enviar mensajes a tus clientes a través de múltiples canales populares: SMS, MMS, RCS, WhatsApp, Facebook Messenger y Viber. En lugar de integrar cada plataforma por separado, puedes conectarte una sola vez y gestionar todas las conversaciones desde un mismo lugar. La disponibilidad de los canales varía según el tipo de Account, el mercado y el estado de la incorporación; por ejemplo, el acceso a RCS requiere una activación adicional.

Para empezar, sigue esta guía para crear tu Account y tu aplicación. A continuación, consulta la guía de introducción para tu canales seleccionados para completar su incorporación.

Requisitos previos

Antes de enviar tu primer mensaje, tendrás que crear un Account y una aplicación de Vonage:

Crear un Account de Vonage

Para crear tu Account gratuita de Vonage:

  1. En tu navegador, ve a Panel de control.
  2. Añada la información de su empresa y haga clic en Inscríbete. Vonage envía un PIN a tu teléfono mediante un mensaje de texto o una llamada automática. El tiempo de espera para cada intento de verificación es de 5 minutos.
    Nota: solo puedes vincular un número de teléfono a un Account. Si tu número de teléfono ya está vinculado a un Account de Vonage, deberías elimina ese número de teléfono de la Account existente.
  3. En Verificación del número de teléfonointroduce el PIN que te envió Vonage y haz clic en Verify. Inicias sesión en Dashboard y se te muestra cómo comenzar a desarrollar con Vonage. Esta página se muestra cada vez que inicias sesión hasta que hayas realizado tu primera llamada exitosa con las API de Vonage.

Cuando creas tu Account de Vonage, recibes 2 euros de crédito de prueba gratis y tu cuenta se configura en modo DEMO. Puedes usar nuestros productos para enviar mensajes a hasta 10 números de destino, se agrega un mensaje que indica que la cuenta está en modo demo a todos los SMS que envíes. Para salir del modo demo recargar saldo en tu Account.

NOTA: En el caso de los flujos de trabajo de RCS, un Account gratuito o en modo DEMO no es suficiente por sí solo. El acceso a RCS está disponible actualmente para los clientes gestionados por Vonage, y es necesario habilitar la función de incorporación requerida en tu clave API antes de poder enviar tráfico RCS.

Hay muy pocos países en los que Vonage no pueda crear un Account para ti de forma automática. Esto se debe a restricciones de pago o a restricciones legales en materia comercial para una empresa registrada en EE. UU.

Crear una aplicación API de Vonage

Existen tres métodos alternativos para crear una aplicación de Mensajes:

  1. Uso de la CLI de Vonage
  2. Uso del panel de control
  3. Uso de la API de aplicaciones

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

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

Para crear tu aplicación usando la CLI de Vonage, ingresa el siguiente comando en el shell:

vonage apps:create "My Messages App" --messages_inbound_url=https://example.com/webhooks/inbound-message --messages_status_url=https://example.com/webhooks/message-status

Este comando crea una aplicación API de Vonage con un mensaje capacidad, y las URL de los webhooks se configuran tal y como se indica. Además, genera un archivo de clave privada my_messages_app.key y crea o actualiza el vonage_app.json archivo.

Guarda la clave privada generada de forma segura una vez finalizado el comando. La autenticación JWT para la Messages API depende de esta clave y, si la pierdes, no podrás volver a descargar la clave privada original.

Cómo crear una aplicación de mensajes utilizando el panel de control

Puede crear una aplicación Mensajes en la sección Panel de control.

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

  1. En Applications en el Panel de control, haga clic en el botón Crear una nueva aplicación botón.

  2. En NombreIntroduzca el nombre de la aplicación. Elija un nombre para facilitar futuras referencias.

  3. Pulse el botón Generar clave pública y privada. Esto creará un par de claves pública/privada y su navegador descargará la clave privada.

    Guarda la clave privada descargada en un lugar seguro. La autenticación JWT para la Messages API depende de esta clave y, si la pierdes, no podrás volver a descargar la clave privada original.

  4. En Capacidades seleccione el Mensajes botón.

  5. En el URL de entrada introduzca la URL de su webhook de mensajes entrantes, por ejemplo, https://example.com/webhooks/inbound-message.

  6. En el URL de estado introduzca la URL de su webhook de estado de mensajes, por ejemplo, https://example.com/webhooks/message-status.

  7. Haz clic en el Generar nueva aplicación botón . Ahora pasarás al siguiente paso del procedimiento para crear una aplicación, donde podrás vincular un número API de Vonage a la aplicación y vincular cuentas externas, como Facebook, a esta aplicación.

  8. Si hay un Account externo que quieras vincular a esta aplicación, haz clic en el Cuentas externas vinculadas y, a continuación, haga clic en el botón Enlace de la Account que desea vincular.

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.

Cómo crear una aplicación de mensajes utilizando la API de aplicaciones

La API de aplicaciones te permite crear y configurar una aplicación de Vonage mediante programación, sin usar el panel ni la CLI. Una aplicación de Vonage creada a través de la API de aplicaciones funciona igual que una creada a través del panel.

Para obtener información general sobre cómo crear una aplicación de Vonage, consulta Crear una aplicación de Vonage.