Integrazione CNAM
CNAM tramite SIP
Autorizza la tua sorgente SIP, invia una transazione di ricerca e leggi l’identità del chiamante restituita.
Scegli il comportamento della ricerca
| Livello | Prezzo pubblico per query | Cosa fa |
|---|---|---|
| Starter | 0,0026 USD | Usa informazioni proprietarie e in cache sul nome del chiamante. |
| Standard | 0,0037 USD | Esegue una ricerca di rete in tempo reale per ogni query. |
| Mixed | 0,004 USD | Prova prima una ricerca in tempo reale, poi ripiega sui dati Starter quando non viene trovato alcun nome. |
Il servizio selezionato determina il comportamento della ricerca; Mixed non è una ricerca che consulta prima la cache. Verifica la tariffa assegnata al tuo account prima dell’uso in produzione. Il nome di un chiamante non è una prova di identità o di titolarità.
Autorizza la tua sorgente
- Aggiungi l’IP pubblico di origine usato dal tuo SBC o dalla tua applicazione nelle impostazioni IP CNAM e associa il servizio previsto.
- Invia un SIP INVITE a
cnam.multitel.net, usando il numero di telefono completo come utente del request-URI. Il trasporto pubblicato è UDP sulla porta di destinazione 5060. - Usa il tuo stack SIP per generare Via, From, To, Contact, Call-ID, CSeq e gli altri header di transazione richiesti. Non inviare soltanto la riga di richiesta riportata di seguito.
- Completa correttamente la transazione SIP e usa il nome restituito solo se è presente un risultato utilizzabile.
INVITE sip:12025550123@cnam.multitel.net SIP/2.0Questo servizio di ricerca non accetta la registrazione SIP. L’autorizzazione si basa sull’indirizzo di origine configurato, che può essere l’indirizzo pubblico del tuo gateway NAT.
Leggi il risultato della ricerca SIP
Il servizio restituisce il risultato in una risposta SIP 380 con un header P-Asserted-Identity. Si tratta della transazione del risultato della ricerca, non di una telefonata con risposta. La reason phrase può contenere il nome restituito; analizza l’header di identità invece di fare affidamento su una frase fissa.
SIP/2.0 380 EXAMPLE CALLER
P-Asserted-Identity: "EXAMPLE CALLER" <sip:12025550123@192.0.2.10>
Content-Length: 0Questo estratto omette gli header di transazione. 192.0.2.10 rappresenta il sistema richiedente nell’esempio. La risposta effettiva deve essere associata a Call-ID e CSeq del tuo stack SIP.
- 380 con un nome utilizzabile
- Leggi il nome visualizzato da P-Asserted-Identity, conferma la risposta finale al INVITE tramite il tuo stack SIP e prosegui con il tuo flusso di chiamata.
- Nessun nome utilizzabile
- Non usare un messaggio di errore, un valore vuoto o il numero interrogato come nome del chiamante verificato. Mantieni la chiamata funzionante con il tuo comportamento ordinario per i nomi sconosciuti.
- 403 o un altro rifiuto
- Controlla il metodo della richiesta, il dominio di destinazione, l’autorizzazione dell’IP di origine e lo stato dell’account e del servizio. Non ritentare un errore di autorizzazione in un ciclo serrato.
- Timeout
- Distingui le ritrasmissioni della transazione SIP da una nuova ricerca. Limita i nuovi tentativi, perché possono generare un ulteriore addebito di query.
Fatturazione, nuovi tentativi e differenza rispetto all’aggiornamento del caller ID
Una nuova ricerca può comportare un addebito di query. Queste interfacce di ricerca non documentano una chiave di idempotenza, quindi un nuovo tentativo può essere una seconda query a pagamento. Usa un backoff limitato per i guasti di trasporto o di servizio, risolvi prima gli errori dell’account e riconcilia gli addebiti di query riportati. Memorizza i dati in cache solo per un periodo adatto alla tua applicazione; i dati sul nome del chiamante possono cambiare.
Una ricerca CNAM legge un nome. Non modifica il nome mostrato nelle tue chiamate in uscita. L’aggiornamento del nome del chiamante LIDB è un’operazione separata, con campi, autorizzazione, prezzo ed elaborazione propri.