You are viewing the Spanish (Mexico) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Calificar esta página:

Inicio rápido para la mensajería programable de WhatsApp Ruby

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, Ruby, Twilio Ruby, la biblioteca auxiliar de Twilio y el marco web del Sinatra. En este inicio rápido, aprenderás lo siguiente:

  1. Registrarte en Twilio y activar el Sandbox.
  2. Configurar tu entorno de desarrollo para enviar y recibir mensajes.
  3. Suscribirte al Sandbox.
  4. Enviar tu primer mensaje de WhatsApp.
  5. Recibir mensajes entrantes de WhatsApp.
  6. Responder mensajes entrantes de WhatsApp.
¡Muéstrame cómo se hace!

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.

WA_Sandbox.png

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.

¡El canal WhatsApp está instalado! ¿Qué sigue?

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

Account Credentials

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.

Bien, las credenciales de la cuenta están entregados…

Configura tu entorno de desarrollo Ruby

Los siguientes pasos implican escribir algún código. Hemos creado la configuración del entorno de desarrollo Ruby, en la que podrás configurar un entorno de desarrollo y prepararte para crear una aplicación web sencilla con Sinatra.

Si aún no has configurado tu entorno de desarrollo para escribir algunos Ruby, dirígete allí primero a fin de prepararte. Este inicio rápido estará esperando.

El Ruby se ve brillante, ¡vamos a escribir un código!

Envía un mensaje con WhatsApp en Ruby

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).

Screen Shot 2018-08-01 at 8.31.05 AM.png

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.

whatsapp-sandbox-opt-in-qr.png

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.

        
        
        
        Fantástico. Ahora, ¿cómo recibo mensajes?

        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.

        Configure WhatsApp Sandbox Webhook

        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 Ruby te muestra cómo responder a un mensaje y generar TwiML en Ruby con Sinatra.

        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.

        ¿Dónde ir a continuación?

        ¿Qué sigue para WhatsApp y Ruby?

        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.

        ¡Nos emociona ver qué tipo de integración de WhatsApp construirás!

        Calificar esta página:

        ¿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.

              
              
              

              Gracias por tus comentarios.

              Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

              Enviando tus comentarios…
              🎉 Gracias por tus comentarios.
              Se produjo un error. Inténtalo de nuevo.

              Gracias por tus comentarios.

              ¡Recomiéndanos y gana USD 10 en 3 pasos sencillos!

              Paso 1

              Obtén un enlace

              Obtén un enlace gratuito de referencia personal aquí

              Paso 2

              Regala USD 10

              Tu usuario se registra y actualiza mediante el enlace

              Paso 3

              Obtén USD 10

              1250 SMS gratuitos
              O 1000 minutos gratuitos de voz
              O 12 000 chats
              O más