Zu Content springen
Deutsch
Kundenportal Anmelden
Kontakt
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

Integration:  Integrationsleitfaden - Virtuelles Fax - Telnyx

Pier4Voice mit Telnyx Fax integrieren

Durch die Integration von Pier4Voice mit Telnyx Fax können Mitarbeiter in Ihrem Unternehmen Faxe sofort und sicher über das Internet senden und empfangen – direkt von ihrem eigenen Linkus Desktop oder Web Client aus.

Einleitung

Pier4Voice unterstützt die Integration mit Telnyx, um internetbasiertes Faxen zu ermöglichen. Dadurch können PBX-Nebenstellenbenutzer Faxe über das zuverlässige Kommunikationsnetzwerk von Telnyx senden und empfangen

Die Integration wird mittels Pier4Voice PBX Webhook und Telnyx Fax API V2 realisiert .
  • Wenn ein Benutzer einer Nebenstelle über Linkus ein Fax sendet, ruft Pier4Voice die Telnyx-API auf, um das Fax zur Zustellung einzureichen.

  • Wenn ein Fax an die Telnyx-Faxnummer eingeht, sendet Telnyx eine Webhook-Benachrichtigung an die Pier4Voice-Telefonanlage. Die Telefonanlage ruft dann die Faxdatei über die API ab und stellt sie den Linkus-Benutzern der jeweiligen Nebenstelle zur Verfügung.

Sie können die Integration ganz einfach einrichten, indem Sie die folgenden Anweisungen befolgen:

  1. Webhook-URL von Pier4Voice PBX abrufen.
  2. Erstellen Sie die notwendigen Ressourcen und beschaffen Sie sich die erforderlichen Zugangsdaten von Telnyx.
    • Ein API-Schlüssel zur Authentifizierung Ihres Kontos und zum Zugriff auf die Telnyx-API-Endpunkte.
    • Ein ausgehendes Sprachprofil zur Initiierung ausgehenden Faxverkehrs.
    • Eine Fax-fähige Telefonnummer zum Senden und Empfangen von Faxen.
    • Eine Faxanwendung zur Verwaltung des ein- und ausgehenden Faxverkehrs.
  3. Geben Sie die erhaltenen Zugangsdaten in Pier4Voice PBX ein und konfigurieren Sie anschließend die Fax-bezogenen Einstellungen.

Anforderungen

Um die Online-Faxfunktion in Pier4Voice PBX zu integrieren, stellen Sie sicher, dass Pier4Voice PBX die folgenden Anforderungen erfüllt

  • Firmware : Version 84.20.0.X oder höher

Schritt 1. Webhook-URL von Pier4Voice PBX abrufen

Zuerst benötigen Sie eine Webhook-URL von Pier4Voice PBX, die für die Einrichtung einer Faxanwendung auf Telnyx erforderlich ist.

  1. Wechseln Sie zur Faxintegrationsseite.

    1. Melden Sie sich im PBX-Webportal an und gehen Sie zu Integrationen > Fax .
    2. Klicken Sie unter dem Reiter „Faxintegration“ auf „Hinzufügen“ .
  2. Ermitteln Sie die Webhook-URL für Telnyx.

     

    1. Wählen Sie in der Dropdown-Liste „Dienstanbieter“ die Option „Telnyx“ aus .
    2. Klicken Sie im Feld „Webhook-URL“ role management_copy-png, um die URL zu kopieren und für die spätere Verwendung zu speichern.

Schritt 2. Ressourcen erstellen und Anmeldeinformationen von Telnyx abrufen

Erstellen Sie die notwendigen Ressourcen und beschaffen Sie sich die erforderlichen Zugangsdaten von Telnyx, um die Interaktionen zwischen Pier4Voice PBX und Telnyx zu authentifizieren und zu autorisieren.

Sie müssen die folgenden Einstellungen im Telnyx-Portal vornehmen.

  • 1. Erstellen Sie einen API-Schlüssel
  • 2. Ausgehendes Sprachprofil erstellen
  • 3. Kaufen Sie eine Telefonnummer
  • 4. Erstellen Sie eine Faxanwendung
