Інтеграція CNAM

CNAM через SIP

Авторизуйте своє джерело SIP, надішліть транзакцію пошуку та прочитайте повернуту ідентифікацію абонента.

Оберіть поведінку пошуку

Рівень	Публічна ціна за запит	Що він робить
Starter	0,0026 USD	Використовує власну та кешовану інформацію про імена абонентів.
Standard	0,0037 USD	Виконує мережевий пошук у реальному часі для кожного запиту.
Mixed	0,004 USD	Спершу намагається виконати пошук у реальному часі, а якщо ім’я не знайдено, повертається до даних Starter.

Поведінку пошуку визначає вибрана послуга; Mixed не є пошуком, що спершу звертається до кешу. Перед використанням у робочому середовищі перегляньте тариф, призначений вашому обліковому запису. Ім’я абонента не є доказом особи чи права власності.

Авторизуйте своє джерело

Додайте публічну IP-адресу джерела, яку використовує ваш SBC або застосунок, у розділі налаштувань IP для CNAM і пов’яжіть її з потрібною послугою.
Надішліть SIP-запит INVITE на cnam.multitel.net, використовуючи повний телефонний номер як користувача в request-URI. Опублікований транспорт — UDP на порт призначення 5060.
Скористайтеся своїм SIP-стеком, щоб сформувати Via, From, To, Contact, Call-ID, CSeq та інші обов’язкові заголовки транзакції. Не надсилайте лише рядок запиту, наведений нижче.
Правильно завершіть SIP-транзакцію й використовуйте повернуте ім’я лише за наявності придатного результату.

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

Ця служба пошуку не приймає SIP-реєстрацію. Авторизація ґрунтується на налаштованій адресі джерела, якою може бути публічна адреса вашого NAT-шлюзу.

Прочитайте результат SIP-пошуку

Служба повертає результат у SIP-відповіді 380 із заголовком P-Asserted-Identity. Це транзакція з результатом пошуку, а не телефонний виклик, на який відповів абонент. Текстове пояснення коду відповіді може містити повернуте ім’я; розбирайте заголовок ідентифікації, а не покладайтеся на одну фіксовану фразу.

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

У цьому фрагменті пропущено заголовки транзакції. 192.0.2.10 позначає в прикладі систему, що надсилає запит. Фактичну відповідь потрібно зіставляти з Call-ID і CSeq вашого SIP-стека.

380 із придатним ім’ям: Прочитайте відображуване ім’я із P-Asserted-Identity, підтвердіть через свій SIP-стек остаточну відповідь на INVITE і продовжте свій робочий процес виклику.
Придатного імені немає: Не підставляйте повідомлення про помилку, порожнє значення чи номер, за яким виконувався запит, як підтверджене ім’я абонента. Дозвольте виклику працювати зі звичайною для вас поведінкою для невідомого імені.
403 або інша відмова: Перевірте метод запиту, домен призначення, авторизацію за IP-адресою джерела та стан облікового запису/послуги. Не повторюйте запит із помилкою авторизації в безперервному швидкому циклі.
Тайм-аут: Відрізняйте повторні передачі SIP-транзакції від нового пошуку. Обмежуйте кількість нових спроб, оскільки кожна з них може створити додаткове нарахування за запит.

Виставлення рахунків, повторні спроби та відмінність від оновлення ідентифікатора абонента

Новий пошук може спричинити нарахування за запит. Для цих інтерфейсів пошуку не задокументовано ключа ідемпотентності, тому повторна спроба може стати другим платним запитом. За збоїв транспорту або служби обмежуйте кількість спроб і робіть між ними паузи, спершу усуньте помилки облікового запису та звіряйте повідомлені нарахування за запити. Кешуйте лише на період, доречний для вашого застосунку; дані про імена абонентів можуть змінюватися.

Пошук CNAM лише читає ім’я. Він не змінює ім’я, що показується під час ваших вихідних викликів. Оновлення імені абонента в LIDB — це окрема операція з власними полями, авторизацією, ціною та обробкою.

Посібник з інтеграції CNAM для облікового запису Отримати допомогу з інтеграцією