Deutsch (du)

Twilio

Twilio verbinden, um SMS-Bestätigungen, Erinnerungen und Hinweise zu senden, die durch echte Ereignisse in den mit condoo.Vibe erstellten Apps ausgelöst werden.

Mit Twilio können Anwendungen, die du mit condoo.Vibe erstellst, über Kanäle wie SMS mit Nutzern kommunizieren.

Du kannst mit Twilio Kommunikationsabläufe für Folgendes erstellen:

Sobald Twilio verbunden ist, beschreib, wer eine Nachricht erhalten soll, wann sie gesendet werden soll und was sie enthalten soll.

Twilio verbinden. Das Ereignis festlegen. condoo.Vibe erstellt den Kommunikationsablauf.

Was du mit Twilio entwickeln kannst

Twilio kann vielen Arten von Anwendungen Echtzeitkommunikation hinzufügen.

Terminerinnerungen

Kunden 24 Stunden vor ihrem Termin eine SMS-Erinnerung senden.

Buchungsbestätigungen

Dem Kunden nach erfolgreicher Erstellung seiner Buchung eine Bestätigungs-SMS senden.

Bestellstatusmeldungen

Kunden per SMS benachrichtigen, wenn ihre Bestellung versendet wurde.

Lead-Benachrichtigungen

Der zuständigen Vertriebskraft eine SMS senden, wenn ein besonders wertvoller Lead ins CRM aufgenommen wird.

Kontohinweise

Nutzer benachrichtigen, wenn eine wichtige Aktion in ihrem Konto stattfindet.

Twilio wird zum Kommunikationsdienst hinter dem Ablauf, den du definierst.

Vor dem Start

Du benötigst ein Twilio-Konto und die vom Twilio-Connector in condoo.Vibe benötigten Zugangsdaten.

Je nach gewünschter Funktion benötigst du möglicherweise auch eine Twilio-Telefonnummer oder weitere Twilio-Konfigurationen.

Twilio mit condoo.Vibe verbinden

Öffne dein condoo.Vibe-Projekt und wechsle zu Connectors.

Suche Twilio und wähle es aus.

Twilio in condoo.Vibe

Gib die von condoo.Vibe angeforderten Zugangsdaten ein und speichere die Verbindung.

Twilio-Konfiguration in condoo.Vibe

Nach dem Verbinden kannst du condoo.Vibe bitten, Twilio-gestützte Funktionen in deine Anwendung einzubauen.

Den ersten SMS-Ablauf erstellen

Angenommen, du entwickelst eine Buchungsanwendung.

Du könntest condoo.Vibe mitteilen:

Nachdem eine Buchung erfolgreich bestätigt wurde, dem Kunden eine SMS mit Dienstleistung, Termindatum, Uhrzeit und Buchungsreferenz senden.

Vereinfacht dargestellt:

Buchung bestätigt
       ↓
In Neon speichern
       ↓
Serverseitige Logik
       ↓
Twilio
       ↓
Kunde erhält SMS

Die Nachricht wird durch ein Ereignis innerhalb deiner Anwendung ausgelöst.

Den Auslöser festlegen

Beschreib klar, wann die Nachricht gesendet werden soll.

Statt:

Kunden eine SMS senden.

Besser:

Dem Kunden unmittelbar nach der erfolgreichen Bestätigung seines Termins eine SMS senden.

Oder:

Dem zuständigen Vertriebsmitarbeiter eine SMS senden, wenn ein neuer Lead mit einem geschätzten Wert über $10,000 erstellt wird.

Das Ereignis setzt den Ablauf in Gang.

Den Empfänger festlegen

Teile condoo.Vibe mit, woher die Telefonnummer des Empfängers stammt.

Zum Beispiel:

Die SMS an die Telefonnummer senden, die der Kunde während der Buchung angegeben hat.

Oder:

Die Benachrichtigung an die gespeicherte Telefonnummer des zuständigen Mitarbeiters senden.

Bei Anwendungen, die Telefonnummern erfassen, solltest du sicherstellen, dass das entsprechende Feld vorhanden ist und geprüft wird.

Die Nachricht festlegen

SMS funktionieren am besten mit kurzen Nachrichten.

Zum Beispiel:

Deine Beratung bei Acme wurde für den
15. Sept. um 2:00 PM bestätigt. Ref: BK-10482.

Du kannst dynamische Anwendungsdaten in der Nachricht verwenden.

Zum Beispiel:

Die SMS mit dem Vornamen des Kunden personalisieren und Termindatum, Uhrzeit sowie Buchungsreferenz einfügen.

Telefonnummern

Das Format von Telefonnummern ist beim internationalen Nachrichtenversand wichtig.

Eine Telefonnummer sollte normalerweise so gespeichert werden, dass ihr Land eindeutig erkennbar ist.

Zum Beispiel:

+14155550123

anstatt sich ausschließlich auf Folgendes zu verlassen:

4155550123

