Integrace CNAM
CNAM přes SIP
Autorizujte svůj SIP zdroj, odešlete transakci vyhledávání a přečtěte vrácenou identitu volajícího.
Zvolte chování vyhledávání
| Úroveň | Veřejná cena za dotaz | Co dělá |
|---|---|---|
| Starter | 0,0026 US$ | Používá vlastní informace o jménech volajících a informace z mezipaměti. |
| Standard | 0,0037 US$ | Při každém dotazu provádí vyhledávání v síti v reálném čase. |
| Mixed | 0,004 US$ | Nejprve zkusí vyhledávání v reálném čase a pokud nenajde žádné jméno, vrátí se k datům úrovně Starter. |
Chování vyhledávání určuje zvolená služba; Mixed není vyhledávání, které nejprve používá mezipaměť. Před produkčním použitím zkontrolujte sazbu přiřazenou k vašemu účtu. Jméno volajícího není důkazem totožnosti ani vlastnictví.
Autorizujte svůj zdroj
- V nastavení IP adres CNAM přidejte veřejnou zdrojovou IP adresu, kterou používá váš SBC nebo vaše aplikace, a přiřaďte k ní zamýšlenou službu.
- Odešlete SIP INVITE na adresu
cnam.multitel.neta jako uživatelskou část request-URI použijte úplné telefonní číslo. Zveřejněným přenosem je UDP na cílovém portu 5060. - Pomocí svého SIP zásobníku vygenerujte hlavičky Via, From, To, Contact, Call-ID, CSeq a další požadované hlavičky transakce. Neposílejte pouze níže uvedený řádek požadavku.
- Správně dokončete SIP transakci a vrácené jméno použijte, pouze pokud je k dispozici použitelný výsledek.
INVITE sip:12025550123@cnam.multitel.net SIP/2.0Tato vyhledávací služba nepřijímá SIP registraci. Autorizace vychází z nakonfigurované zdrojové adresy, kterou může být veřejná adresa vaší brány NAT.
Přečtěte výsledek SIP vyhledávání
Služba vrací výsledek v odpovědi SIP 380 s hlavičkou P-Asserted-Identity. Jde o transakci s výsledkem vyhledávání, nikoli o přijatý telefonní hovor. Popis důvodu může obsahovat vrácené jméno; zpracujte hlavičku identity a nespoléhejte na jednu pevnou frázi.
SIP/2.0 380 EXAMPLE CALLER
P-Asserted-Identity: "EXAMPLE CALLER" <sip:12025550123@192.0.2.10>
Content-Length: 0Tento výňatek vynechává hlavičky transakce. 192.0.2.10 v příkladu představuje žádající systém. Skutečnou odpověď je třeba spárovat s hlavičkami Call-ID a CSeq vašeho SIP zásobníku.
- 380 s použitelným jménem
- Přečtěte zobrazované jméno z P-Asserted-Identity, prostřednictvím svého SIP zásobníku potvrďte konečnou odpověď na INVITE a pokračujte ve svém postupu volání.
- Žádné použitelné jméno
- Nenahrazujte ověřené jméno volajícího chybovou zprávou, prázdnou hodnotou ani dotazovaným číslem. Zachovejte funkčnost hovoru s vaším běžným chováním pro neznámé jméno.
- 403 nebo jiné odmítnutí
- Zkontrolujte metodu požadavku, cílovou doménu, autorizaci zdrojové IP adresy a stav účtu či služby. Chybu autorizace neopakujte v rychlé smyčce.
- Vypršení časového limitu
- Rozlišujte opakované odeslání v rámci SIP transakce od nového vyhledávání. Nové pokusy omezte, protože mohou vytvořit další poplatek za dotaz.
Fakturace, opakování a rozdíl oproti aktualizaci identifikace volajícího
Nové vyhledávání může způsobit poplatek za dotaz. Tato rozhraní pro vyhledávání nedokumentují klíč idempotence, takže nový pokus může být druhým zpoplatněným dotazem. Při selhání přenosu nebo služby používejte omezený počet opakovaných pokusů s prodlužováním čekací doby, nejprve vyřešte chyby účtu a zkontrolujte vykázané poplatky za dotazy. Data ukládejte do mezipaměti jen na dobu vhodnou pro vaši aplikaci; údaje o jménech volajících se mohou měnit.
Vyhledávání CNAM jméno pouze čte. Nemění jméno zobrazované u vašich odchozích hovorů. Aktualizace jména volajícího v LIDB je samostatná operace s vlastními poli, autorizací, cenou a zpracováním.