Intégration CNAM
CNAM sur SIP
Autorisez votre source SIP, envoyez une transaction de recherche et lisez l'identité d'appelant retournée.
Choisissez le comportement de recherche
| Niveau | Prix public par requête | Fonctionnalité |
|---|---|---|
| Starter | 0,0026 $US | Utilise des informations propriétaires et mises en cache sur le nom d'appelant. |
| Standard | 0,0037 $US | Effectue une recherche réseau en temps réel pour chaque requête. |
| Mixed | 0,004 $US | Effectue d’abord une recherche en temps réel, puis utilise les données Starter si aucun nom n’est trouvé. |
Le service sélectionné détermine le fonctionnement de la recherche ; Mixed ne consulte pas le cache en premier. Vérifiez le tarif attribué à votre compte avant toute utilisation en production. Un nom d’appelant ne constitue pas une preuve d’identité ou de propriété.
Autorisez votre source
- Ajoutez l'adresse IP publique utilisée par votre SBC ou application dans Paramètres IP CNAM et associez le service prévu.
- Envoyez une requête SIP INVITE à
cnam.multitel.net, en utilisant le numéro de téléphone complet comme partie utilisateur de l’URI de requête. Le transport publié est UDP sur le port de destination 5060. - Utilisez votre pile SIP pour générer les Via, From, To, Contact, Call-ID, CSeq et les autres en-têtes de transaction requis. N'envoyez pas uniquement la ligne de requête ci-dessous.
- Terminez correctement la transaction SIP et utilisez le nom retourné uniquement s'il y a un résultat utilisable.
INVITE sip:12025550123@cnam.multitel.net SIP/2.0Ce service de recherche n'accepte pas l'enregistrement SIP. L'autorisation se base sur l'adresse source configurée, qui peut être l'adresse publique de votre passerelle NAT.
Lisez le résultat de recherche SIP
Le service renvoie le résultat dans une réponse SIP 380 avec un en-tête P-Asserted-Identity. Il s'agit de la transaction de recherche, pas d'un appel téléphonique répondu. La phrase de raison peut contenir le nom retourné ; analysez l'en-tête d'identité plutôt que de compter sur une phrase fixe.
SIP/2.0 380 EXAMPLE CALLER
P-Asserted-Identity: "EXAMPLE CALLER" <sip:12025550123@192.0.2.10>
Content-Length: 0Cet extrait omet les en-têtes de transaction. 192.0.2.10 représente le système demandeur dans l'exemple. La réponse réelle doit être associée à Call-ID et CSeq de votre pile SIP.
- 380 avec un nom utilisable
- Lisez le nom affiché dans P-Asserted-Identity, accusez réception de la réponse finale à INVITE via votre pile SIP, puis poursuivez le traitement de l’appel.
- Pas de nom utilisable
- Ne présentez pas un message d’erreur, une valeur vide ou le numéro interrogé comme un nom d’appelant vérifié. Laissez l’appel se poursuivre avec votre traitement habituel des noms inconnus.
- 403 ou autre rejet
- Vérifiez la méthode de requête, le domaine de destination, l'autorisation IP source et le statut du compte/service. Ne réessayez pas une erreur d'autorisation en boucle serrée.
- Délai d’attente dépassé
- Distinguez les retransmissions d’une transaction SIP d’une nouvelle recherche. Limitez les nouvelles tentatives, car elles peuvent entraîner de nouveaux frais de requête.
Facturation, nouvelles tentatives et différence avec la mise à jour du nom d’appelant
Une nouvelle recherche peut entraîner des frais de requête. Ces interfaces ne documentent aucune clé d’idempotence ; une nouvelle tentative peut donc constituer une deuxième requête facturable. En cas de défaillance du transport ou du service, limitez les tentatives et espacez-les progressivement. Résolvez d’abord les erreurs de compte et rapprochez les frais de requête signalés de vos enregistrements. Mettez les résultats en cache uniquement pendant une durée adaptée à votre application : les noms d’appelants peuvent changer.
Une recherche CNAM lit un nom. Elle ne change pas le nom présenté sur vos appels sortants. Une mise à jour du nom d'appelant LIDB est une opération distincte avec ses propres champs, autorisation, prix et traitement.