Inicio rápido de SMS programable de Python
Ahoy there! All messaging transmitted using Twilio’s messaging channels is treated as Application-to-Person (A2P) messaging and subject to Twilio’s Messaging Policy. For detailed information on policy rules to ensure you remain compliant while using Twilio’s services, please see our Acceptable Use Policy.
Con una pocas líneas de código, tu aplicación Python puede enviar mensajes SMS con Twilio Programmable Messaging.
Este inicio rápido de Programmable Messaging te guiará a través de todo el proceso paso a paso, desde la configuración de tu cuenta de Twilio hasta el envío de un SMS utilizando un Messaging Service (Servicio de mensajería).
En este inicio rápido, aprenderás lo siguiente:
- Registrarte en Twilio y obtener tu primer número de teléfono habilitado para SMS
- Configurar tu entorno de desarrollo para enviar mensajes salientes
- Enviar tu primer SMS saliente
- Configurar tu primer Messaging Service (Servicio de mensajería) de Twilio
- Enviar un segundo SMS desde ese Messaging Service (Servicio de mensajería)
Al final de este inicio rápido, contarás con una base sólida para construir y escalar con Programmable Messaging de Twilio para tus casos de uso específicos.
Regístrate (o inicia sesión) en tu cuenta de Twilio
¿Ya tienes una cuenta de Twilio? Avanza y omite esta sección.
Puedes registrarte en una cuenta de prueba gratuita de Twilio aquí.
- Cuando te registres, deberás verificar tu número de teléfono personal. Esto ayuda a Twilio a verificar tu identidad y te permite enviar mensajes a tu teléfono desde tu cuenta Twilio mientras estés en el modo de prueba.
- Una vez que hayas verificado tu número, deberás responder una serie de preguntas para personalizar tu experiencia.
- Tras haber finalizado el flujo de onboarding, accederás al panel de control de tu proyecto en la consola de Twilio. Aquí tendrás acceso a tu Account SID (SID de la cuenta) y Auth Token (token de autenticación), podrás buscar un número de teléfono de Twilio y más.
Si actualmente no posees un número de teléfono de Twilio con la funcionalidad SMS, deberás comprar uno. Después de explorar la página Buy a number (Compra un número), marca la casilla "SMS" y haz clic en "Search." (Buscar).
A continuación, verás una lista de números de teléfono disponibles y sus funcionalidades. Busca un número que te parezca adecuado y haz clic en "Buy" (Comprar) para agregarlo a tu cuenta.
Instala la CLI de Twilio
Utilizaremos la CLI (interfaz de línea de comandos) de Twilio para algunas tareas, así que procedamos a instalarla.
La manera recomendada de instalar twilio-cli en macOS es a través de Homebrew. Si aún no lo has instalado, visita el sitio web de Homebrew para ver las instrucciones de instalación y, luego, vuelve aquí.
Una vez que hayas instalado Homebrew, ejecuta el siguiente comando para instalar twilio-cli:
rew tap twilio/brew && brew install twilioLa manera recomendada de instalar twilio-cli es mediante el uso de Scoop, un instalador de línea de comandos para Windows. Si aún no lo has instalado, visita el sitio web de Scoop para ver las instrucciones de instalación y, luego, vuelve aquí.
Ten en cuenta que PowerShell necesitará ejecutarse como administrador para evitar los problemas de permisos habituales con la instalación a través de Scoop.
- Agrega el Bucket
twilio-cli:
scoop bucket add twilio-scoop https://github.com/twilio/scoop-twilio-cli - Instala la app:
scoop install twilio
twilio-cli se puede instalar con la Herramienta Avanzada de Empaquetado (apt) que está disponible en la mayoría de las distribuciones, como Debian, Ubuntu y Mint.
Para hacerlo, ejecuta los siguientes comandos en tu terminal:
wget -qO- https://twilio-cli-prod.s3.amazonaws.com/twilio_pub.asc \
| sudo apt-key add -
sudo touch /etc/apt/sources.list.d/twilio.list
echo 'deb https://twilio-cli-prod.s3.amazonaws.com/apt/ /' \
| sudo tee /etc/apt/sources.list.d/twilio.list
sudo apt update
sudo apt install -y twilioPara conocer otros métodos de instalación, consulta el Inicio rápido de la CLI de Twilio.
Log in to the Twilio CLI
Run twilio login to get the Twilio CLI connected to your account. Visit the Twilio Console, and under Account Info, you’ll find your unique Account SID and Auth Token to provide to the CLI.
Once you have your SMS-enabled Twilio phone number and the Twilio CLI, you can proceed to install Python and the Twilio Python Helper Library.
Instala Python y la biblioteca auxiliar de Twilio
Si ya has visto uno de nuestros inicios rápidos de Python e instalado Python y la biblioteca auxiliar de Twilio Python, puedes omitir este paso y proceder directamente a enviar tu primer mensaje de texto.
Para enviar tu primer SMS, deberás tener Python y la biblioteca auxiliar de Twilio Python instalados.
Instala Python
Si estás utilizando un equipo Mac o Linux, probablemente ya tengas Python instalado. Para comprobarlo, abre un terminal y ejecuta el siguiente comando:
python --versionDeberías ver algo como esto:
$ python --version
Python 3.4Los usuarios de Windows pueden seguir este excelente tutorial para instalar Python en Windows, o bien pueden seguir las instrucciones de la documentación de Python.
El SDK del servidor de Python de Twilio es compatible con Python 2 y Python 3. Puedes utilizar cualquier versión para este inicio rápido, pero recomendamos Python 3 para proyectos futuros con Twilio, a menos que existan bibliotecas específicas que tu proyecto necesite y que sean compatibles solo con Python 2.
Instala el SDK del servidor de Twilio Python
La forma más sencilla de instalar la biblioteca es utilizando pip, un administrador de paquetes de Python que facilita la instalación de las bibliotecas que necesites. Simplemente ejecuta esto en el terminal:
pip install twilioSi aparece el error pip: command not found, también puedes utilizar easy_install; para ello, ejecuta esto en tu terminal:
easy_install twilioSi prefieres una instalación manual, puedesdescargar el código fuente (ZIP) para twilio-pythony, luego, instalar la biblioteca ejecutando:
python setup.py installen la carpeta que contiene el código de la biblioteca del SDK del servidor twilio-python.
Envía un SMS saliente con Python
Ahora que Python y twilio-python se encuentran instalados, podemos enviar un mensaje de texto saliente desde el número de teléfono de Twilio que acabamos de comprar con una solicitud de API única. Crea y abre un nuevo archivo denominado send_sms.py y escribe o pega este ejemplo de código.
You’ll need to edit your send_sms.py file a little more before your message will send.
Reemplaza los valores de las credenciales del marcador de posición
Swap the placeholder values for account_sid and auth_token with your personal Twilio credentials. You can find these values in your Twilio console, as described previously.
Abre send_sms.py y reemplaza los valores de account_sid y auth_token con tus valores únicos.
Ten en cuenta lo siguiente: está bien codificar de forma fija tus credenciales cuando comiences, pero debes utilizar variables de entorno para mantenerlas en secreto antes de implementarlas en producción. Consulta cómo configurar las variables de entorno para obtener más información.
Reemplaza el número de teléfono from_
¿Recuerdas el número de teléfono habilitado para SMS que compraste hace unos minutos? Utilízalo para reemplazar el número from_ (desde) existente, asegurándote de usar el formato E.164:
[+][código del país][número de teléfono con el código de área]
Reemplaza el número de teléfono to
Reemplaza el número de teléfono to (para) por tu número de teléfono celular. Este puede ser cualquier número de teléfono que pueda recibir mensajes de texto, pero es una buena idea probar con tu propio teléfono, para que puedas ser testigo de la magia. Según se indicó anteriormente, utiliza el formato E.164 para este valor.
Si estás en una cuenta de prueba gratuita de Twilio, tus mensajes SMS salientes están limitados a números de teléfono que hayas verificado con Twilio. Los números de teléfono se pueden verificar a través de la ID de agente de llamada verificado de tu consola de Twilio.
Cuando envías un SMS desde tu número de teléfono de prueba gratuito, siempre comenzará con "Sent from a Twilio trial account." (Enviado desde una cuenta de prueba gratuita de Twilio). Eliminaremos este mensaje después de la actualización.
Guarda los cambios y ejecuta este comando desde tu terminal:
python send_sms.py¡Eso es todo! En un momento, deberías recibir un SMS desde tu número de Twilio en tu teléfono.
En este ejemplo de código, estamos realizando una solicitud POST al punto final del mensaje de la API de Programmable Messaging, para crear un nuevo mensaje saliente. Estamos utilizando el método create integrado en la biblioteca twilio-python, pero podrías realizar esta solicitud mediante la CLI de Twilio (que ya has instalado), curl o un módulo de solicitud de tu elección.
Consulta los ejemplos de código para enviar un SMS con la CLI de Twilio y curl. ¡No olvides actualizar los parámetros body, to y from!
Are your customers in the U.S. or Canada? You can also send them MMS messages by adding just one line of code. Check out this guide to sending MMS to see how it's done.
Configura un Messaging Service (Servicio de mensajería) de Twilio
Felicitaciones, has enviado tu primer SMS con Twilio Programmable Messaging y lo has recibido en tu dispositivo personal.
En este punto, hemos adquirido un número de teléfono de Twilio y lo hemos utilizado para enviar un SMS saliente. Puedes imaginar un futuro no muy lejano en el cual necesitarás una manera más sólida y con más funciones para enviar mensajes, por ejemplo:
- Sending many messages over a short period of time
- Handling opt-ins and opt-outs
- Ensuring that your customers always receive a consistent messaging experience with the same phone number.
En la siguiente parte del inicio rápido, veremos cómo configurar tu primer Messaging Service (Servicio de mensajería). Un Messaging Service (Servicio de mensajería) es como un contenedor que almacena todos tus números de teléfono disponibles (y otros remitentes) y que incluye funciones que puedes necesitar durante tu recorrido de mensajería.
Crea un Messaging Service (Servicio de mensajería) con tu número de teléfono
Ejecuta el siguiente comando de la CLI de Twilio para crear un Messaging Service (Servicio de mensajería) que usaremos para enviar nuestro primer SMS programable.
twilio api:messaging:v1:services:create --friendly-name "My first Messaging Service"Toma nota del SID del Messaging Service (Servicio de mensajería) (comienza con “MGXXX...”). Lo necesitaremos para enviar nuestro próximo mensaje.
A continuación, agrega el número de teléfono que acabas de comprar. ¿Ya olvidaste el número? No te preocupes, puedes registrarlo con la CLI de Twilio:
twilio phone-numbers:list
# Obtén el SID ("PNXXXX...") de tu númeroAgrega tu número de teléfono a tu Messaging Service (Servicio de mensajería) recién creado con el siguiente comando:
twilio api:messaging:v1:services:phone-numbers:create --service-sid MGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --phone-number-sid PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Envía un SMS desde tu Messaging Service (Servicio de mensajería)
El envío de un SMS saliente desde un Messaging Service (Servicio de mensajería) es similar al envío desde un número de teléfono de Twilio individual. La principal diferencia es el reemplazo del parámetro from_ por el messaging_service_sid para indicar que se está enviando desde un número de teléfono dentro del conjunto de remitentes de tu Messaging Service (Servicio de mensajería). (Actualmente, solo hay un número de teléfono en tu conjunto de remitentes, por lo cual haremos el envío desde ese).
Reemplaza el parámetro messaging_service_sid
Remember that Messaging Service you just created? We will modify the code from the first example to use your Messaging Service to send a message. Go ahead and open the send_sms.py file you used for that example. In that file, instead of the from_ parameter and your phone number, use the messaging_service_sid parameter with the "MGXXXX..." of your Messaging Service SID. Save your changes and run this script from your terminal:
python send_sms.pyAnd that’s it to send an SMS using a Twilio Messaging Service! In a few seconds, you should receive a second SMS on your phone from your Twilio phone number. The Messaging Service seamlessly selected your number from its Sender Pool to send that second outbound message.
¿Dónde ir a continuación?
Now that you've sent your first SMS messages, check out the following resources to continue your messaging journey with Twilio:
- Learn about inbound messages with Receive and Reply to SMS and MMS messages.
- Want to send with WhatsApp? Check out our WhatsApp Quickstart for Python and our guide to Sending WhatsApp Notifications with Templates.
- Build Server Notifications with Twilio Programmable Messaging.
- Dive into the API Reference documentation for Twilio SMS.
- Track the delivery status of your messages with Python.
¡Nos emociona ver lo que 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.
