SMS bidireccionales para captar clientes
Los SMS programables no sólo son útiles para las notificaciones unidireccionales. Cuando combinas notificaciones salientes con mensajes entrantes creas interacciones tipo chat entre tu empresa y tus clientes.
En este tutorial
Ya ve lo rápido que es integrar la comunicación bidireccional en su aplicación: envíe una notificación de entrega al número de teléfono de su cliente y gestione su respuesta cuando quiera cambiar una franja horaria de entrega.
El flujo de trabajo para tu aplicación es:
Para ello:
- Configurar un número virtual de Vonage - alquilar un número virtual y configurar los puntos finales de webhook para los mensajes entrantes
- Crear una aplicación web básica - cree una aplicación web para recopilar el número de teléfono de sus clientes.
- Enviar una notificación SMS - envíe a su cliente una notificación de entrega en un SMS y solicite una respuesta.
- Procesar el SMS de respuesta - procesar y acusar recibo de la respuesta SMS.
Requisitos previos
Para trabajar a través de este tutorial que necesita:
- A Account de Vonage
- Un servidor web de acceso público para que Vonage pueda realizar solicitudes de webhook a tu aplicación. Si estás desarrollando localmente debes usar una herramienta como ngrok
- El código fuente de este tutorial de https://github.com/Nexmo/ruby-customer-engagement/.
- Todos los clientes con sede en EE.UU. deben registrar una marca y una campaña para cumplir con 10 directrices DLC.
Configurar un número virtual de Vonage
Vonage reenvía los mensajes entrantes al punto final de webhook asociado con tu número virtual de Vonage.
La gestión de los Numbers virtuales se realiza a través de la opción API para desarrolladores o el CLI de Vonage. Los siguientes ejemplos utilizan la CLI de Vonage para alquilar un número de Vonage:
A continuación, asocie el número virtual a su punto final de webhook que gestiona los SMS entrantes:
NotaAsegúrese de que su servidor está en funcionamiento y disponible al público antes de asociar el punto final del webhook a su número virtual. número virtual. Vonage debe recibir una respuesta 200 OK de tu punto final de webhook para que la configuración sea exitosa. Si estás desarrollando localmente, utiliza una herramienta como ngrok para exponer su servidor web local a Internet.
Ahora que ha configurado su número virtual, puede enviar notificaciones de entrega de SMS.
Crear una aplicación web básica
Utilice Sinatra para crear una aplicación Web de una sola página:
Gemfile
app.rb
Añade un formulario HTML para recoger el número de teléfono al que enviarás un SMS de notificación:
vistas/index.erb
El formulario captura el número de teléfono en el campo E.164 esperado por SMS API:
Enviar una notificación SMS
En este tutorial, para enviar un SMS se añade el botón SDK de servidor de Vonage para Ruby a su aplicación:
Gemfile
Usa tu API de Vonage clave y secreto para inicializar el cliente:
app.rb
Notano almacene sus credenciales API en su código, utilice variables de entorno.
Para recibir respuestas a sus SMS de notificación, debe establecer su número virtual como SenderID para los mensajes salientes cuando realice una solicitud a SMS API:
app.rb
Para Verify que este SMS fue recibido por el cliente, compruebe el recibo de entrega. Este tutorial no verifica los recibos de entrega.
Procesar el SMS de respuesta
Cuando tu cliente responde a tu SMS de notificación, Vonage reenvía el mensaje de entrada a el punto final de webhook asociado al número virtual.
En esta aplicación tutorial se procesa el webhook entrante, se extrae el texto y el número, y se envía un mensaje de confirmación al cliente.
app.rb
El almacenamiento y la validación de las entradas de los clientes está fuera del alcance de este tutorial.
Ahora responde al SMS que has recibido antes. Deberías ver cómo tu aplicación lo procesa y recibir una confirmación de tu elección en cuestión de segundos.
Conclusión
Así de rápido es enviar y recibir SMS en tu aplicación. Con unas pocas líneas de código has enviado un SMS al teléfono de un cliente' de un cliente con la SMS API, gestionado una respuesta y respondido con una confirmación.
Obtener el código
Todo el código de este tutorial está disponible en el archivo SMS bidireccionales para captar clientes GitHub repo.