Comienza con el Sandbox de Twilio para WhatsApp
¿Buscas un tutorial paso a paso para comenzar con la API de WhatsApp Business con Twilio? Consulta nuestra Guía de inicio rápido, que está disponible en varios lenguajes de programación.
Con el Sandbox de Twilio para WhatsApp, puedes crear prototipos con WhatsApp de inmediato, sin tener que esperar a que se apruebe tu número de Twilio en WhatsApp.
Para obtener más información sobre el proceso de incorporación, consulta cómo conectar tu perfil de WhatsApp Business con tu número de Twilio.
¿Qué es el Sandbox de Twilio para WhatsApp?
El Sandbox de Twilio para WhatsApp es un entorno preconfigurado disponible en la consola de Twilio, en el que puedes crear prototipos para enviar mensajes salientes, responder mensajes entrantes y configurar cosas como las devoluciones de llamadas de entrega de mensajes. Puedes probar con rapidez la funcionalidad API de WhatsApp Business con Twilio, mientras esperas que tu perfil de WhatsApp Business esté conectado con tu número de teléfono de Twilio.
El Sandbox se proporciona previamente con un número de teléfono de Twilio (+1-415-523-8886) que se comparte entre todos los usuarios del sandbox. Sin embargo, otros usuarios que comparten el mismo número del sandbox no recibirán tus mensajes, solo los que se han suscripto a tu sandbox.
Ten en cuenta que el Sandbox de Twilio para WhatsApp está diseñado solo a fines de pruebas y detección. No debe utilizarse para la producción.
Cómo unirse a un Sandbox de Twilio
Para enviar o recibir mensajes de WhatsApp a un usuario final del Sandbox, primero debes hacer que cualquier usuario se una al Sandbox.
En primer lugar, envía el mensaje "join <your Sandbox keyword>" (Unirse a tu palabra clave de Sandbox) a tu número de Sandbox en WhatsApp para unirte a tu sandbox. La palabra clave del Sandbox es una cadena única; puedes encontrarla en la consola Twilio.
Cuando Twilio recibe el mensaje de unirse, responderemos con una confirmación a ese usuario de que se ha unido al Sandbox.
Cuando se unen a tu Sandbox, los usuarios finales solo recibirán mensajes de tu Sandbox específico. Para desconectarse del Sandbox, pueden responder al mensaje desde WhatsApp con la palabra "stop" (Detener). Puedes cambiar a otro Sandbox mandando el mensaje "join <other sandbox keyword>" (Unirse a otra palabra clave de Sandbox).
Ten en cuenta que el Sandbox vence tres (3) días después de unirse. Después de este tiempo, debes volver a unirte para continuar con las pruebas.
La limitación de suscripción a un solo Sandbox no existe en tu número propio de Twilio que habilitas para WhatsApp.
Plantillas del Sandbox
No puedes utilizar las plantillas de notificación personalizadas de WhatsApp con el Sandbox de Twilio. En su lugar, el Sandbox de Twilio para WhatsApp viene con tres plantillas preconfiguradas para realizar pruebas.
Para configurar y utilizar plantillas de notificación, deberás registrar un número de teléfono de Twilio en WhatsApp.
Una de las limitaciones de los mensajes de WhatsApp es la sesión o ventana de 24 horas. Cuando un usuario final envía un mensaje a tu negocio, inicia una ventana de 24 horas durante la cual puedes enviarles mensajes salientes de formato libre. Fuera de esta ventana, debes utilizar mensajes con plantilla para iniciar la mensajería saliente con un usuario final. (Consulta nuestra guía de Notificaciones y plantillas de WhatsApp).
El Sandbox viene preconfigurado con tres plantillas para casos de uso común:
- Recordatorios de citas: "Your appointment is coming up on {{1}} at {{2}}" (Tu cita es... a las...)
- Notificaciones de pedidos: "Your {{1}} order of {{2}} has shipped and should be delivered on {{3}} (Tu pedido de... ha sido enviado y se entregará el...). Details: {{4}}" (Detalles:...)
- Códigos de verificación: "Your {{1}} code is {{2}}" (Tu código de.... es...)
(Los números con doble barras se refieren a tu información específica en el mensaje de notificación, como "Your Twilio code is 1238432" [Tu código de Twilio es 1238432])
En el Sandbox, puedes probar realizando llamadas a la API de mensajería programable de Twilio para enviar uno (o más) de estos mensajes salientes.
Responde a los mensajes entrantes con el Sandbox de Twilio
Las personas de todo el mundo utilizan WhatsApp para interactuar con los negocios, y tu caso de uso podría implicar responder a los mensajes entrantes de los usuarios finales. Puedes utilizar el Sandbox de Twilio para explorar responder a los mensajes entrantes de WhatsApp.
Cuando un usuario final te envía un mensaje de WhatsApp, Twilio envía un webhook (una solicitud a una URL que tú especifiques) a tu aplicación móvil. En el Sandbox, puedes configurar la URL de webhook en el campo When a Message Comes in (Cuando entra un mensaje):
Lo más probable es que establezcas la URL de webhook entrante en la URL de tu aplicación web. Cuando Twilio recibe un mensaje de WhatsApp en el Sandbox, realizará una solicitud a esa URL. Puedes responder al mensaje utilizando TwiML, que es el lenguaje de las instrucciones para cómo Twilio debe responder a tu mensaje. (Para obtener un tutorial detallado sobre la configuración de una aplicación para responder con TwiML en el lenguaje que deseas, consulta el Inicio rápido de la API de Twilio para WhatsApp).
Establece una URL de devolución de llamada de estado para realizar un seguimiento de la entrega de mensajes
Puedes probar la funcionalidad de actualización de estado en tiempo real de Twilio para los mensajes de WhatsApp que envías y recibes con el Sandbox. En la configuración de tu Sandbox, agrega una URL en el campo Status callback URL (URL de devolución de estado). Twilio envía una solicitud a esta URL cada vez que el estado de tu mensaje cambia a uno de los siguientes: queued (En espera), failed (No enviado), sent (Enviado), delivered (Entregado), read (Leído).
Cuando configuras la URL de devolución de llamada de estado, puedes recibir solicitudes de Twilio con información sobre el estado de entrega de tu mensaje de WhatsApp de forma automática. Para obtener un tutorial más detallado, consulta la Guía de SMS para realizar un seguimiento de los estados de entrega. El canal de mensajería es diferente, pero los principios son los mismos. (Deberás recordar colocar la URL para la devolución de llamada de estado en el Sandbox).
Limitaciones del Sandbox de Twilio
Debido a que el Sandbox de Twilio para WhatsApp está diseñado a fin de crear prototipos rápidos en lugar de usos listos para la producción, tiene algunas limitaciones:
- Solo puedes enviar mensajes a los usuarios finales que se hayan unido al Sandbox. La mensajería de otros usuarios fallará con el Error 63015.
- El Sandbox de Twilio admite pruebas funcionales, pero no carga pruebas de tráfico de perfil.
- Los números del Sandbox están restringidos a un mensaje cada tres segundos.
- Los números del Sandbox se marcan como números Twilio, es decir, con el logotipo de Twilio.
- Solo puedes utilizar plantillas previamente registradas con el Sandbox para los mensajes salientes enviados fuera de una sesión de WhatsApp. (Obtén más información sobre el uso y el registro de las plantillas de mensajes de WhatsApp).
- La sesión del Sandbox vence tres (3) días después de unirse. Después de esto, sigue los pasos descritos previamente para volver a unirte.
No hay límite en la cantidad de mensajes que puedes enviar con el Sandbox de Twilio ni ningún límite en el tiempo que puedes utilizar el Sandbox. Los mensajes del Sandbox se facturan como de costumbre, según el precio de la API de Twilio para WhatsApp.
¿Qué sigue?
Ahora que has sido introducido al Sandbox de Twilio para WhatsApp, puedes comenzar a crear prototipos mediante la integración de WhatsApp con Twilio Programmable Messaging y tu aplicación.
También puedes conocer más acerca de algunos de los conceptos cubiertos en este documento siguiendo los enlaces a continuación:
¿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.
