Cómo enviar mensajes de imagen RCS con Python

Servicios de Comunicación Enriquecidos (RCS) mejoran los SMS y MMS tradicionales con funciones como imágenes de alta resolución, vídeos y elementos interactivos. Un mensaje de imagen RCS permite a las empresas enviar imágenes directamente a las aplicaciones de mensajería predeterminadas de los usuarios, proporcionando una experiencia de comunicación más rica.

En este tutorial, aprenderás a enviar imágenes rápidamente mediante la mensajería RCS con la Messages API de Vonage en Python.

TL;DR: Encuentre el código completo en GitHub.

RCS message showcasing an image sent via the Vonage Messages API, featuring the Vonage Developer Relations team at a conference booth.

¿Por qué utilizar RCS para la entrega de imágenes?

Para obtener la experiencia más fiable con medios de mayor tamaño (como imágenes o vídeos de alta resolución), RCS es la opción preferida si su base de usuarios lo admite. RCS permite imágenes mucho más grandes y de mayor resolución que los MMS tradicionales.

El tamaño máximo de archivo para MMS es de 600 KB. Para RCS, el límite es de 100 MB. Es decir, ¡un 17.000% más!

> Nota: Los límites de MMS varían según el operador, el país, etc.

Requisitos previos

Antes de empezar, asegúrate de tener lo siguiente:

• Python 3.6 o superior está instalado en su máquina.

• Una cuenta API de Vonage.

• Un agente registrado de RCS Business Messaging (RBM).

• Un teléfono con capacidades RCS entrantes para realizar pruebas.

Vonage API Account

To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

Ready to start building?

Experience seamless connectivity, real-time messaging, and crystal-clear voice and video calls—all at your fingertips.

Cómo contactar a tu administrador de cuentas de Vonage

Para poder enviar y recibir funciones RCS en tu aplicación de Vonage, deberás tener un agente registrado de Rich Business Messaging (RBM) y un teléfono con capacidades de RCS.

Actualmente, la mensajería RCS a través de Vonage sólo está disponible para cuentas administradas. Deberás comunicarte con tu administrador de cuenta para solicitar la activación del modo para desarrolladores para tu agente de RBM. El modo para desarrolladores te permite probar la mensajería RCS a números permitidos antes de completar el proceso de verificación del agente y lanzarlo en producción.

Por favor póngase en contacto con nuestro equipo de ventas si no tiene una cuenta gestionada.

>> Comprender la diferencia entre RCS y RBM.

Paso 1: Crear el proyecto e instalar las dependencias

• Crea la carpeta y los archivos de tu proyecto.

mkdir python_send_rcs_image
cd python_send_rcs_image
touch .env send_rcs_image.py

• Configure un entorno virtual.

Esto asegura que tus dependencias permanezcan aisladas de tu sistema Python.

python3 -m venv venv
source venv/bin/activate

• Instale los paquetes necesarios.

Además del SDK de Vonage, utilizaremos dotenv para almacenar y acceder de forma segura a nuestras credenciales de Vonage.

pip install vonage python-dotenv

Paso 2: configura tu aplicación de Vonage

Tu script de Python utilizará la API de Messages API de Vonage. Para ello, crea una aplicación de Vonage en el Panel de Vonage con la función Messages API habilitada.

En la configuración de tu aplicación de Vonage:

1. Establezca la URL de entrada en https://example.com/inbound_rcs.

2. Establezca la URL de estado en https://example.com/rcs_statusLos mensajes entrantes y los estados de los mensajes se tratarán en un próximo artículo. Por ahora podemos utilizar marcadores de posición.

3. Genere una clave pública y privada haciendo clic en el botón. Asegúrese de mover su private.key al directorio raíz del proyecto (/python_send_rcs_image).

4. Guarda los cambios.

Vonage Developer Dashboard interface for creating a new application with RCS messaging capabilities, including webhook configuration and key authentication setup.

A continuación, vincule su Agente RCS haciendo clic en el botón "Vincular cuentas externas" pestaña:

Dashboard view of the Vonage Python RCS application showing linked external account details, application metadata, and configuration for Voice and Messages APIs.

Y ahora puedes añadir tus credenciales a tu archivo .env archivo.

VONAGE_APPLICATION_ID=your_application_id
VONAGE_PRIVATE_KEY_PATH=./private.key
RCS_SENDER_ID=your_rbm_agent_id

Paso 3: Escribir el Script Python para Enviar un Mensaje de Imagen RCS

Cree un archivo Python (send_rcs_image.py) con el siguiente contenido:

import os
from dotenv import load_dotenv
from vonage import Auth, Vonage
from vonage_messages import RcsImage, RcsResource

# Load environment variables
load_dotenv()

# Initialize Vonage Auth and client
auth = Auth(
    application_id=os.getenv("VONAGE_APPLICATION_ID"),
    private_key=os.getenv("VONAGE_PRIVATE_KEY_PATH"),
)
vonage_client = Vonage(auth)

# Define the recipient's phone number and image URL
to_number = "###########"  # Your recipient's phone number
image_url = "https://www.vonage.com/content/dam/vonage/us-en/api/imagery/RCS_iPhoneScreen_V2-scaled.png" # Replace with your image_url

# Construct the RCS Image message
message = RcsImage(
    from_=os.getenv("RCS_SENDER_ID"),
    to=to_number,
    image=RcsResource(url=image_url),
)

# Send the message
response = vonage_client.messages.send(message)
print(response)

Asegúrese de que to_number sea un número de teléfono con capacidades RCS y que el campo URL_de_la_imagen sea una URL de acceso público que apunte a tu imagen. Tenga en cuenta que el campo de es su RBM SenderID (el nombre de la marca). El SenderID requiere un formato especial, como no tener espacios. Consulte con su Account Manager si no está seguro.

Paso 4: Ejecutar el script

Ejecute el script utilizando el siguiente comando:

python send_rcs_image.py

Si tiene éxito, la respuesta contendrá un mensaje_uuidque indica que el mensaje ha sido aceptado para su entrega.

Conclusión

Ahora has aprendido a enviar mensajes de imagen RCS utilizando Python y la API Messages API de Vonage. ¿Qué capacidad de RCS explorarás a continuación? Puedes ver la lista completa de capacidades de capacidades de mensajes en la documentación para desarrolladores.

No dejes de contarnos en qué estás trabajando o de pedir ayuda en nuestra Comunidad Slacko en X, antes Twitter.