Wenn deine Anwendung Nutzer in mehreren Ländern bedient, solltest du zusätzlich zur Telefonnummer das Land erfassen oder ein Telefonnummernfeld verwenden, das internationale Vorwahlen unterstützt.

Telefonnummern prüfen

Warte nicht bis zum Zustellversuch durch Twilio, um festzustellen, dass erforderliche Telefonnummernangaben fehlen.

Zum Beispiel:

Die Telefonnummer für SMS-Terminerinnerungen als Pflichtfeld festlegen und vor dem Speichern der Buchung prüfen.

Du solltest auch festlegen, was passiert, wenn ein Kunde keine gültige Nummer angibt.

Beispiel: Terminerinnerungen

Automatische Erinnerungen gehören zu den nützlichsten Twilio-Abläufen.

Angenommen, deine Anwendung speichert:

Kundin
Sarah Chen

Dienstleistung
Strategieberatung

Termin
15. September, 2:00 PM

Telefon
+1...

Du könntest condoo.Vibe bitten:

Kunden 24 Stunden vor ihrem bestätigten Termin eine SMS-Erinnerung senden. Dienstleistung, Termindatum und Uhrzeit angeben.

Vereinfacht dargestellt:

Bestätigter Termin
        ↓
Bis zum Erinnerungszeitpunkt warten
        ↓
Noch bestätigt?
        ↓
Twilio
        ↓
SMS-Erinnerung

Beachte die zusätzliche Bedingung:

Noch bestätigt?

Du möchtest niemanden an einen bereits abgesagten Termin erinnern.

Beispiel: Buchungsbestätigung

Du kannst E-Mail und SMS kombinieren.

Zum Beispiel:

Nach erfolgreicher Bestätigung einer Buchung dem Kunden eine ausführliche Bestätigungs-E-Mail über Resend und eine kurze Bestätigungs-SMS über Twilio senden.

Der Ablauf wird zu:

Buchung bestätigt
       ↓
Buchung speichern
       ↓
   ┌───┴────┐
   ↓        ↓
Resend     Twilio
   ↓        ↓
E-Mail     SMS

Mehrere Connectors können am selben Produktablauf beteiligt sein.

Beispiel: Hinweis auf einen besonders wertvollen Lead

Twilio kann auch für interne Benachrichtigungen nützlich sein.

Angenommen, dein Vertriebsteam möchte sofort über besonders wertvolle Chancen informiert werden.

Wenn ein neuer Lead mit einem geschätzten Budget von mindestens $10,000 erstellt wird, den Lead als High Priority markieren und der zuständigen Vertriebskraft eine SMS mit Name, Unternehmen und geschätztem Budget des Leads senden.

Vereinfacht dargestellt:

Neuer Lead
   ↓
Budget prüfen
   ↓
$10,000+?
 ↙      ↘
Ja      Nein
 ↓        ↓
Hohe    Normale
Priorität
 ↓
Twilio
 ↓
Vertriebshinweis

Das verbindet Datenbanklogik mit externer Kommunikation.

Beispiel: Bestellstatusmeldungen

Für eine E-Commerce-Anwendung:

Wenn der Bestellstatus zu Shipped wechselt, dem Kunden eine SMS mit Bestellnummer und Sendungsverfolgungsdaten senden.

Der Auslöser ist kein Klick des Kunden auf eine Schaltfläche.

Es ist eine Änderung der Anwendungsdaten.

So kann die Kommunikation dem Lebenszyklus eines Datensatzes folgen.

Bevor du automatisierte oder werbliche Nachrichten sendest, stell sicher, dass deine Anwendung alle Einwilligungen einholt, die für deinen Anwendungsfall und die Länder, in denen du tätig bist, erforderlich sind.

Dein Formular kann beispielsweise eine passende Einwilligungsoption für SMS-Benachrichtigungen enthalten.

Bei hohem Nachrichtenvolumen oder Werbenachrichten prüfe vor dem Start die Anforderungen von Twilio und die geltenden Vorschriften.

Transaktionsnachrichten und Marketingnachrichten

Es gibt einen wichtigen Unterschied zwischen:

Dein Termin ist für morgen um 2 PM bestätigt.

und:

Erhalte 30% Rabatt, wenn du heute einen weiteren Termin buchst!

Die erste Nachricht bezieht sich auf einen bestehenden Kundenvorgang.

Die zweite ist Werbung.

Je nach deinem Standort, dem Standort des Empfängers und der Nachrichtenart können unterschiedliche Anforderungen gelten.

Gestalte deinen Nachrichtenablauf entsprechend.

Nachrichten nicht aus dem Frontend senden

Twilio-Authentifizierungsdaten sollten nicht im Browsercode offengelegt werden.

Die sicherere grundsätzliche Architektur ist:

NUTZERAKTION
    ↓
DEINE ANWENDUNG
    ↓
SERVERSEITIGE LOGIK
    ↓
TWILIO
    ↓
SMS

So enthält der Browser des Nutzers keine sensiblen Twilio-Zugangsdaten direkt.

