Zum Hauptinhalt springen

Telnyx-Integration

Eine Schritt-für-Schritt-Anleitung, um Ihre Telnyx-Rufnummern per SIP-Trunking zu verbinden
Diese Anleitung zeigt Ihnen, wie Sie Ihre Telnyx-Rufnummern per SIP-Trunking mit Famulor verbinden. Sie erstellen eine FQDN-Verbindung in Telnyx, konfigurieren die Outbound-Authentifizierung, weisen Rufnummern zu und importieren diese in Famulor.
Einmalige Einrichtung: Die SIP-Verbindung müssen Sie nur einmal erstellen (Schritte 1-5). Bei jeder weiteren Rufnummer reicht es, sie Ihrer bestehenden Verbindung zuzuweisen (Schritt 5) und in Famulor zu importieren (Schritt 7).
Warum FQDN? Der Verbindungstyp muss FQDN sein - nicht Credentials oder IP Address. Credential-Verbindungen benötigen SIP REGISTER für eingehende Anrufe, was unsere Plattform nicht sendet. FQDN-Verbindungen leiten Inbound-Anrufe direkt an unseren SIP-Server und authentifizieren Outbound-Anrufe per Zugangsdaten.
Preisüberblick: Telnyx veröffentlicht öffentliche Startpreise für Rufnummern und SIP-Trunking; länderspezifische Details werden über die Live-Preislisten bereitgestellt.
  • Inbound / Rufnummern: lokale Rufnummern ab $1/Monat; eingehende lokale Gespräche ab $0.0035/Min
  • Outbound / Calling: internationale ausgehende Gespräche ab $0.005/Min
  • Deutschland / Schweiz / Vereinigtes Königreich / USA: exakte Live-Länderpreise sind in den Telnyx-Preislisten verfügbar und nicht direkt auf der Übersichtsseite ausformuliert
  • Offizielle Preise: Rufnummernpreise und SIP-Trunking-Preise

Schritt 1: SIP-Verbindung erstellen

  1. Melden Sie sich im Telnyx Mission Control Portal an
  2. Navigieren Sie zu Real-Time Communications -> Voice -> SIP Trunking
  3. Klicken Sie auf Create SIP Connection
  4. Name: Wählen Sie einen Namen (z. B. mein-unternehmen SIP trunk)
  5. Type: Waehlen Sie FQDN
  6. Klicken Sie auf Create - dadurch öffnet sich der Einrichtungsassistent
    SIP-Verbindung in Telnyx erstellen

Schritt 2: Authentifizierung und Routing

Der Assistent führt Sie zum Schritt Authentication and routing. Hier hinterlegen Sie die FQDN für Inbound-Routing und richten Outbound-Zugangsdaten ein.

FQDN hinzufügen

  1. Klicken Sie auf ”+ Add FQDN” und tragen Sie ein:
    • DNS Record Type: A
    • FQDN: {famulorsipadress}.sip.livekit.cloud
    • Port: 5060
  2. Klicken Sie auf Save
    FQDN zur Telnyx-Verbindung hinzufügen

Routing für eingehende Anrufe

Scrollen Sie auf derselben Seite zum Abschnitt Inbound calls routing:
  1. SIP subdomain: Tragen Sie einen Namen ein (z. B. yourcompany) - daraus wird yourcompany.sip.telnyx.com
  2. Receive SIP Subdomain calls: Setzen Sie auf From Anyone
  3. Primary FQDN: Wählen Sie {famulorsipadress}.sip.livekit.cloud aus dem Dropdown
    Inbound-Routing konfigurieren

Outbound-Authentifizierung

Scrollen Sie weiter nach unten zum Abschnitt Outbound calls authentication:
  1. Method: Wählen Sie Credentials
  2. Legen Sie username und password fest - speichern Sie diese, da Sie sie beim Import in Famulor benötigen
    Outbound-Zugangsdaten festlegen
Klicken Sie unten auf Next.

Schritt 3: Konfiguration

Der Assistent zeigt die Seite Configuration mit Verbindungsdetails, Webhooks und erweiterten Einstellungen. Sie müssen hier nichts ändern - prüfen Sie nur, dass bei Type FQDN Connection steht, und klicken Sie auf Next.
Konfigurationsseite

Schritt 4: Inbound und Outbound

Der Assistent geht nacheinander durch die Schritte Inbound und Outbound. Da Sie diese bereits in Schritt 2 vorbereitet haben, prüfen Sie die Einstellungen und klicken jeweils auf Next. Auf der Outbound-Seite stellen Sie sicher:
  1. Outbound voice profile: Wählen Sie Ihr Profil (oder “Default”)
  2. Localization country: Wählen Sie Ihr Land
  3. Channel limit: Setzen Sie 10 oder höher
    Outbound-Einstellungen konfigurieren
Falls Sie noch kein Outbound Voice Profile haben, gehen Sie zu Voice -> Settings -> Outbound Voice Profiles -> Create Profile. Aktivieren Sie unter Allowed Destinations alle Länder, die Sie anrufen möchten.

Schritt 5: Rufnummern zuweisen

Der letzte Schritt im Assistenten ist die Seite Numbers:
  1. Klicken Sie auf Assign numbers
  2. Wählen Sie die Rufnummer(n), die Sie nutzen möchten

Schritt 6: Geografische Berechtigungen aktivieren

  1. Gehen Sie zu Voice -> Settings -> Outbound Voice Profiles
  2. Klicken Sie auf Edit
    Outbound Voice Profiles öffnen
  3. Öffnen Sie Ihr Profil -> Allowed Destinations
  4. Aktivieren Sie die Länder/Regionen, die Sie anrufen möchten
    Geografische Berechtigungen aktivieren
