Integracja CNAM

CNAM przez SIP

Autoryzuj swoje źródło SIP, wyślij transakcję wyszukiwania i odczytaj zwróconą tożsamość dzwoniącego.

Wybierz sposób działania wyszukiwania

Poziom	Cena publiczna za zapytanie	Jak działa
Starter	0,0026 USD	Wykorzystuje własnościowe i buforowane informacje o nazwach dzwoniących.
Standard	0,0037 USD	Wykonuje wyszukiwanie w sieci w czasie rzeczywistym dla każdego zapytania.
Mixed	0,004 USD	Najpierw próbuje wyszukiwania w czasie rzeczywistym, a gdy nie znajdzie nazwy, korzysta z danych Starter.

Zachowanie wyszukiwania zależy od wybranej usługi; Mixed nie jest wyszukiwaniem z pierwszeństwem pamięci podręcznej. Przed użyciem produkcyjnym sprawdź stawkę przypisaną do Twojego konta. Nazwa dzwoniącego nie jest dowodem tożsamości ani własności.

Autoryzuj swoje źródło

Dodaj publiczny źródłowy adres IP używany przez Twój SBC lub aplikację w ustawieniach IP CNAM i powiąż go z docelową usługą.
Wyślij SIP INVITE na adres cnam.multitel.net, używając pełnego numeru telefonu jako użytkownika w request-URI. Opublikowany transport to UDP na porcie docelowym 5060.
Użyj swojego stosu SIP do wygenerowania nagłówków Via, From, To, Contact, Call-ID, CSeq oraz innych wymaganych nagłówków transakcji. Nie wysyłaj wyłącznie poniższego wiersza żądania.
Poprawnie zakończ transakcję SIP i użyj zwróconej nazwy tylko wtedy, gdy jest obecny użyteczny wynik.

INVITE sip:12025550123@cnam.multitel.net SIP/2.0

Ta usługa wyszukiwania nie obsługuje rejestracji SIP. Autoryzacja opiera się na skonfigurowanym adresie źródłowym, którym może być publiczny adres Twojej bramy NAT.

Odczytaj wynik wyszukiwania SIP

Usługa zwraca wynik w odpowiedzi SIP 380 z nagłówkiem P-Asserted-Identity. Jest to transakcja z wynikiem wyszukiwania, a nie odebrane połączenie telefoniczne. Fraza opisowa (reason phrase) może zawierać zwróconą nazwę; analizuj nagłówek identity zamiast polegać na jednej stałej frazie.

SIP/2.0 380 EXAMPLE CALLER
P-Asserted-Identity: "EXAMPLE CALLER" <sip:12025550123@192.0.2.10>
Content-Length: 0

Ten fragment pomija nagłówki transakcji. 192.0.2.10 oznacza w przykładzie system wysyłający żądanie. Rzeczywistą odpowiedź należy dopasować do Call-ID i CSeq Twojego stosu SIP.

380 z użyteczną nazwą: Odczytaj nazwę wyświetlaną z P-Asserted-Identity, potwierdź końcową odpowiedź na INVITE za pośrednictwem swojego stosu SIP i kontynuuj swój przepływ połączenia.
Brak użytecznej nazwy: Nie podstawiaj komunikatu o błędzie, pustej wartości ani wyszukiwanego numeru jako zweryfikowanej nazwy dzwoniącego. Zachowaj działanie połączenia zgodnie ze zwykłym sposobem obsługi nieznanej nazwy.
403 lub inne odrzucenie: Sprawdź metodę żądania, domenę docelową, autoryzację źródłowego adresu IP oraz status konta i usługi. Nie ponawiaj błędu autoryzacji w ciasnej pętli.
Przekroczenie czasu: Odróżniaj retransmisje transakcji SIP od nowego wyszukiwania. Ogranicz liczbę nowych prób, ponieważ każda z nich może wygenerować kolejną opłatę za zapytanie.

Rozliczenia, ponawianie prób i różnica względem aktualizacji identyfikatora dzwoniącego

Nowe wyszukiwanie może wiązać się z opłatą za zapytanie. Te interfejsy wyszukiwania nie dokumentują klucza idempotentności, więc ponowna próba może być drugim płatnym zapytaniem. Stosuj ograniczony backoff w przypadku awarii transportu lub usługi, najpierw rozwiąż błędy konta i uzgodnij zgłaszane opłaty za zapytania. Przechowuj dane w pamięci podręcznej tylko przez okres odpowiedni dla Twojej aplikacji; dane nazw dzwoniących mogą się zmieniać.

Wyszukiwanie CNAM odczytuje nazwę. Nie zmienia nazwy prezentowanej w Twoich połączeniach wychodzących. Aktualizacja nazwy dzwoniącego w LIDB to odrębna operacja z własnymi polami, autoryzacją, ceną i przetwarzaniem.

Przewodnik integracji CNAM na koncie Uzyskaj pomoc w integracji