Primeros pasos con la Messages API

Esta página te guiará a través de todos los pasos necesarios para comenzar a usar la API de Messages API de Vonage. Messages API ofrece una manera simple de enviar mensajes a tus clientes a través de múltiples canales populares: SMS, MMS, RCS, WhatsApp, Facebook y Viber. En lugar de integrarte con cada plataforma por separado, puedes conectarte una vez y administrar todas las conversaciones en un solo lugar.

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.

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.

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.

  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.

Secciones de «Primeros pasos» específicas para cada canal