condoo.Vibe kann den passenden serverseitigen Ablauf rund um deinen Connector erstellen.

Zustellfehler behandeln

Eine SMS kann fehlschlagen, obwohl die eigentliche Anwendungsaktion erfolgreich ist.

Zum Beispiel:

Buchung erstellt ✓
SMS fehlgeschlagen ✕

Das bedeutet nicht zwangsläufig, dass die Buchung selbst storniert werden sollte.

Du kannst das Verhalten festlegen:

Wenn die Buchung erfolgreich erstellt wird, aber die Bestätigungs-SMS fehlschlägt, die Buchung bestätigt lassen. Den Nachrichtenfehler erfassen, ohne den Termin zu stornieren.

Das trennt die zentrale Anwendungsaktion von der Benachrichtigung.

Doppelte Nachrichten vermeiden

Stell sicher, dass dasselbe Anwendungsereignis nicht unnötig mehrere Nachrichten auslöst.

Zum Beispiel:

Eine Bestätigungs-SMS senden, wenn die Buchung erstmals bestätigt wird. Keine weitere Bestätigung senden, nur weil der Kunde die Buchungsseite aufruft oder neu lädt.

Deine Nachricht sollte an das richtige Ereignis geknüpft sein.

Häufige Probleme

SMS wird nicht gesendet

Prüfe zuerst, ob der übrige Ablauf funktioniert.

Zum Beispiel:

Die Buchung wird erfolgreich erstellt, aber der Kunde erhält keine SMS.

Anschließend verwendest du den Debug-Modus, um den Twilio-Teil zu untersuchen.

Ungültige Telefonnummer

Prüfe, ob die Telefonnummer vorhanden und für das Ziel passend formatiert ist.

Bei internationalen Anwendungen achte besonders auf Ländervorwahlen.

Twilio lehnt die Anfrage ab

Die von Twilio zurückgegebene Fehlermeldung kann hilfreiche Informationen enthalten.

Kopiere die Fehlermeldung in den Debug-Modus, ohne sensible Zugangsdaten einzufügen.

Manche Länder erhalten Nachrichten, andere nicht

Nachrichtenverfügbarkeit und Anforderungen können je nach Ziel unterschiedlich sein.

Prüfe, ob dein Twilio-Konto, Absender, deine Nummer und Nachrichtenkonfiguration das betroffene Ziel unterstützen.

Kunden erhalten doppelte Nachrichten

Teile condoo.Vibe mit:

Kunden erhalten manchmal zwei Bestätigungs-SMS für eine Buchung. Den Auslöser untersuchen und sicherstellen, dass eine bestätigte Buchung nur eine Bestätigungs-SMS erzeugt.

Twilio-Fehler untersuchen

Eine hilfreiche Anfrage zur Fehlersuche sieht so aus:

Erwartet: Nach Bestätigung einer Buchung soll der Kunde eine SMS erhalten.

Tatsächlich: Die Buchung wird korrekt erstellt, aber keine SMS wird empfangen.

Die Telefonnummer des Kunden ist in der Buchung gespeichert.

Fehler: [FEHLER EINFÜGEN, FALLS VORHANDEN]

Den Twilio-Teil des Ablaufs untersuchen, ohne die bestehende Buchungsfunktion zu ändern.

So erhält condoo.Vibe einen konkreten Bereich für die Untersuchung.

Den Ablauf testen

Prüfe vor der Veröffentlichung mehr als nur, ob eine einzelne SMS ankommt.

Prüfe:

Bei international betriebenen Anwendungen teste die Ziele, die du tatsächlich unterstützen möchtest.

Ein guter Twilio-Prompt

Eine gute Kommunikationsanfrage definiert:

Zum Beispiel:

Kunden 24 Stunden vor bestätigten Terminen eine SMS-Erinnerung senden. Die Nachricht an die zur Buchung gehörende Telefonnummer senden und Vorname des Kunden, Dienstleistung, Datum und Uhrzeit einfügen. Keine Erinnerungen für stornierte Termine senden. Bei einem SMS-Zustellfehler die Buchung weder ändern noch stornieren.

Das ist deutlich aussagekräftiger als:

SMS-Erinnerungen hinzufügen.

In Kommunikationsereignissen denken

Ein hilfreiches Muster ist:

Wenn X passiert → Y senden → an Z.

Zum Beispiel:

Du definierst das Kommunikationsereignis.

condoo.Vibe erstellt den Ablauf rund um Twilio.

Als Nächstes: Cloudinary

Nachrichten sind nicht die einzigen externen Ressourcen, die deine Anwendung benötigt.

Anwendungen müssen häufig mit Folgendem umgehen:

Als Nächstes sehen wir uns Cloudinary an und zeigen, wie du es mit condoo.Vibe zum Hochladen und Ausliefern von Medien verwenden kannst.

Cloudinary

Cloudinary verbinden, um hochgeladene Medien zu speichern, umzuwandeln und auszuliefern.