Überblick

Mit SurveyAnalytica können Sie Ihre eigene Telefonnummer von Telnyx oder Twilio verbinden, um im Rahmen Ihrer Kampagnen und Workflows SMS zu senden und zu empfangen. Nach der Verbindung erscheinen Antworten von Kontakten direkt in Ihrer Konversationsansicht.

Bevor Sie beginnen

• Eine Telefonnummer, die bei Telnyx oder Twilio erworben wurde.
• API-Zugangsdaten für diese Nummer (siehe Schritt 2 unten).
• Einen Arbeitsbereich innerhalb von SurveyAnalytica, dem die Nummer zugewiesen wird.

Schritt 1: Eine Telefonnummer erwerben

Falls Sie noch keine Nummer besitzen, erwerben Sie eine bei Ihrem gewählten Anbieter:

• Telnyx — Nummern im Telnyx-Portal suchen und kaufen
• Twilio — Nummern in der Twilio-Konsole suchen und kaufen

Notieren Sie sich die vollständige Nummer im internationalen Format, zum Beispiel +14155551234.

Schritt 2: Ihre API-Zugangsdaten abrufen

Telnyx

1. Melden Sie sich im Telnyx-Portal an.
2. Gehen Sie zu Auth > API Keys.
3. Klicken Sie auf Create API Key (oder kopieren Sie einen vorhandenen Schlüssel, der mit KEY... beginnt).
4. Kopieren Sie den vollständigen Schlüssel — Sie fügen ihn in das Feld API Key in SurveyAnalytica ein.

Twilio

1. Melden Sie sich in der Twilio-Konsole an.
2. Suchen Sie im Haupt-Dashboard Ihre Account SID und Ihr Auth Token.
3. Kombinieren Sie diese im Format AccountSID:AuthToken (durch einen Doppelpunkt getrennt, ohne Leerzeichen).
4. Fügen Sie diesen kombinierten Wert in das Feld API Key in SurveyAnalytica ein.

Schritt 3: Die Nummer in SurveyAnalytica verbinden

1. Gehen Sie zu Account > Domains & Numbers und öffnen Sie den Tab SMS.
2. Füllen Sie das Verbindungsformular aus:

Feld	Was einzugeben ist
Provider	Wählen Sie Telnyx oder Twilio passend zu Ihrer Nummer.
Phone Number (E.164)	Ihre Nummer im internationalen Format, z. B. +14155551234. Muss mit + gefolgt von der Landesvorwahl beginnen.
API Key	Ihr Telnyx-API-Schlüssel (KEY...) oder Ihr Twilio-AccountSID:AuthToken.
Display Name (optional)	Eine benutzerfreundliche Bezeichnung, z. B. Support Line. Wird bei leerem Feld standardmäßig auf die Telefonnummer gesetzt.

3. Klicken Sie auf Connect. Wenn die Zugangsdaten falsch sind, erscheint eine Fehlermeldung — überprüfen Sie den API-Schlüssel und versuchen Sie es erneut.

Schritt 4: Die Nummer einem Arbeitsbereich zuweisen

Jede verbundene Nummer kann einem Arbeitsbereich zugewiesen werden. Sobald die Nummer in der Liste erscheint:

1. Verwenden Sie das Dropdown-Menü Assign to workspace auf der Nummernkarte.
2. Klicken Sie auf Save.

Die Nummer steht nun beim Erstellen von SMS-Kampagnen oder Konversationen in diesem Arbeitsbereich zur Verfügung.

Webhook-Status

Jede Nummernkarte zeigt ein Abzeichen Webhook Active oder Webhook Not Configured, das automatisch aktualisiert wird.

• Webhook Active — eingehende Antworten und Zustellstatus werden korrekt empfangen.
• Webhook Not Configured — SurveyAnalytica konnte den Handler für eingehende Nachrichten nicht beim Anbieter registrieren. Prüfen Sie, ob der API-Schlüssel noch gültig ist, und entfernen und fügen Sie die Nummer dann erneut hinzu.

Eine Nummer entfernen

Klicken Sie auf Delete auf der Nummernkarte, um sie zu trennen. Die Nummer verbleibt in Ihrem Telnyx- oder Twilio-Konto, empfängt jedoch keine eingehenden Nachrichten mehr in SurveyAnalytica.

Fehlerbehebung

Symptom	Was zu prüfen ist
“Failed to connect number”-Fehler	Überprüfen Sie, ob der API-Schlüssel korrekt ist und nicht abgelaufen ist. Bestätigen Sie bei Twilio, dass das Format AccountSID:AuthToken ohne zusätzliche Leerzeichen lautet.
Telefonnummer abgelehnt	Stellen Sie sicher, dass die Nummer im E.164-Format vorliegt: beginnt mit +, gefolgt von der Landesvorwahl und dann der Nummer — ohne Leerzeichen oder Bindestriche.
Webhook Not Configured nach der Verbindung	Warten Sie einen Moment, bis sich das Abzeichen aktualisiert. Bleibt es orange, entfernen Sie die Nummer und verbinden Sie sie mit einem neuen API-Schlüssel erneut.
Eingehende Nachrichten erscheinen nicht	Bestätigen Sie, dass die Nummer dem richtigen Arbeitsbereich zugewiesen ist und dass das Webhook-Abzeichen Active anzeigt.