CNAM-integratie
CNAM via SIP
Autoriseer uw SIP-bron, verstuur een opzoektransactie en lees de geretourneerde beller-identiteit.
Kies het opzoekgedrag
| Niveau | Openbare prijs per opvraging | Wat het doet |
|---|---|---|
| Starter | US$ 0,0026 | Gebruikt eigen en in de cache opgeslagen bellernaaminformatie. |
| Standard | US$ 0,0037 | Voert voor elke opvraging een realtime netwerkopzoeking uit. |
| Mixed | US$ 0,004 | Probeert eerst een realtime opzoeking en valt terug op gegevens van Starter wanneer er geen naam wordt gevonden. |
De gekozen dienst bepaalt het opzoekgedrag; Mixed is geen opzoeking waarbij eerst de cache wordt geraadpleegd. Controleer het tarief dat aan uw account is toegewezen voordat u het in productie gebruikt. Een bellernaam is geen bewijs van identiteit of eigendom.
Autoriseer uw bron
- Voeg het openbare bron-IP-adres dat uw SBC of applicatie gebruikt toe in de CNAM-IP-instellingen en koppel de beoogde dienst.
- Stuur een SIP INVITE naar
cnam.multitel.net, met het volledige telefoonnummer als gebruikersdeel van de request-URI. Het gepubliceerde transport is UDP op bestemmingspoort 5060. - Gebruik uw SIP-stack om de Via, From, To, Contact, Call-ID, CSeq en andere vereiste transactieheaders te genereren. Verstuur niet alleen de onderstaande aanvraagregel.
- Voltooi de SIP-transactie correct en gebruik de geretourneerde naam alleen als er een bruikbaar resultaat aanwezig is.
INVITE sip:12025550123@cnam.multitel.net SIP/2.0Deze opzoekdienst accepteert geen SIP-registratie. Autorisatie is gebaseerd op het geconfigureerde bronadres, dat het openbare adres van uw NAT-gateway kan zijn.
Lees het SIP-opzoekresultaat
De dienst retourneert het resultaat in een SIP-respons 380 met een P-Asserted-Identity-header. Dit is de transactie met het opzoekresultaat, geen beantwoord telefoongesprek. De reason phrase kan de geretourneerde naam bevatten; parseer de identity-header in plaats van op één vaste frase te vertrouwen.
SIP/2.0 380 EXAMPLE CALLER
P-Asserted-Identity: "EXAMPLE CALLER" <sip:12025550123@192.0.2.10>
Content-Length: 0Dit fragment laat transactieheaders weg. 192.0.2.10 staat in het voorbeeld voor het aanvragende systeem. Het daadwerkelijke antwoord moet worden gekoppeld aan de Call-ID en CSeq van uw SIP-stack.
- 380 met een bruikbare naam
- Lees de weergavenaam uit P-Asserted-Identity, bevestig de definitieve INVITE-respons via uw SIP-stack en ga verder met uw gespreksverloop.
- Geen bruikbare naam
- Gebruik geen foutmelding, lege waarde of het opgevraagde nummer als geverifieerde bellernaam. Laat het gesprek doorgaan met uw gebruikelijke gedrag voor onbekende namen.
- 403 of een andere afwijzing
- Controleer de aanvraagmethode, het bestemmingsdomein, de autorisatie van het bron-IP en de account-/servicestatus. Probeer een autorisatiefout niet in een snelle lus opnieuw.
- Time-out
- Maak onderscheid tussen hertransmissies van de SIP-transactie en een nieuwe opzoeking. Beperk nieuwe pogingen, omdat die een extra opvragingskost kunnen veroorzaken.
Facturatie, nieuwe pogingen en het verschil met het bijwerken van de beller-ID
Een nieuwe opzoeking kan een opvragingskost met zich meebrengen. Deze opzoekinterfaces documenteren geen idempotentiesleutel, dus een nieuwe poging kan een tweede factureerbare opvraging zijn. Gebruik beperkte backoff bij transport- of servicefouten, los accountfouten eerst op en reconcilieer de gerapporteerde opvragingskosten. Cache alleen gedurende een periode die past bij uw applicatie; gegevens over bellernamen kunnen veranderen.
Een CNAM-opzoeking leest een naam uit. Ze wijzigt niet de naam die bij uw uitgaande gesprekken wordt getoond. Een LIDB-bijwerking van de bellernaam is een aparte bewerking met eigen velden, autorisatie, prijs en verwerking.