sipgate.io Fax Add-on für Google Drive einrichten

• Was ist sipgate.io?
• In diesem Tutorial
• Step 1: das Projekt aufsetzen
• Step 2: Fax-Add-on in Google Drive konfigurieren
• Step 3: Fax versenden
• PDF-Datei auswählen
• Google Drive Add-on konfigurieren
• Step 4: Code Walkthrough
• Fazit

Was ist sipgate.io?

SMS oder Faxe senden und empfangen, den Anrufverlauf abrufen, Anrufe initiieren und manipulieren – das alles kann sipgate.io! Mit unseren APIs können Sie unsere Telekommunikationsfunktionen flexibel in Ihre Projekte integrieren. Unsere Library und Tutorials unterstützen Sie dabei, Ihre Telefonie möglichst bequem zu gestalten.

In diesem Tutorial

In diesem Tutorial richten wir ein Google Drive Add-on. Dieses Add-on können Sie verwenden, um eine PDF-Datei Ihrer Wahl aus Ihrem Google Drive als Fax zu versenden. In diesem Projekt arbeiten wir mit der Funktionalität der sipgate.io REST-API und Google Apps Script Entwicklungsumgebung. Schauen Sie sich gerne die REST-API-Funktionen in unserer Dokumentation an.

Das vollständige Projekt finden Sie in unserem Github.

Step 1: das Projekt aufsetzen

Damit wir unser Projekt lokal entwickeln können, installieren wir im ersten Schritt das CLI-Tool clasp mit folgendem Befehl:

npm install -g clasp

Im nächsten Schritt authentifizieren wir unseren Google Account mit dem Befehl clasp login und erstellen ein neues Google Apps Projekt mit clasp create –title „sipgate.io Fax Add-on“.

Jetzt können Sie Ihr neues Projekt unter script.google.com sehen und alle Änderungen verfolgen. Außerdem können wir jederzeit den lokal geschriebenen Code in das Remote Repository mit dem Befehl clasp push -w pushen.

Step 2: Fax-Add-on in Google Drive konfigurieren

Um sipgate.io Add-on in Ihrem Google Drive anzuzeigen, stellen Sie das Google Apps Script-Projekt im Online-Editor bereit. Dafür gehen Sie auf Deploy im Menü oben rechts und wählen Test deployments aus. Dadurch können Sie Ihr Google Workspace Add-on mit dem Install Button installieren.

Voilà! Jetzt sollten Sie ein Symbol mit dem sipgate.io-Logo in der rechten Seitenleiste von Google Drive sehen können.

Step 3: Fax versenden

PDF-Datei auswählen

Damit Sie ein Fax versenden können, wählen Sie eine beliebige PDF-Datei in Ihrem Google-Drive aus.

sipgate.io Add-on konfigurieren

Starten Sie das Add-on, indem Sie auf das sipgate.io-Logo in der rechten Seitenleiste klicken. Wenn im vorherigen Schritt bereits eine PDF-Datei ausgewählt wurde, werden Sie aufgefordert, Ihr API-Token einzugeben. Das Token sollte den Scope sessions:fax:write haben, um ein Fax über unsere REST-API versenden zu können. Wenn Sie mehr als ein Faxanschluss besitzen, können Sie diese im nächsten Schritt auswählen. Schließlich müssen Sie noch eine Empfangsnummer für Ihr Fax angeben. Mit einem Klick auf Send fax versenden Sie Ihr Fax.

Step 4: Code Walktrough

Das Fax Add-on wird von Google Apps Script erstellt. Eine allgemeine Anleitung zum Erstellen eines Google Workspace Add-ons finden Sie in der Google Drive Dokumentation. Im folgenden Abschnitt schauen wir die Details der Implementierung unseres Add-ons genauer an.

Wenn ein:e User:in eine PDF-Datei auswählt, wird die Funktion onDriveItemsSelected aufgerufen. Diese Funktion prüft, ob zuvor ein API-Token eingerichtet wurde. In diesem Fall kann ein:e User:in eine Fax-Empfängernummer eingeben. Andernfalls erscheint eine Aufförderung, eine Token-ID und ein Token einzugeben.

function onDriveItemsSelected(event) {
  const isConfigured =
    PropertiesService.getUserProperties().getKeys().includes("tokenID") &&
    PropertiesService.getUserProperties().getKeys().includes("token");

  if (event.drive.activeCursorItem.mimeType == "application/pdf") {
    PropertiesService.getUserProperties().setProperty(
      "filename",
      event.drive.activeCursorItem.title
    );

    return buildCard(
      "OnSelected",
      isConfigured ? createFaxSection(null) : createAuthSection()
    );
  }
  return buildCard("DefaultCard", createDefaultSection());
}

Nachdem das Add-on erfolgreich konfiguriert wurde und ein:e User:in auf den Button Send fax klickt, wird eine Anfrage an unsere REST-API über die sendFax– Funktion gesendet.

function sendFaxAction(e) {
  const faxlineID =
    PropertiesService.getUserProperties().getProperty("faxlineID");
  const phoneNumber = e.formInput.phoneNumber;
  const title = e.drive.activeCursorItem.title;

  if (!PHONENUMBER_E164_REGEX.test(phoneNumber)) {
    return buildCard("DefaultCard", createFaxSection(fax.errorPhoneNumber));
  }

  const pdfFile = DriveApp.getFileById(e.drive.activeCursorItem.id);
  const pdfBase64 = Utilities.base64Encode(pdfFile.getBlob().getBytes());

  try {
    sendFax(faxlineID, phoneNumber, title, pdfBase64);
  } catch (error) {
    return buildCard("DefaultCard", createFaxSection(error.message));
  }

  return CardService.newActionResponseBuilder()
    .setNotification(CardService.newNotification().setText(fax.success))
    .build();
}

Fazit

In diesem Tutorial haben wir ein sipgate.io Fax Add-on für Google Drive eingerichtet. Mithilfe von diesem Add-on können Sie jetzt mühelos eine PDF-Datei Ihrer Wahl aus Ihrem Google Drive als Fax versenden.

Sie können unser Beispiel gerne als Grundlage für Ihre Projekte verwenden und an Ihre Anforderungen anpassen.

Wenn Sie mehr über die Möglichkeiten unserer sipgate.io-Library erfahren möchten, schauen Sie sich gerne die anderen Tutorials in unserem Blog an.