Wenn Sie diesen Schritt überspringen, schlagen Outbound-Anrufe mit einem 403-Fehler fehl: “Dialed number is not included in whitelisted countries.”

Schritt 7: Rufnummer in Famulor importieren

  1. Öffnen Sie Phone Numbers direkt in Ihrem Famulor-Dashboard. Falls Sie zuerst auf der Login-Seite landen, melden Sie sich an - danach werden Sie automatisch zur Rufnummern-Seite weitergeleitet.
  2. Klicken Sie auf “Integrate SIP trunk” (oben rechts auf der Seite)
    Rufnummer per SIP-Trunk in Famulor importieren
  3. Tragen Sie Rufnummer und SIP-Zugangsdaten ein:
    Phone number: Ihre Telnyx-Nummer (z. B. +1 555 0123)
    Username: Der Outbound-Benutzername aus Schritt 2
    Password: Das Outbound-Passwort aus Schritt 2
    
  4. Tragen Sie die Outbound-Einstellungen ein:
    SIP address: sip.telnyx.com
    Outbound format: International (mit vorangestelltem +)
    
    Outbound-Einstellungen in Famulor konfigurieren
Die SIP address muss sip.telnyx.com sein - verwenden Sie NICHT Ihre SIP-Subdomain (z. B. yourcompany.sip.telnyx.com). Die Subdomain ist nur für Inbound-Routing auf Telnyx-Seite gedacht. Als Outbound-SIP-Adresse führt sie zu 404 Not Found-Fehlern.
  1. Wählen Sie Authorization type: IP Address und tragen Sie die Telnyx-IP-Adressen für Ihre Region ein:
    • US: 192.76.120.10
    • Europe: 185.246.41.140 und 185.246.41.141
    • Australia: 103.115.244.145 und 103.115.244.146
    Inbound-IP-Adressen in Famulor konfigurieren
Sie können alle IP-Adressen hinterlegen, unabhängig von der Region - verwendet werden nur die jeweils relevanten.
  1. Wählen Sie das Land, in dem Ihr SIP-Trunk betrieben wird.
    SIP-Trunk-Land in Famulor auswählen

Schritt 8: Einrichtung pruefen

Zum Testen Ihrer Telnyx-Nummer müssen Sie sie KI-Assistenten zuweisen. Inbound und Outbound benötigen separate Assistenten:

Inbound testen

  1. Gehen Sie zu AI Assistants -> erstellen Sie einen neuen Assistenten (oder verwenden Sie einen vorhandenen)
  2. Stellen Sie den Assistententyp auf Receive phone calls
  3. Weisen Sie dem Assistenten Ihre Telnyx-Rufnummer zu
  4. Rufen Sie Ihre Telnyx-Rufnummer von einem beliebigen Telefon aus an - der KI-Assistent sollte antworten

Outbound testen

  1. Erstellen Sie einen zweiten Assistenten mit Typ Make phone calls
  2. Weisen Sie diesem dieselbe Telnyx-Rufnummer zu
  3. Klicken Sie auf Speak to assistant -> Phone call - Famulor ruft Ihr persönliches Telefon mit der Telnyx-Nummer an
Ein einzelner Assistent kann nicht beide Richtungen abdecken. Sie benötigen einen Receive phone calls-Assistenten und einen Make phone calls-Assistenten, beide mit derselben zugewiesenen Rufnummer.

Sicherheitsanforderungen

Ihre SIP-Zugangsdaten sollten sicher sein:
  • Username: Der vom Provider bereitgestellte Benutzername
  • Password muss enthalten:
    • 12 oder mehr Zeichen
    • Zahlen
    • Groß- und Kleinbuchstaben
    • Sonderzeichen empfohlen

Häufige Probleme

Gehen Sie zu Voice -> Settings -> Outbound Voice Profiles -> Ihr Profil -> Allowed Destinations und aktivieren Sie das Zielland, das Sie anrufen moechten.
  • Stellen Sie sicher, dass der Verbindungstyp FQDN ist (nicht Credentials oder IP Address)
  • Prüfen Sie, dass die FQDN {famulorsipadress}.sip.livekit.cloud auf Port 5060 gesetzt ist
  • Prüfen Sie, dass die Rufnummer dieser FQDN-Verbindung zugewiesen ist (und nicht einer anderen)
  • Prüfen Sie, dass die SIP-Adresse sip.telnyx.com ist (nicht Ihre SIP-Subdomain)
  • Prüfen Sie, dass die Zugangsdaten zwischen Telnyx und Famulor übereinstimmen
  • Stellen Sie sicher, dass ein Outbound Voice Profile mit der Verbindung verknüpft ist
  • Prüfen Sie, dass das Localization country korrekt gesetzt ist
Credential-Verbindungen benötigen SIP REGISTER für eingehende Anrufe. Famulor nutzt direktes SIP-Routing (ohne Registrierung), daher ist FQDN erforderlich. FQDN unterstützt weiterhin credential-basierte Authentifizierung für Outbound-Anrufe.

Sie brauchen Hilfe beim Setup? Unser Support-Team ist auf SIP-Onboarding spezialisiert und begleitet Sie durch die komplette Einrichtung für Ihre konkrete Telefonie-Umgebung.
Passende Seiten: SIP-Integration und Twilio-Integration.