CNAM-Integration
CNAM über SIP
Autorisieren Sie Ihre SIP-Quelle, senden Sie eine Abfragetransaktion und lesen Sie die zurückgegebene Anruferidentität aus.
Abfrageverhalten auswählen
| Stufe | Öffentlicher Preis pro Abfrage | Funktion |
|---|---|---|
| Starter | 0,0026 $ | Verwendet proprietäre und zwischengespeicherte Anrufernamen-Informationen. |
| Standard | 0,0037 $ | Führt für jede Abfrage eine Echtzeit-Netzwerkabfrage durch. |
| Mixed | 0,004 $ | Versucht zuerst eine Echtzeit-Abfrage und greift dann auf Daten von Starter zurück, wenn kein Name gefunden wird. |
Der ausgewählte Dienst bestimmt das Abfrageverhalten; Mixed ist keine Abfrage, die zuerst den Cache nutzt. Prüfen Sie vor dem Produktiveinsatz den Tarif, der Ihrem Konto zugewiesen ist. Ein Anrufername ist kein Nachweis für Identität oder Inhaberschaft.
Quelle autorisieren
- Fügen Sie die öffentliche Quell-IP-Adresse, die Ihr SBC oder Ihre Anwendung verwendet, unter CNAM-IP-Einstellungen hinzu und ordnen Sie den vorgesehenen Dienst zu.
- Senden Sie ein SIP-INVITE an
cnam.multitel.netund verwenden Sie die vollständige Telefonnummer als Benutzerteil der Request-URI. Als Transport ist UDP auf Zielport 5060 veröffentlicht. - Lassen Sie Ihren SIP-Stack die Header Via, From, To, Contact, Call-ID, CSeq und weitere erforderliche Transaktions-Header erzeugen. Senden Sie nicht nur die unten gezeigte Request-Zeile.
- Schließen Sie die SIP-Transaktion korrekt ab und verwenden Sie den zurückgegebenen Namen nur, wenn ein nutzbares Ergebnis vorliegt.
INVITE sip:12025550123@cnam.multitel.net SIP/2.0Dieser Abfragedienst akzeptiert keine SIP-Registrierung. Die Autorisierung beruht auf der konfigurierten Quelladresse, die die öffentliche Adresse Ihres NAT-Gateways sein kann.
SIP-Abfrageergebnis lesen
Der Dienst liefert das Ergebnis in einer SIP-Antwort 380 mit einem P-Asserted-Identity-Header. Dies ist die Transaktion des Abfrageergebnisses, kein angenommener Telefonanruf. Die Reason Phrase kann den zurückgegebenen Namen enthalten; werten Sie den Identity-Header aus, statt sich auf eine feste Formulierung zu verlassen.
SIP/2.0 380 EXAMPLE CALLER
P-Asserted-Identity: "EXAMPLE CALLER" <sip:12025550123@192.0.2.10>
Content-Length: 0Dieser Auszug lässt Transaktions-Header aus. 192.0.2.10 steht im Beispiel für das anfragende System. Die tatsächliche Antwort muss anhand von Call-ID und CSeq Ihres SIP-Stacks zugeordnet werden.
- 380 mit nutzbarem Namen
- Lesen Sie den Anzeigenamen aus P-Asserted-Identity, bestätigen Sie die abschließende INVITE-Antwort über Ihren SIP-Stack und setzen Sie Ihren Anruf-Workflow fort.
- Kein nutzbarer Name
- Verwenden Sie keine Fehlermeldung, keinen leeren Wert und nicht die abgefragte Nummer als verifizierten Anrufernamen. Lassen Sie den Anruf mit Ihrem üblichen Verhalten für unbekannte Namen weiterlaufen.
- 403 oder eine andere Ablehnung
- Prüfen Sie die Request-Methode, die Zieldomain, die Autorisierung der Quell-IP sowie den Konto- und Dienststatus. Wiederholen Sie einen Autorisierungsfehler nicht in einer engen Schleife.
- Zeitüberschreitung
- Unterscheiden Sie Wiederholungen innerhalb der SIP-Transaktion von einer neuen Abfrage. Begrenzen Sie neue Versuche, da sie weitere Abfragekosten verursachen können.
Abrechnung, Wiederholungen und der Unterschied zur Aktualisierung der Anruferkennung
Eine neue Abfrage kann Abfragekosten verursachen. Diese Abfrageschnittstellen dokumentieren keinen Idempotenzschlüssel, daher kann eine erneute Anfrage eine zweite kostenpflichtige Abfrage sein. Verwenden Sie bei Transport- oder Dienstfehlern ein begrenztes Backoff, beheben Sie Kontofehler zuerst und gleichen Sie die gemeldeten Abfragekosten ab. Speichern Sie Ergebnisse nur für einen Zeitraum im Cache, der zu Ihrer Anwendung passt; Anrufernamen können sich ändern.
Eine CNAM-Abfrage liest einen Namen aus. Sie ändert nicht den Namen, der bei Ihren ausgehenden Anrufen angezeigt wird. Eine LIDB-Aktualisierung des Anrufernamens ist ein separater Vorgang mit eigenen Feldern, eigener Autorisierung, eigenem Preis und eigener Bearbeitung.