RCS-Nachrichten über Twilio

RCS-Nachrichten (Rich Communication Services) kommen in der integrierten Nachrichten-App des Telefons als Chat von Ihrer Marke an, mit Ihrem Logo und einer Karte, einem Karussell, Medien oder Schaltflächen statt reinem Text. Pushwoosh versendet sie über Twilio als Teil des SMS-Kanals.

So funktioniert es

Eine RCS-Nachricht gelangt in drei Schritten von einer Twilio-Vorlage auf das Telefon:

Sie erstellen die Nachricht als Content-Vorlage in Twilio.
Sie wählen die Vorlage in einer SMS-Voreinstellung aus. Jede Sprache der Voreinstellung kann ihre eigene Vorlage haben.
Wenn die Voreinstellung gesendet wird, versucht Twilio, die Vorlage über RCS zuzustellen. Telefone, die kein RCS empfangen können, erhalten stattdessen eine SMS, wie unter SMS-Fallback beschrieben.

Wenn Sie nur für einige Sprachen der Voreinstellung eine Vorlage auswählen, werden die übrigen Sprachen nicht über RCS gesendet. Sie gehen als normale SMS mit dem Text aus ihrem Feld Nachricht hinaus.

SMS-Fallback

Der SMS-Fallback ist das, was Telefone ohne RCS anstelle der RCS-Nachricht erhalten. Wenn das Telefon oder der Mobilfunkanbieter des Empfängers RCS nicht unterstützt, sendet Twilio eine SMS, die aus dem Typ Text der Vorlage erstellt wird.

Der SMS-Fallback stammt aus der Vorlage, nicht aus dem Feld Nachricht der Voreinstellung. Hat die Vorlage keinen Typ Text, erhalten Telefone ohne RCS die Nachricht überhaupt nicht.

Voraussetzungen für den RCS-Versand

RCS funktioniert nur über Ihr eigenes Twilio-Konto mit einem Messaging Service und einem von Mobilfunkanbietern genehmigten RCS-Absender.

Twilio als SMS-Anbieter. Verbinden Sie es mit Ihrer eigenen Twilio-Account SID und Ihrem eigenen Auth token. Wenn Pushwoosh die Twilio-Nummer und die Anmeldeinformationen für Ihr Projekt bereitstellt, ist RCS nicht verfügbar, und solche Sendungen werden abgelehnt.
Ein Twilio Messaging Service. Sein Absenderpool enthält einen RCS-Absender und eine SMS-Nummer. Seine SID gehört in das Feld Messaging Service SID in den Einstellungen der SMS-Plattform. Ohne sie schlägt der Versand einer Nachricht mit Vorlage fehl.
Eine Absendernummer (From). Tragen Sie in den Einstellungen der SMS-Plattform die SMS-Nummer aus dem Pool des Messaging Service ein. Ohne sie sendet Pushwoosh keine Twilio-SMS, selbst wenn ein Messaging Service festgelegt ist.
Ein von Mobilfunkanbietern genehmigter RCS-Absender in den Ländern, in die Sie senden. Die Registrierung übernimmt Twilio. Laut Twilio dauert sie 4–6 Wochen oder länger pro Land.

RCS in Twilio einrichten

Diese Schritte erfolgen in der Twilio Console. Die Menünamen folgen dem Twilio-Leitfaden zum RCS-Onboarding und können in Ihrer Konsole leicht abweichen.

Einen RCS-Absender erstellen

Der RCS-Absender ist das Markenprofil, das Empfänger im Chat sehen: Ihr Name, Ihr Logo und Ihre Farben.

Gehen Sie zu Communications → Numbers & senders → Overview → RCS.
Klicken Sie auf Create RCS Sender.
Geben Sie einen Sender display name ein.
Akzeptieren Sie die Bedingungen und klicken Sie auf Continue.
Füllen Sie unter Public details alle Felder aus:
- Display name und Description.
- Logo image (224×224 px, bis zu 50 KB) und Banner image (1440×448 px, bis zu 200 KB) als öffentliche JPG- oder PNG-URLs.
- Accent color mit einem Kontrastverhältnis von mindestens 4,5:1 gegenüber Weiß, zum Beispiel #1A73E8.
- Eine Kontakttelefonnummer oder E-Mail-Adresse, eine Privacy policy URL und eine Terms of service URL.
Klicken Sie auf Next.

Ein Testtelefon hinzufügen

Bis die Mobilfunkanbieter den Absender genehmigen, stellt er nur an Testtelefone zu.

Klicken Sie unter Try it out auf Add device to test this sender.
Geben Sie eine Android-Telefonnummer im internationalen Format ein und klicken Sie auf Invite.
Öffnen Sie auf dem Telefon die Einladung in Google Messages und tippen Sie auf Make me a tester.
Bestätigen Sie in der Konsole, dass der Inhaber die Einladung angenommen hat.
Senden Sie eine Nachricht über Your message. Sie sollte als Chat von Ihrer Marke mit dem Logo ankommen, nicht als SMS.

Den Absender bei Mobilfunkanbietern registrieren

