Comment envoyer des messages d'image RCS avec Python

Les services de communication riches (RCS) améliorent les SMS et MMS traditionnels en permettant l'utilisation de fonctionnalités telles que les images haute résolution, les vidéos et les éléments interactifs. Un message image RCS permet aux entreprises d'envoyer des images directement aux applications de messagerie par défaut des utilisateurs, offrant ainsi une expérience de communication plus riche.

Dans ce tutoriel, vous apprendrez comment envoyer rapidement des images à l'aide de la messagerie RCS avec l'API de messages de Vonage. Messages API de Vonage en Python.

TL;DR : Trouvez le code complet sur GitHub. sur GitHub.

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

Pourquoi utiliser RCS pour la diffusion d'images ?

Pour une expérience plus fiable avec des médias plus importants (comme des images ou des vidéos en haute résolution), le RCS est l'option préférée si votre base d'utilisateurs le supporte. Le RCS permet d'envoyer des images beaucoup plus grandes et de plus haute résolution que les MMS traditionnels.

La taille maximale des fichiers pour les MMS est de 600 KB. Pour le RCS, la limite est de 100 Mo. C'est une augmentation de 17 000 % !

> Remarque : Les limites de MMS varient selon l'opérateur, le pays, etc.

Conditions préalables

Avant de commencer, assurez-vous que vous disposez des éléments suivants :

• Python 3.6 ou supérieur est installé sur votre machine.

• Un compte API Vonage.

• Un agent RCS Business Messaging (RBM) enregistré.

• Un téléphone avec des capacités RCS entrantes pour les tests.

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.

Comment contacter votre Account Manager de Vonage

Afin d'envoyer et de recevoir des capacités RCS dans votre application Vonage, vous devez disposer d'un agent Rich Business Messaging (RBM) enregistré et d'un téléphone doté de capacités RCS.

Actuellement, la messagerie RCS via Vonage n'est disponible que pour les comptes gérés. Vous devrez contacter votre Account Manager pour demander l'activation du mode développeur pour votre agent RBM. Le mode développeur vous permet de tester la messagerie RCS vers des numéros inscrits sur la liste d'autorisation avant de terminer le processus de vérification de l'agent et de lancer en production.

Veuillez contacter contacter notre équipe de vente si vous n'avez pas de compte géré.

>> Comprendre la différence la différence entre RCS et RBM.

Étape 1 : Créer votre projet et installer les dépendances

• Créez le dossier et les fichiers de votre projet.

mkdir python_send_rcs_image
cd python_send_rcs_image
touch .env send_rcs_image.py

• Mettre en place un environnement virtuel.

Cela garantit que vos dépendances restent isolées de votre système Python.

python3 -m venv venv
source venv/bin/activate

• Installez les paquets nécessaires.

En plus du SDK Vonage, nous utiliserons dotenv pour stocker et accéder en toute sécurité à nos informations d'identification Vonage.

pip install vonage python-dotenv

Étape 2 : Configurer votre application Vonage

Votre script Python utilisera l'API Messages de Vonage. Pour ce faire, créez une application Vonage dans la section tableau de bord de Vonage avec la capacité API Messages activée.

Dans les paramètres de votre application Vonage :

1. Définissez l'URL entrante sur https://example.com/inbound_rcs.

2. Définissez l'URL de l'état comme suit https://example.com/rcs_statusLes messages entrants et les statuts des messages seront traités dans un prochain article. Pour l'instant, nous pouvons nous contenter d'utiliser des caractères génériques.

3. Générez une clé publique et une clé privée en cliquant sur le bouton. Veillez à déplacer votre clé.privée dans le répertoire racine du projet (/python_send_rcs_image).

4. Enregistrez les modifications.

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

Reliez ensuite votre agent RCS en cliquant sur le bouton "Lier des Account externes" l'onglet "Lier des comptes externes" :

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

Et maintenant, vous pouvez ajouter vos informations d'identification à votre fichier .env fichier

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

Étape 3 : Écrire le script Python pour envoyer un message RCS Image

Créez un fichier Python (send_rcs_image.py) avec le contenu suivant :

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)

Veillez à ce que le paramètre to_number est un numéro de téléphone avec des capacités RCS et que l'élément image_url est une URL publiquement accessible pointant vers votre image. Notez que l'élément from est votre RBM SenderID (le nom de la marque). Le SenderID nécessite un formatage particulier, notamment l'absence d'espaces. En cas de doute, consultez votre Account Manager.

Étape 4 : Exécuter le script

Exécutez le script à l'aide de la commande suivante :

python send_rcs_image.py

En cas de succès, la réponse contiendra un message_uuidindiquant que le message a été accepté pour livraison.

Conclusion

Vous avez maintenant appris à envoyer des messages d'image RCS en utilisant Python et l'API Messages de Vonage. Quelle capacité RCS allez-vous explorer ensuite ? Vous pouvez consulter la liste complète des capacités de messages RCS dans la documentation du développeur. dans la documentation destinée aux développeurs.

N'oubliez pas de nous faire savoir sur quoi vous travaillez ou de nous demander de l'aide sur notre Communauté Slackou sur X, anciennement Twitter.