Wie man mit Python RCS-Bildnachrichten sendet

Reichhaltige Kommunikationsdienste (RCS) erweitern die herkömmlichen SMS und MMS um Funktionen wie hochauflösende Bilder, Videos und interaktive Elemente. Eine RCS-Bildnachricht ermöglicht es Unternehmen, Bilder direkt an die Standard-Messaging-Apps der Nutzer zu senden und so ein umfassenderes Kommunikationserlebnis zu schaffen.

In diesem Tutorial lernen Sie, wie Sie schnell Bilder über RCS Messaging mit Vonage's Messages API in Python.

TL;DR: Finden Sie den vollständigen funktionierenden Code auf GitHub.

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

Warum RCS für die Bereitstellung von Bildern verwenden?

Für die zuverlässigste Erfahrung mit größeren Medien (wie hochauflösende Bilder oder Videos) ist RCS die bevorzugte Option, wenn Ihre Nutzerbasis dies unterstützt. RCS ermöglicht im Vergleich zu herkömmlichen MMS viel größere und höher aufgelöste Bilder.

Die maximale Dateigröße für MMS beträgt 600 KB. Bei RCS liegt die Grenze bei 100 MB. Das ist eine Steigerung von 17.000 %!

> Hinweis: Die MMS-Grenzwerte variieren je nach Anbieter, Land und anderen Faktoren.

Voraussetzungen

Bevor Sie beginnen, vergewissern Sie sich, dass Sie über die folgenden Informationen verfügen:

• Python 3.6 oder höher auf Ihrem Rechner installiert ist.

• Ein Vonage API-Konto.

• Ein registrierter RCS Business Messaging (RBM) Agent.

• Ein Telefon mit eingehenden RCS-Funktionen für Tests.

Vonage API-Konto

Um dieses Tutorial durchzuführen, benötigen Sie ein Vonage API-Konto. Wenn Sie noch keines haben, können Sie sich noch heute anmelden und mit einem kostenlosen Guthaben beginnen. Sobald Sie ein Konto haben, finden Sie Ihren API-Schlüssel und Ihr API-Geheimnis oben auf dem Vonage-API-Dashboard.

Sind Sie bereit, mit dem Bau zu beginnen?

Erleben Sie nahtlose Konnektivität, Echtzeit-Messaging und kristallklare Sprach- und Videoanrufe - alles auf Knopfdruck.

So kontaktieren Sie Ihren Vonage Account Manager

Um RCS-Funktionen in Ihrer Vonage-Anwendung senden und empfangen zu können, benötigen Sie einen registrierten Rich Business Messaging (RBM)-Agenten und ein Telefon mit RCS-Funktionen.

Derzeit ist RCS Messaging über Vonage nur für verwaltete Accounts verfügbar. Sie müssen Ihren Account Manager kontaktieren, um die Aktivierung des Entwicklermodus für Ihren RBM-Agenten zu beantragen. Der Entwicklermodus ermöglicht es Ihnen, RCS Messaging an zugelassene Numbers zu testen, bevor Sie den Agent-Verifizierungsprozess abschließen und in die Produktion einsteigen.

Bitte kontaktieren Sie unser Verkaufsteam wenn Sie noch keinen verwalteten Account haben.

>> Verstehen Sie den Unterschied zwischen RCS und RBM.

Schritt 1: Erstellen Sie Ihr Projekt und installieren Sie die Abhängigkeiten

• Erstellen Sie Ihren Projektordner und Ihre Dateien.

mkdir python_send_rcs_image
cd python_send_rcs_image
touch .env send_rcs_image.py

• Richten Sie eine virtuelle Umgebung ein.

Dadurch wird sichergestellt, dass Ihre Abhängigkeiten von Ihrem System Python isoliert bleiben.

python3 -m venv venv
source venv/bin/activate

• Installieren Sie die erforderlichen Pakete.

Zusätzlich zum Vonage SDK werden wir dotenv verwenden, um unsere Vonage-Anmeldedaten sicher zu speichern und darauf zuzugreifen.

pip install vonage python-dotenv

Schritt 2: Einrichten Ihrer Vonage-Anwendung

Ihr Python-Skript wird die Vonage Messages API verwenden. Erstellen Sie dazu eine Vonage-Anwendung im Vonage Dashboard mit aktivierter Messages API-Funktion.

In den Einstellungen Ihrer Vonage-Anwendung:

1. Setzen Sie die Eingangs-URL auf https://example.com/inbound_rcs.

2. Setzen Sie die Status-URL auf https://example.com/rcs_statusEingehende Nachrichten und Nachrichtenstatus werden in einem späteren Artikel behandelt. Im Moment können wir nur Platzhalter verwenden.

3. Erzeugen Sie einen öffentlichen und einen privaten Schlüssel, indem Sie auf die Schaltfläche klicken. Stellen Sie sicher, dass Sie Ihren private.key Datei in das Stammverzeichnis des Projekts (/python_send_rcs_image).

4. Speichern Sie die Änderungen.

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

Verknüpfen Sie dann Ihren RCS-Agenten, indem Sie auf die Schaltfläche "Externe Konten verknüpfen" Registerkarte:

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

Jetzt können Sie Ihre Anmeldedaten in Ihre .env Datei hinzufügen.

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

Schritt 3: Schreiben des Python-Skripts zum Senden einer RCS-Image-Nachricht

Erstellen Sie eine Python-Datei (send_rcs_image.py) mit dem folgenden Inhalt:

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)

Stellen Sie sicher, dass die an_nummer eine Telefonnummer mit RCS-Fähigkeiten ist und dass die bild_url eine öffentlich zugängliche URL ist, die auf Ihr Bild verweist. Beachten Sie, dass die von Feld Ihre RBM SenderID (der Name der Marke) ist. Die SenderID erfordert eine besondere Formatierung, z. B. ohne Leerzeichen. Wenden Sie sich an Ihren Account Manager, wenn Sie unsicher sind.

Schritt 4: Ausführen des Skripts

Führen Sie das Skript mit dem folgenden Befehl aus:

python send_rcs_image.py

Bei Erfolg enthält die Antwort eine message_uuiddie anzeigt, dass die Nachricht zur Zustellung angenommen wurde.

Schlussfolgerung

Sie haben nun gelernt, wie man RCS-Bildnachrichten mit Python und der Vonage Messages API versendet. Welche RCS-Fähigkeit werden Sie als nächstes erforschen? Sie können die vollständige Liste der RCS Nachrichtenfähigkeiten finden Sie in der Entwicklerdokumentation.

Lassen Sie uns wissen, woran Sie arbeiten, oder bitten Sie uns um Hilfe auf unserem Gemeinschaft Slackoder X, ehemals Twitter.