Zum Hauptinhalt gehen

Branded Call API und Secure Branding

  • Aktualisiert

Mit der Branded Call API können Sie Ihre ausgehenden Anrufe vorautorisieren, bevor sie das Netz erreichen. Secure Branding ist die Funktion, die diese Vorautorisierung nutzt: Sobald sie für eine Telefonnummer aktiviert ist, prüft das System Anrufe von dieser Nummer anhand Ihrer Vorautorisierungsdaten, und bei jedem Anruf, der nicht übereinstimmt, entfernt das System die Markenidentifizierung, bevor der Anruf den Empfänger erreicht. Beide Funktionen werden hier gemeinsam behandelt, da Secure Branding von der bestehenden API-Integration abhängt – wenn Sie nur eine der beiden Funktionen aktivieren, ändert sich das Verhalten bei einem Anruf. Deshalb ist die Reihenfolge der Einrichtung entscheidend.

Direkt zu:

Warum sehe ich die Steuerelemente für Secure Branding und die API nicht?

Wenn die Branded Call API und Secure Branding noch nicht aktiviert sind, sehen Sie die unten genannten Steuerelemente und Analysen nicht. Wenn Sie diese Funktionen aktivieren möchten, wenden Sie sich an Ihren Account-Vertreter.

API-Schlüssel

Um Ihre API-Schlüssel zu generieren und zu verwalten, navigieren Sie zur Seite „API-Schlüssel“ im Bereich „Branded Call“.

Um einen Schlüssel zu generieren, klicken Sie auf die Schaltfläche „API-Schlüssel generieren“. Sie können maximal einen Schlüssel für die Verwendung in einer Produktivumgebung und einen für Testzwecke erstellen. Wählen Sie Ihren Schlüsseltyp aus, geben Sie einen Schlüsselnamen ein und generieren Sie Ihren Schlüssel.

Ein Schlüssel wird automatisch generiert, und die Details werden in der Schlüsseltabelle angezeigt. Branded Call API-Schlüssel enthalten eine API-ID und ein API-„Secret“, das Sie durch Klicken auf das Augensymbol anzeigen lassen können. Um einen Schlüssel zu löschen, klicken Sie auf das Überlaufmenü-Symbol (drei Punkte) rechts.

Außerdem gibt es einen Link, über den Sie die technische Dokumentation der Branded Call API öffnen und einsehen können.

Wer den Vorautorisierungsanruf sendet. Dafür ist das System zuständig, das in Ihrem Anrufpfad die technische Verbindung zu Hiya verwaltet – das kann Ihre eigene Telefon-App oder Telefonanlage sein oder ein Partner, der in Ihrem Auftrag handelt, zum Beispiel eine Contact-Center-Plattform oder ein Kommunikationsanbieter. Die Vorautorisierung muss nicht von demselben System gesendet werden, das den Anruf tätigt, und sie betrifft Ihren Netzbetreiber überhaupt nicht: Die Vorautorisierung gelangt getrennt vom eigentlichen Anruf über das Internet zu Hiya und muss lediglich eintreffen, bevor der Anruf das empfangende Netz erreicht. Wenn Sie über einen Partner mit Hiya verbunden sind, klären Sie mit diesem, welches seiner Systeme für das Senden zuständig ist.

Funktionsweise von Secure Branding

Secure Branding nutzt eine kurze Nachricht – eine Ankündigung –, die kurz vor dem Anruf getrennt vom eigentlichen Anruf an Hiya gesendet wird. Der Ablauf sieht wie folgt aus:

  1. Ankündigen. Ihr System (oder das Ihres Partners in Ihrem Auftrag) teilt Hiya mit, welche Ihrer Nummern im Begriff ist, welche Empfängernummer anzurufen.
  2. Aufzeichnen. Hiya speichert diese Information für kurze Zeit als temporären Eintrag.
  3. Anruf tätigen. Der Anruf erfolgt wie gewohnt über Ihren üblichen Netzbetreiber – die Ankündigung und der Anruf verlaufen vollständig getrennt und müssen nur innerhalb dieses kurzen Zeitfensters am selben Ort, nämlich beim Empfänger, eintreffen.
  4. Prüfen. Wenn der Anruf das empfangende Mobilfunknetz erreicht, fragt dieses Netz bei Hiya an, ob ein übereinstimmender, noch gültiger Eintrag für genau dieses Nummernpaar vorliegt.
  5. Anzeigen. Bei einer Übereinstimmung übermittelt Hiya Ihre genehmigte Markenidentifizierung, und der Anruf wird wie gewohnt angezeigt. Liegt keine Übereinstimmung vor – weil nichts angekündigt wurde, die Nummern nicht übereinstimmen oder der Eintrag bereits abgelaufen ist –, erreicht der Anruf den Empfänger ohne Ihre Markenidentifizierung.

