Inicio rápido para la mensajería programable de WhatsApp y Java
Twilio está lanzando una nueva consola. Algunas capturas de pantalla de esta página pueden mostrar la consola heredada y, por lo tanto, es posible que ya no sean precisas. Estamos trabajando para actualizar todas las capturas de pantalla a fin de reflejar la nueva experiencia de la consola. Obtén más información acerca de la nueva consola.
Con solo algunas líneas de código, tu aplicación puede enviar y recibir mensajes con WhatsApp mediante la API de Twilio para WhatsApp.
Este inicio rápido para WhatsApp te enseñará cómo hacer esto con el Sandbox de Twilio para WhatsApp, Java, la Twilio Java, biblioteca auxiliar de Twilio y el marco web de Spark. En este inicio rápido, aprenderás lo siguiente:
- Registrarte en Twilio y activar el Sandbox.
- Configurar tu entorno de desarrollo para enviar y recibir mensajes.
- Suscribirte al Sandbox.
- Enviar tu primer mensaje de WhatsApp.
- Recibir mensajes entrantes de WhatsApp.
- Responder mensajes entrantes de WhatsApp.
Regístrate en Twilio y activa el sandbox
Antes de enviar un mensaje de WhatsApp desde tu lenguaje web, deberás registrarte para obtener una cuenta de Twilio o iniciar sesión en su cuenta existente y activar el Sandbox de Twilio para WhatsApp. Te permite crear prototipos de WhatsApp de forma inmediata, utilizando un número de teléfono compartido, sin necesidad de esperar a que WhatsApp apruebe un número específico.
Para comenzar, selecciona un número de los números disponibles del sandbox para activar el tuyo.
Asegúrate de anotar el número de teléfono que elijas en el sandbox. Lo necesitarás más tarde cuando estemos listos para enviar algunos mensajes.
Recopilar la información de tu cuenta Twilio
Antes de poder enviar cualquier mensaje, deberás recopilar tus credenciales de cuenta de Twilio. Puedes encontrarlos en la consola de Twilio.
- SID de cuenta: se utiliza para autenticar solicitudes de API REST
- Token de autenticación: se utiliza para autenticar solicitudes de API REST
Para todos nuestros fragmentos de código y ejemplos de cURL, deberás autenticarte con el SID de cuenta y el token de autenticación.
Configura tu entorno de desarrollo Java
Los siguientes pasos implican escribir algún código. Hemos creado la configuración del entorno de desarrollo para Java, en la que podrás configurar un entorno de desarrollo y prepararte para crear una aplicación web sencilla con Servlets.
Si aún no has configurado tu entorno de desarrollo para escribir algunos Java, dirígete allí primero a fin de prepararte, y no te preocupes, Spark está un paso más adelante. Este inicio rápido estará esperando.
Envía un mensaje con WhatsApp en Java
Uso de números del Sandbox previamente aprovisionados
El Sandbox se proporciona previamente con tres números de teléfono Twilio que se comparten entre todos los usuarios del Sandbox. Para poder utilizar el sandbox, DEBES empezar por subscribirte al Sandbox enviando un mensaje de WhatsApp al número de teléfono que elegiste. Una vez que te hayas suscrito, solo recibirás mensajes de tu Sandbox específico.
Estas limitaciones no existen en tu identidad empresarial propia, que puedes solicitar que se suministre en WhatsApp.
Mensaje de suscripción al Sandbox
Envíe “join <your sandbox keyword>” (Unirse a tu palabra clave de Sandbox) a tu número de Sandbox en WhatsApp para unirse a tu Sandbox y te responderemos con una confirmación de que te has unido. Puedes encontrar la palabra clave del sandbox en la consola.
Una vez que te hayas unido, solo recibirás mensajes de tu Sandbox específico. Para desconectarte del Sandbox, puedes responder al mensaje de WhatsApp con `sandbox stop` (Detener el Sandbox), o cambiar a un sandbox diferente enviando el mensaje `join <other sandbox keyword>` (Unirse a otra palabra clave de Sandbox).
Invita a otros usuarios a tu sandbox (OPCIONAL)
Para invitar a otra persona a tu espacio aislado, crea un enlace con el siguiente formato que contenga el mensaje de suscripción y envíelo a ellos: whatsapp://send?phone=<Your Sandbox Number>&text=<your URL-encoded sandbox keyword>
También puedes crear un código QR con el formato de enlace anterior que los usuarios pueden escanear en su teléfono para suscribirse a tu espacio aislado.
Para enviar un mensaje, utiliza el siguiente código y reemplaza el parámetro to (para) con el número de teléfono de tu cuenta personal de WhatsApp en el formato E.164. (Si aún no lo has hecho, instala WhatsApp en tu dispositivo y regístrate para obtener una cuenta). Para el parámetro from (desde), asegúrate de incluir el identificador de canal whatsapp: antes del número del Sandbox en formato E.164.
Para el parámetro From (Desde), necesitas tu Sender ID (ID de remitente) que se debería mostrar en el canal instalado en la consola Twilio, como se mostró anteriormente.
Recibe y responde mensajes desde WhatsApp
Cuando alguien responda a uno de tus mensajes, recibirás una solicitud de webhook de Twilio.
Puedes configurar webhooks conectando el entorno de pruebas a una aplicación que ya hayas creado a fin de manejar mensajes entrantes o crear una nueva para los mensajes de WhatsApp.
Esta solicitud de webhook también es compatible con TwiML (Twilio Markup Language), al igual que una solicitud normal de Twilio SMS.
Para manejar esta solicitud, debes configurar una aplicación web y exponerla a Internet. El inicio rápido de SMS de Java te muestra cómo responder a un mensaje y generar TwiML en Java con Spark.
Y eso es todo lo que hay que hacer; recibir y responder es exactamente igual a lo que harías en cualquier aplicación de SMS con nuestra API de mensajería. Genial, ¿verdad?
Aunque estos inicios rápidos te muestran cómo recibir un mensaje SMS, el webhook que Twilio enviará e incluirá los mismos parámetros que un mensaje SMS entrante, con la excepción de las direcciones To (Para) y From (Desde) que se establecerán en el número de WhatsApp que recibe el mensaje (whatsapp:<E.164 formatted Twilio phone number associated with your business>) y el número de WhatsApp que envía el mensaje (whatsapp:<User’s E.164 phone number>), de forma respectiva.
¿Qué sigue para WhatsApp y Java?
Debido a que la API de Twilio para WhatsApp es en esencia la misma que la API del SMS programable de Twilio, toda la documentación de esa API se aplica a tus aplicaciones enviando y recibiendo mensajes con WhatsApp. Para profundizar en la integración de WhatsApp, consulta la descripción general de la documentación de WhatsApp y la referencia de API.
Estas son algunas áreas que te podrían gustar explorar a continuación.
- Envía recordatorios de citas
- Crea conversaciones en SMS
- Descripción general de la API de mensajería
- Busca otros tutoriales de SMS
¡Nos emociona ver qué tipo de integración de WhatsApp construirás!
¿Necesitas ayuda?
Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.
