Presentación del Sandbox de la API de Messages

El Messages API Sandbox es una nueva forma de desarrollar y probar cualquier aplicación que quieras crear utilizando WhatsApp, Vibero Facebook Messenger a través de nuestra Messages API.

En Sandbox te permite vincular tus propias cuentas de WhatsApp, Viber o Facebook Messenger para que puedas empezar a enviar y recibir mensajes de prueba en tus propios dispositivos mientras construyes.

En este tutorial, vamos a ver cómo configurarlo todo.

Requisitos previos

Vonage API Account

To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

Ready to start building?

Experience seamless connectivity, real-time messaging, and crystal-clear voice and video calls—all at your fingertips.

Una vez que tengas tu Account, también necesitarás:

• Un smartphone con WhatsApp, Viber o Facebook Messenger instalado.

• Una aplicación de línea de comandos o terminal.

Lista blanca

Diríjase al Sandbox de la API de Messages en tu panel de la API de Vonage.

El primer paso es poner tus cuentas en la lista blanca. Como el proceso es similar para todos los servicios compatibles, nos centraremos en WhatsApp en la sección Cuentas externas.

Haz clic en el enlace "Añadir al sandbox" para abrir la lista de opciones. Hay tres formas de añadir una nueva Account a la lista blanca:

1. Escanea el código QR con tu cámara para abrir WhatsApp con un mensaje predefinido.

2. Envíate las instrucciones a ti mismo o a otro miembro del equipo por correo electrónico.

3. Envía un mensaje directamente desde WhatsApp al número especificado utilizando la frase única que se muestra.

Independientemente del método que elijas, lo que estás haciendo es vincular el número y el ID de cuenta que has configurado en tu cuenta de WhatsApp con la API Key de tu cuenta de Nexmo.

Sabrás que ha funcionado si al final de la sección de la lista blanca pone You have 1 user(s) whitelisted. Si no lo ves inmediatamente, haz clic en el enlace Actualizar.

Si desea vincular una cuenta de Viber o Facebook Messenger, repita los pasos para cada servicio.

Envíate un mensaje

Una vez que su Account esté en la lista blanca, puede probarla enviándose un mensaje.

Para ello, puede utilizar Terminal en macOS y Linux o Línea de comandos en Windows.

Copie el código del servicio que haya elegido en el bloque de códigos de la parte inferior de la pantalla.

Viene precargado con sus credenciales de la API, pero tiene que cambiar el $TO_NUMBER para que coincida con el número de la Account que previamente incluyó en la lista blanca.

Pega el código en tu aplicación Terminal. Pulsa enter y espera la respuesta del servidor; debería ser algo parecido a esto:

{"message_uuid":"7836a42b-7493-4ece-a7a7-3f59c5058471"}

A continuación, espere a que aparezca el mensaje.

Muy guay, ¿verdad?

Conéctese a su aplicación mediante Webhooks

CURL es excelente y todo eso, pero sabemos que no estás aquí para enviarte mensajes a ti mismo desde la línea de comandos.

Para que su aplicación pueda recibir mensajes entrantes de cualquiera de los servicios compatibles, puede configurar un webhook Inbound webhook.

Para recibir mensajes entrantes, asegúrese primero de que su aplicación tiene un punto final en el que escuchar mensajes y que puede recibir solicitudes de POST peticiones. Puedes llamarlo como quieras; hemos oído que /inbound es una opción popular.

Antes de desplegar su aplicación en un servidor, puede utilizar una aplicación como Ngrok para hacerla accesible al mundo exterior. Hay más detalles sobre cómo configurar esto en nuestra documentación.

Es bueno saber qué ocurre con los mensajes que envía tu aplicación. Para ayudar con esto, proporcionamos un Status webhook que informa de cualquier cambio que se produzca a lo largo de la ruta de entrega.

Por ejemplo, si quieres saber si los mensajes enviados por tu aplicación están llegando, se informaría a través del webhook de estado utilizando un atributo delivered estado. Aunque el uso de este webhook es opcional, es una excelente opción para monitorizarlo activamente y registrar los datos que te envía.

Puedes seguir desde aquí

Messages API Sandbox te permite empezar a trabajar con WhatsApp, Viber y Facebook Messenger de forma rápida y sencilla. Ahora puedes conectar cualquiera de estos servicios a tus aplicaciones nuevas o existentes, así que ¿qué vas a construir con ellos?

Empiece por consultar la documentación de la Messages API.

Si buscas algo de inspiración, aquí tienes otros cinco tutoriales que hemos creado y que pueden servirte de inspiración:

• Guardar mensajes SMS recibidos con Airtable y Node.js-Podría cambiar esto para almacenar los mensajes recibidos de WhatsApp, Viber o Facebook Messenger.

• Descubre tu puntuación de positividad en Twitter-Podrías basarte en este ejemplo de React y hacer que envíe la puntuación a través de Viber o WhatsApp en su lugar.

• Rastrea la web y envía actualizaciones por SMS-Podrías tomar esta aplicación de ejemplo y hacer que envíe los resultados por WhatsApp.

• Traducciones de SMS en tiempo real con Node, React y Google.-¿Por qué no añadir a esta aplicación y conseguir que traduzca mensajes SMS, WhatsApp o Facebook Messenger?

• Enviar y recibir mensajes SMS con Node.js y Azure Functions-Prueba a modificar esta función de Azure para que envíe mensajes de Viber en lugar de SMS.

Construyas lo que construyas, estamos a tu disposición si nos necesitas. Dirígete a la Slack de la comunidad de desarrolladores de Vonage para retomar la conversación, compartir consejos y aprender de los demás.