Twilio fügt einen RCS-Absender erst dann zu einem Messaging Service hinzu, wenn mindestens ein Mobilfunkanbieter ihn genehmigt hat. Beginnen Sie die Registrierung daher, bevor Sie den Messaging Service erstellen.

Öffnen Sie beim RCS-Absender Compliance registration.
Klicken Sie auf Add countries.
Wählen Sie die Länder aus, in die Sie senden, und klicken Sie auf Save countries.
Klicken Sie auf Start.
Füllen Sie das Formular aus und klicken Sie auf Submit registration. Für die USA hat Twilio ein separates Formular US registration.

Der Registrierungsstatus lautet Pending Review, bis die Mobilfunkanbieter sie genehmigen.

Einen Messaging Service erstellen

Der Messaging Service fasst den RCS-Absender und eine SMS-Nummer zusammen, sodass Twilio für jedes Telefon RCS oder SMS wählen kann.

Gehen Sie zu Messaging → Services.
Erstellen Sie einen Service.
Fügen Sie unter Sender Pool eine SMS-fähige Twilio-Nummer hinzu. Ohne sie erhalten Telefone ohne RCS nichts.
Sobald mindestens ein Land unter Compliance registration den Status Approved hat, fügen Sie den RCS-Absender zum Sender Pool hinzu.
Kopieren Sie die SID des Service. Sie beginnt mit MG.

Eine Content-Vorlage erstellen

Die Content-Vorlage legt die RCS-Nachricht und ihren SMS-Fallback fest.

Gehen Sie zu Messaging → Content Template Builder.
Klicken Sie auf Create new.
Wählen Sie einen RCS-fähigen Typ: Card, Carousel, Quick reply, Call to action oder Media.
Füllen Sie den Inhalt aus. Für einen Wert, der sich je nach Empfänger ändert, verwenden Sie eine nummerierte Variable, zum Beispiel {{1}} für den Vornamen im Kartentitel.
Um eine Journey anhand der Antwort zu verzweigen, fügen Sie Schnellantwort-Schaltflächen hinzu und geben Sie jeder eine ID. Verwenden Sie nicht default oder eine ID, die mit output beginnt: Eine solche Schaltfläche erhält keinen Zweig in der Journey.
Fügen Sie derselben Vorlage den Typ Text hinzu. Twilio erstellt daraus den SMS-Fallback.
Speichern Sie die Vorlage.

Twilio in Pushwoosh verbinden

Pushwoosh sendet RCS mit den Twilio-Anmeldeinformationen und dem Messaging Service, die Sie in den Einstellungen der SMS-Plattform eingeben.

Gehen Sie zu Einstellungen → Plattformen konfigurieren.
Öffnen Sie SMS.
Legen Sie Twilio als SMS-Anbieter fest.
Füllen Sie die Felder aus:
- From number: die SMS-Nummer aus dem Pool des Messaging Service.
- Account SID und Auth token: die Anmeldeinformationen des Twilio-Kontos, dem der RCS-Absender und die Vorlagen gehören.
- Messaging Service SID (optional): die mit MG beginnende SID des Messaging Service. Für SMS ist das Feld optional, für RCS jedoch erforderlich.
Klicken Sie auf Anwenden.

Die übrigen SMS-Einstellungen finden Sie unter Konfiguration der SMS-Plattform. Für Zustellstatus von RCS-Nachrichten ist keine Webhook-Einrichtung nötig, da Pushwoosh die Status-Callback-URL mit jeder Nachricht an Twilio übermittelt.

Antworten empfangen

Antworten auf RCS-Nachrichten erreichen Pushwoosh nur über einen Webhook, den Sie beim RCS-Absender festlegen.

Öffnen Sie in der Twilio Console den RCS-Absender und gehen Sie zu Configuration.
Setzen Sie Webhook URL for incoming messages auf die URL für eingehende SMS aus SMS-Anbieter-Webhooks, mit der Methode POST.
Klicken Sie auf Save configuration.

Pushwoosh verarbeitet eine RCS-Antwort genauso wie eine SMS-Antwort. Es löst das Event PW_SMSReceived für die Telefonnummer des Absenders aus, und eine Antwort STOP setzt den Tag für die Marketing-Einwilligung des Abonnenten auf false. Siehe Marketing-Einwilligung für SMS und Viber.

Eine RCS-Nachricht senden

Eine RCS-Nachricht wird überall dort versendet, wo Sie eine SMS-Voreinstellung mit Vorlage senden.

Öffnen oder erstellen Sie eine SMS-Voreinstellung.
Wählen Sie im Block RCS für jede Sprache eine Twilio-Vorlage aus, wie unter Über RCS senden beschrieben.
Senden Sie die Voreinstellung in einer SMS-Kampagne oder einer Customer Journey.

In einer Journey erhält ein SMS-Element mit einer Schnellantwort-Vorlage einen Zweig für jede Schaltfläche und wartet bis zu 24 Stunden auf ein Tippen. Siehe Verzweigung nach RCS-Antwortschaltflächen.

RCS-Statistiken prüfen

Um zu sehen, wie viele Zustellungen über RCS bestätigt wurden, wie viele als SMS ankamen und welcher Anteil der RCS-Empfänger die Nachricht gelesen hat, öffnen Sie die Nachrichtenstatistik des Versands.