1. Erstellen Sie einen API-Schlüssel
  1. Rufen Sie die Seite zur Erstellung des API-Schlüssels auf.
    1. Melden Sie sich im Telnyx-Portal an .
    2. Klicken Sie oben rechts auf Ihr Konto und wählen Sie dann API-Schlüssel aus .

  2. Erstellen Sie einen API-Schlüssel.
    1. Klicken Sie oben rechts auf „API-Schlüssel erstellen“ .

    2. Im Pop-up-Fenster können Sie nach Bedarf Tag und Ablaufdatum für den API-Schlüssel festlegen und anschließend auf „Erstellen“ klicken .

      Ein neuer API-Schlüssel wird generiert und angezeigt.

    3. Kopieren Sie den API-Schlüssel und speichern Sie ihn zur späteren Verwendung. Schließen Sie anschließend das Fenster.

2. Ausgehendes Sprachprofil erstellen
  1. Rufen Sie die Seite zum Erstellen des Profils für ausgehende Sprachverbindungen auf.
    1. Klicken Sie oben links auf „ Zurück “, um zum Startmenü zurückzukehren.

    2. Gehen Sie in der linken Navigationsleiste zu Echtzeitkommunikation > Sprache > Einstellungen > Ausgehende Sprachprofile .
  2. Klicken Sie oben rechts auf „Profil erstellen“ .

  3. Passen Sie das Profil nach Bedarf an.
3. Kaufen Sie eine Telefonnummer
  1. Gehen Sie in der linken Navigationsleiste zu Echtzeitkommunikation > Nummern > Nummern kaufen .

  2. Suchen und kaufen Sie eine Telefonnummer mit Faxfunktion.
    1. Unter dem Reiter „Nummer kaufen“ stellen Sie die Funktionen auf Fax ein und konfigurieren bei Bedarf zusätzliche Filter. Klicken Sie anschließend auf „Nummern suchen“, um die verfügbaren Nummern anzuzeigen.

    2. Wählen Sie die gewünschte Nummer und schließen Sie die Zahlung ab.

      Sie werden auf die Seite „Nummern verwalten“ weitergeleitet , wo die gekaufte Nummer angezeigt wird.

4. Erstellen Sie eine Faxanwendung
  1. Rufen Sie die Seite zum Erstellen von Faxen auf.

    1. Gehen Sie in der linken Navigationsleiste zu Echtzeitkommunikation > Fax .
    2. Klicken Sie oben rechts auf „Fax-App erstellen“ .
  2. Konfigurieren Sie für Details die folgenden Einstellungen und klicken Sie dann auf Erstellen .

     

    Einstellungen Beschreibung
    Anwendungsname Geben Sie einen Namen ein, der Ihnen hilft, die Anwendung zu identifizieren
    Webhook-URL Fügen Sie die von Pier4Voice PBX erhaltene Webhook-URL ein
    Zeitzone

    Geben Sie die Zeitzone an, die in den Fax-Header-Zeitstempeln verwendet wird
  3. Bei eingehenden E-Mails behalten Sie die Standardeinstellungen bei oder konfigurieren diese nach Bedarf. Klicken Sie anschließend auf Weiter .

  4. Wählen Sie für ausgehende Anrufe aus der Dropdown-Liste „ Outbound Voice Profile“ aus , um ausgehenden Faxverkehr zu aktivieren, und klicken Sie dann auf „ Weiter“ .

  5. Klicken Sie bei Numbers , um der Anwendung die Nummer zuzuweisen .

  6. Klicken Sie unten links auf „Fertigstellen“ .

    Es öffnet sich ein Fenster, das anzeigt, dass die Faxanwendung erstellt wurde.

  7. Ermitteln Sie die Anwendungs-ID.
    1. Klicken Sie auf „ Meine Bestellung ansehen“ .

    2. Unter dem Reiter „Details“ können Sie die Anwendungs-ID kopieren und zur späteren Verwendung speichern.