Deshalb hängt Secure Branding davon ab, dass Ihre Ankündigung vor dem Anruf abgeschlossen ist, und deshalb handelt es sich um eine Betrugsschutzmaßnahme und nicht um eine eigenständige Anzeigefunktion: Ein Anruf, der nie angekündigt wurde, kann schlicht nicht zugeordnet werden – das ist der Zweck der Funktion.

Warum die Funktion nicht in jedem Netz identisch funktioniert. Selbst wenn die Ankündigung korrekt funktioniert, entscheiden zwei netzbetreiberseitige Faktoren darüber, ob die Markenidentifizierung den Empfänger tatsächlich erreicht:

  • VoLTE. Informationen zur Markenidentifizierung werden nicht über eine 2G-Verbindung übertragen. Bei manchen Betreibern muss VoLTE (Voice over LTE) zusätzlich vom Netzbetreiber für den konkreten Mobilfunkvertrag des Empfängers freigeschaltet sein – ein VoLTE-fähiges Telefon zu besitzen, ist damit nicht automatisch gleichbedeutend. Wenn das empfangende Gerät oder die Verbindung auf 2G zurückfällt oder VoLTE für diese Leitung nicht bereitgestellt ist, zeigt der Anruf in der Regel nur die blanke Nummer ohne Markenidentifizierung an, selbst wenn auf Ihrer Seite alles korrekt funktioniert hat.
  • Übereinstimmung der Anrufer-ID-Felder (PAI und FROM). Jeder Anruf enthält zwei technische Anrufer-ID-Felder, die eigentlich übereinstimmen sollten. Bei manchen Netzbetreibern kann ein Trunk- oder Routing-Anbieter weiter entlang des Anrufpfads dazu führen, dass diese beiden Felder voneinander abweichen – das geschieht netzseitig und ist nichts, was Sie konfigurieren. In diesem Fall kann die Markenidentifizierung bei diesem bestimmten Netzbetreiber stillschweigend fehlschlagen, obwohl Ihre Ankündigung und Einrichtung korrekt sind. Dies tritt nicht bei jedem Netz auf, daher lohnt es sich, diese Ursache zu prüfen, statt sie einfach vorauszusetzen.

Wann Secure Branding erforderlich sein kann

Manche Netzbetreiber verlangen Secure Branding, bevor die Markenidentifizierung für Anrufer aus dem Finanzdienstleistungs- und Behördenbereich überhaupt angezeigt wird. Anforderungen und Verfügbarkeit können je nach Netzbetreiber und Markt variieren. Wenden Sie sich an Ihren Account-Vertreter, um zu klären, was für Ihre Anrufe gilt.

Wenn Secure Branding für Ihre Anrufe erforderlich und verfügbar ist, umfasst die Einrichtung in der Regel folgende Schritte:

  1. Hiya aktiviert Secure Branding für Ihr Konto und stellt Ihre API-Zugangsdaten bereit.
  2. Ihr technisches Team integriert die Secure Branding API in Ihre Telefon-App oder Ihr Anrufsystem.
  3. Sobald Sie bestätigen, dass die Integration korrekt funktioniert, kann Hiya die Verteilung in einem unterstützten Netz aktivieren.

Wenn Secure Branding aktiviert wird, bevor Ihre Integration funktioniert, kann Ihre Markenidentifizierung in mehreren Netzen verloren gehen. Lesen Sie den nächsten Abschnitt, bevor Sie die Funktion aktivieren.

Bevor Sie Secure Branding aktivieren

