Bevor du beginnst
Twilio ist der Dienst, mit dem deine Anwendung Anrufe tätigen und entgegennehmen sowie SMS-Nachrichten senden kann. Deine App stellt die Oberfläche bereit; Twilio liefert die globale Telekommunikations-Infrastruktur im Hintergrund. Für die Verbindung brauchst du zwei Zugangsdaten aus deinem Twilio-Konto: Account SID und Auth Token. Das sind die „Schlüssel“, die deine Anwendung dazu autorisieren, dein Twilio-Konto zu verwenden. Voraussetzungen:- Ein aktives Twilio-Konto.
- Administratorzugriff auf das CMS deiner Anwendung.
- Empfohlen: Aktiviere Zwei-Faktor-Authentifizierung in Twilio und speichere deine Zugangsdaten in einem sicheren Passwort-Manager.
Schritt 1: Ins CMS gehen und Integrationen öffnen
Öffne das CMS über diesen direkten Link: go to CMS.Wähle im linken Menü Integrations und anschließend Twilio.
Du siehst ein Panel mit zwei Einträgen: account_sid und auth_token. Twilio ist als „Required“ markiert, weil ohne diese Integration die Telefonie-Funktionen nicht funktionieren.
Schritt 2: Zugangsdaten aus Twilio holen
Melde dich in deiner Twilio Console an.Auf dem Projekt-Dashboard findest du unter „Project Info“ deine Account SID und deinen Auth Token. Der Token kann verborgen sein; klicke auf „show“, um ihn anzuzeigen. Kopiere beide Werte. Stelle sicher, dass du die Live-Zugangsdaten verwendest, nicht die Testdaten. Beispiele:
Account SID: YOUR_ACCOUNT_SID
Auth Token: YOUR_AUTH_TOKEN Tipp: Behandle den Auth Token wie ein Passwort. Teile ihn nicht per E-Mail oder Chat.
Schritt 3: Keys im CMS hinzufügen
Im Twilio-Bereich des CMS:Klicke auf Add API Key. Gib die Account-SID-Daten genau wie folgt ein:
- Key Name: account_sid Standardwert, nicht ändern
- Key Value: YOUR_ACCOUNT_SID
- Description: Twilio Account SID
- Active: aktiviert
- Key Name: auth_token Standardwert, nicht ändern
- Key Value: YOUR_AUTH_TOKEN
- Description: Twilio Auth Token
- Active: aktiviert
- Die Key-Namen müssen exakt account_sid und auth_token sein — alles klein, mit Unterstrich.
- Markiere beide Keys immer als Active. Wenn einer inaktiv ist, funktioniert die Integration nicht.
Schritt 4: Prüfen, ob die Integration aktiv ist
Nach dem Speichern siehst du beide Keys in der Liste mit dem Status Active. Schnelle Checks:- Aktualisiere die Integrations-Seite und prüfe, dass Twilio keine Warnungen anzeigt.
- Wenn du bereits einen Agenten konfiguriert hast, starte einen Testanruf im Bereich Agents. Wenn der Anruf verbunden wird, ist Twilio korrekt integriert.
Erweiterte Konfiguration optional
- Token-Rotation: Wenn du vermutest, dass dein Auth Token kompromittiert wurde, generiere in Twilio einen neuen und aktualisiere ihn sofort im CMS.
- Subaccounts: Wenn du mehrere Umgebungen oder Kunden verwaltest, kannst du pro Projekt eine eigene Twilio-Subaccount-SID und ein eigenes Token nutzen, um Abrechnung und Nutzung zu trennen.
- Security-Best-Practices: Bewahre den Auth Token in einem Passwort-Manager auf, beschränke, wer ihn sehen darf, und kontrolliere den Zugriff auf deine Twilio Console.
Häufige Fehler und Lösungen
- Keys sind inaktiv: sowohl account_sid als auch auth_token müssen auf Active stehen.
- Key-Namen geändert: Sie müssen exakt account_sid und auth_token bleiben. Jede Abweichung bricht die Integration.
- Copy/Paste mit Leerzeichen: Stelle sicher, dass keine führenden oder nachgestellten Leerzeichen in den Werten sind.
- Test-Zugangsdaten verwendet: Für Produktion brauchst du Live-Zugangsdaten.
- Speichern vergessen: Nach dem Eintragen immer Save Key klicken.
- Neuer Token nicht aktualisiert: Wenn du den Auth Token in Twilio erneuerst, ihn aber nicht im CMS aktualisierst, werden Anrufe fehlschlagen.