Schritt 3. Geben Sie die Zugangsdaten ein und konfigurieren Sie die Faxeinstellungen auf der Pier4Voice-Telefonanlage.

Geben Sie auf der Pier4Voice PBX die von Telnyx erhaltenen Zugangsdaten ein und konfigurieren Sie anschließend die Fax-bezogenen Einstellungen, um die Faxintegration abzuschließen.

  1. Wechseln Sie zur Faxintegrationsseite.

    1. Melden Sie sich im PBX-Webportal an und gehen Sie zu Integrationen > Fax .
    2. Klicken Sie unter dem Reiter „Faxintegration“ auf „Hinzufügen“ .
  2. Im Abschnitt „Autorisierung“ vervollständigen Sie die Autorisierungseinstellungen.

     

    Einstellungen Beschreibung
    Name Geben Sie einen Namen ein, der Ihnen hilft, die Integration zu identifizieren
    Dienstanbieter Wählen Sie Telnyx .
    API-Schlüssel Fügen Sie den von Telnyx erhaltenen API-Schlüssel ein.
    Anwendungs-ID Fügen Sie die von Telnyx erhaltene Anwendungs-ID ein
  3. Optional: Um eingehende Faxe als E-Mail-Anhänge an bestimmte Adressen weiterzuleiten, führen Sie die folgenden Schritte aus.

    1. Klicken Sie im Abschnitt „Einstellungen “ auf „Hinzufügen“ .
      Hinweis:Sie können bis zu 5 E-Mail-Einträge hinzufügen
    2. Wählen Sie in der Dropdown-Liste „E-Mail-Typ“ den Typ der E-Mail-Adresse aus und nehmen Sie die entsprechenden Einstellungen vor.
      • E-Mail der Nebenstelle : Eingehende Faxe werden als E-Mail-Anhänge an die Postfächer der Nebenstellenbenutzer gesendet.
        Wenn Sie diese Option wählen, wählen Sie die gewünschten Erweiterungen aus der Dropdown-Liste „Erweiterung/E-Mail“ aus.
        Hinweis:Stellen Sie sicher, dass für die ausgewählten Erweiterungen gültige E-Mail-Adressen konfiguriert sind. Andernfalls erhalten die Benutzer keine E-Mails
      • Angegebene E-Mail-Adresse : Eingehende Faxe als E-Mail-Anhänge an eine angegebene E-Mail-Adresse senden.

        Wenn Sie diese Option wählen, geben Sie im Feld „Erweiterung/E-Mail“ eine benutzerdefinierte E-Mail-Adresse ein .

  4. Legen Sie Faxnummern fest und bestimmen Sie, welche Benutzer über welche Nebenstelle Faxe senden und empfangen dürfen.
    1. Klicken Sie im Abschnitt Faxnummer auf Hinzufügen .
    2. Nehmen Sie im Popup-Fenster die folgenden Einstellungen vor und klicken Sie anschließend auf Speichern .
      Einstellungen Beschreibung
      Faxnummer Geben Sie die Faxnummer im E.164-Format ein
      Beispiel : +498037994
      Wichtig:Entfernen Sie die Bindestriche -aus der Faxnummer, da die Faxzustellung sonst fehlschlägt
      Faxempfangsziel Wählen Sie Nebenstellen oder Nebenstellengruppen aus, die eingehende Faxe empfangen können

      Die festgelegten Benutzer können eingehende Faxe über Linkus Desktop oder Web Client anzeigen (Pfad: Faxverwaltung > Fax ).
      Zulässige Nebenstellen zum Senden von Faxen Wählen Sie Nebenstellen oder Nebenstellengruppen aus, die Faxe senden können.

      Die festgelegten Benutzer können Faxe über Linkus Desktop oder Web Client senden (Pfad: Faxverwaltung > Fax ).
    3. Um weitere Faxnummern hinzuzufügen, wiederholen Sie die Schritte a - b .
  5. Klicken Sie auf Speichern .

Ergebnis

Der Status wird angezeigt.   und zeigt an, dass die Integration mit Telnyx Fax erfolgreich eingerichtet wurde.