Secure Branding und die Vorautorisierung der Branded Call API sind so konzipiert, dass sie gemeinsam aktiviert werden. Sobald Sie Secure Branding für eine Nummer aktivieren, muss jeder Anruf von dieser Nummer angekündigt werden – nicht nur die Anrufe, über die Sie sich speziell Sorgen machen.

Wenn Sie Secure Branding für eine Nummer aktivieren, bevor Ihre Vorautorisierungsintegration korrekt Ankündigungen sendet, verlieren Anrufe von dieser Nummer sofort ihre Markenidentifizierung – unbemerkt und in jedem Netz, nicht nur in dem, das Sie eigentlich schützen wollten. Dies kann genauso aussehen wie ein Angriff oder ein Plattformfehler, obwohl die eigentliche Ursache darin liegt, dass die Integration noch nicht live ist.

Wenn Ihnen das passiert: Deaktivieren Sie Secure Branding für die betroffene(n) Nummer(n). Dadurch wird die Standard-Markenidentifizierung sofort wiederhergestellt. Sobald Ihre Ankündigungsintegration getestet und als funktionierend bestätigt ist – zum Beispiel durch das Senden einer Testankündigung und einen echten Anruf, um die Anzeige zu überprüfen –, können Sie Secure Branding wieder aktivieren. Dabei geht nichts verloren, und es ist der schnellste Weg zurück zur normalen Markenidentifizierung, während Sie die Tests abschließen.

Steuerelemente für Secure Branding

Wenn Secure Branding für Ihr Konto aktiviert ist, können Sie Telefonnummern für Secure Branding im Tab „Secure Branding“ auf der Liste der Branded Call-Telefonnummern verwalten. Zusätzlich können Sie Secure Branding-bezogene Einstellungen für einzelne Telefonnummern auf deren Detailseite verwalten, indem Sie auf die Schaltfläche „ANZEIGE UND EINSTELLUNGEN BEARBEITEN“ klicken.

Einstellungen für alle Ihre Nummern ändern

  • Wenn Sie die Schaltfläche „Für alle Nummern aktivieren“ verwenden, aktiviert das System Secure Branding für jede Branded Call-Telefonnummer in Ihrem Konto.
  • Wenn Sie die Schaltfläche „Für alle Nummern deaktivieren“ verwenden, deaktiviert das System Secure Branding für jede Branded Call-Telefonnummer in Ihrem Konto.

Einstellungen für einzelne Telefonnummern ändern

Um die Secure Branding-Vorautorisierung für einzelne Branded Call-Telefonnummern zu verwalten, gehen Sie zum Abschnitt „Secure Branding für einzelne Telefonnummern aktualisieren“, suchen und wählen Sie eine oder mehrere Telefonnummern aus, die Sie bearbeiten möchten, und klicken Sie auf „Auswahl aktivieren“ oder „Auswahl deaktivieren“.

Analysen zum Spoofing-Schutz

Sie können Analysen zum Spoofing-Schutz für Anrufe einsehen, die von Ihren Branded Call-Telefonnummern initiiert wurden. Wenn Secure Branding für Ihr Konto verfügbar ist, sehen Sie den Tab „Secure Branding“, wenn Sie in der linken Navigation im Bereich „Branded Call“ auf Anruf-Performance klicken.

Der erste Abschnitt zeigt die Secure Branding-Nutzung, also die Anzahl der Telefonnummern, für die Secure Branding aktiviert ist.

Der zweite Abschnitt betrifft gespoofte oder nicht autorisierte Anrufe und zeigt den Prozentsatz der ausgehenden Anrufe, die nicht autorisiert wurden. Sie können den Zeitraum für die Anzeige der Analysen anpassen, indem Sie auf die Datumsauswahl unter dem Abschnittstitel klicken. Sie können die Performance wochenweise, monatsweise oder tagesweise anzeigen.

Der letzte Abschnitt zeigt eine Liste der Telefonnummern, für die gespoofte Anrufe gemeldet wurden, sowie deren Spoofing-Raten über einen bestimmten Zeitraum. Sie können aus drei Optionen einen Zeitraum auswählen: die letzten sieben Tage, die letzten dreißig Tage oder die letzten drei Monate.