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, siga esta guía para crear su Account y su aplicación. A continuación, vaya a la guía de inicio de su canales elegidos para completar su incorporación.

Requisitos previos

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

Crear una Account de Vonage

Para crear tu Account gratuita de Vonage:

  1. En su navegador, vaya a Cuadro de mandos.
  2. Añada la información de su empresa y haga clic en Inscríbete. Vonage envía un PIN a tu teléfono como mensaje de texto o llamada telefónica automática. El tiempo de espera para cada intento de verificación es de 5 minutos.
    NotaPuedes asociar un número de teléfono a una sola Account. Si tu número de teléfono ya está asociado a una Account de Vonage, deberás eliminar ese número de teléfono de la Account existente.
  3. En Verificación de números 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 añada crédito a su Account.

En muy pocos países, Vonage no puede crearte una Account automáticamente. Esto se debe a restricciones de pago o restricciones comerciales legales para una compañía registrada en EE. UU.

Crear una aplicación API de Vonage

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

  1. Uso de la CLI de Vonage
  2. Uso del panel de control

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

Esto crea una aplicación API de Vonage con mensajes capacidadcon las URL de los webhooks configuradas según lo especificado, y generar 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 mediante el Panel de control

Puede crear la aplicación Mensajes en la sección Cuadro de mandos.

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. Haga clic en el botón 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 una cuenta externa a la que desea vincular esta aplicación, haga clic en el botón 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.

Secciones de iniciación específicas para cada canal