Ссылка скопирована
Мы используем cookie и Яндекс.Метрику, чтобы сайт работал лучше
ძიება

Uis ტელეფონიის ჩართვა API-ს საშუალებით

შინაარსი:

შექმნის ახალ პირად ანგარიშზე UIS

ტარიფის ჩართვა

მნიშვნელოვანია! MEDLOCK-ში API ტელეფონიის გამოსაყენებლად, თქვენ უნდა ჩართოთ ნებისმიერი ტარიფი კატეგორიიდან«Виртуальная АТС». დამატებითი ინფორმაციისთვის იხილეთ UIS გვერდი.
თქვენ ასევე დაგჭირდებათ დამატებითი ვარიანტი ტელეფონიის დასაკავშირებლად თქვენს პირად UIS ანგარიშში«Инструменты интеграции». აუცილებელია ინტეგრაციამ სწორად იმუშაოს.

მნიშვნელოვანია! იმისათვის, რომ ზარის ტრანსკრიფცია იმუშაოს Medlock-ში, დააკავშირეთ მეტყველების ანალიტიკური მოდული UIS-ში
  1. გახსენით განყოფილება ფასების გეგმებითა და ვარიანტებით.
Подключить инструменты интеграции

2. გაააქტიურეთ ვარიანტი«Инструменты интеграции».

Активировать инструменты интеграций

მომხმარებლის კონფიგურაცია და მათი უფლებები

  1. ღია «Настройки»→ განყოფილება«Сотрудники и отделы».
Настройки - Сотрудники и разделы в UIS

2. დააჭირეთ «Добавить сотрудника», შეავსეთ ფორმა და დააჭირეთ «Добавить». გაიხსნება გაფართოებული თანამშრომლის ბარათი.

Создание нового сотрудника в UIS

3. მიეცით თანამშრომელს უფლებები. გაფართოებულ ბარათში«Роль», აირჩიეთ წინასწარ განსაზღვრული როლი სფეროში«Администратор». UIS რეკომენდაციას აძლევს ამ როლს იმ თანამშრომელს, რომლის გასაღები გამოიყენება ინტეგრაციისთვის.

4. თუ თქვენ შექმენით საკუთარი როლი და შეარჩიეთ იგი როლის ნაცვლად«Администратор», წვდომის უფლებების კონფიგურაცია:

  • ღია «Администратор»→ «Безопасность»→ განყოფილება«Права доступа».
  • იპოვეთ სვეტი სასურველი როლით.
  • აირჩიეთ ყველა ელემენტი განყოფილებაში «HTTP-уведомления»და ჯგუფი«Виртуальная АТС», მათ შორის ჩასახული ნივთები.

5. მიანიჭეთ თანამშრომელს API-ზე წვდომა. განყოფილების გაფართოება «Дополнительные настройки»და აირჩიეთ API ტიპები: მონაცემთა API და ზარის API.

Дополнительные настройки сотрудника в UIS

Активировать ключ API в UIS

6. აირჩიეთ ვარიანტი «Использовать ключ API»- სისტემა წარმოქმნის უნიკალურ გასაღებს. შეცვლა «Ключ API активен»უნდა იყოს მწვანე.

Создать ключ API в UIS

7. სფეროში«Время жизни», აირჩიეთ «Всегда»გასაღები მოქმედებს განუსაზღვრელი ვადით. თუ თქვენ აირჩიეთ «До»და მიუთითეთ თარიღი, გასაღები შეწყვეტს მუშაობას მას შემდეგ. Medlock-ში ტელეფონია გამორთულია, სანამ არ გამოიმუშავებთ ახალ გასაღებს.

8. დააჭირეთ «Копировать»გასაღების გვერდით და შეინახეთ იგი. თქვენ დაგჭირდებათ, როდესაც მოდულის დაკავშირება MedLock-ში. შემდეგ შეინახეთ თანამშრომლის პარამეტრები.

Копировать ключ API в UIS
მნიშვნელოვანია! გასაღები ნაჩვენებია მხოლოდ ერთხელ და იმალება პარამეტრების შენახვის ან გვერდის გადატვირთვის შემდეგ. შეინახეთ გასაღები და გახსოვდეთ, რომელი თანამშრომლისთვის შეიქმნა იგი.
მნიშვნელოვანია! თუ თქვენ იყენებთ მოდულს«Сквозная аналитика», შეგიძლიათ მიიღოთ გასაღები მისი პარამეტრებიდან.

შექმნის უსაფრთხოების

უსაფრთხოების პარამეტრები ხელმისაწვდომია მომხმარებლისთვის როლით«Администратор».

  1. ღია «Администратор»→ «Безопасность»→ განყოფილება«Настройки безопасности».
Открыть настройки безопасности в UIS

2. გადადით ჩანართზე «API»და დააჭირეთ «+ Добавить».

Перейти во вкладку API в UIS

3. «IP/маска»ველში შეიყვანეთ 0.0.0.0/0«Описание». თქვენ არ გჭირდებათ ველის შევსება.

4. შეინახეთ მისამართი ველების გვერდით ფლოპი დისკის ხატულაზე დაჭერით.

Добавить IP адрес МедЛока в белый список
მნიშვნელოვანია! ცვლილებები ძალაში ერთ საათში შევა.
მნიშვნელოვანია! თუ MedLock-ის IP მისამართი არ არის დამატებული დაშვებული UIS-ის სიაში პირად ანგარიშზე«Телефония», შეცდომა გამოჩნდება მოდულის დაკავშირებისას.
Ошибка на первом шаге если не указан IP
მნიშვნელოვანია! თქვენ უნდა შექმნათ და დააკონფიგურიროთ SIP ხაზები თქვენს პირად uis ანგარიშში. დამატებითი ინფორმაციისთვის იხილეთ SIP ნომრები მუხლი.

მოდულის დაკავშირება «Телефония»მედლოკში

მოდულის დაკავშირება და კონფიგურაცია «Телефония»მედლოკში.

დამატებითი ინფორმაციისთვის იხილეთ მოდულის კავშირი მუხლი«Телефония».

HTTP შეტყობინებების კონფიგურაცია UIS-ში

Medlock-ში მოდულის დაკავშირების შემდეგ, თქვენ უნდა დააყენოთ შეტყობინებები uis-ის პირად ანგარიშზე ისე, რომ ზარები გამოჩნდეს სისტემაში.

  1. გადადით UIS-ის პირად ანგარიშზე.

2. ღია «Интеграции»→ განყოფილება«HTTP-уведомления».

Открыть уведомления в UIS

3. დააჭირეთ «+ Добавить HTTP-уведомление».

Создать уведомление в UIS

HTTP შეტყობინების ფორმის შევსება

შექმენით ექვსი ტიპის შეტყობინებები. მათი სახელები, ტერმინები და ტექსტები მოცემულია განყოფილებაში «Создание HTTP-уведомлений»ქვემოთ.

შეტყობინების შექმნის ფორმა შედგება შემდეგი ბლოკებისგან::

  • HTTP შეტყობინების სახელი " - შეიყვანეთ სახელი ინსტრუქციიდან.
  • ღონისძიების ტიპი " -ჩამოსაშლელი სიიდან აირჩიეთ ღონისძიება. ღონისძიებები დაჯგუფებულია სერვისების მიხედვით: «Звонки», «ОМНИ», «Аналитика рекламы».
  • «Условия» - შეავსეთ იგი მხოლოდ იმ შემთხვევაში, თუ პირობები მითითებულია ინსტრუქციებში.
  • «Настройка HTTP» - აირჩიეთ POST მეთოდი, მიუთითეთ მედლოკში მოდულის შეერთებისას გადაწერილი URL და ჩასვით შეტყობინების ტექსტი.
Создание HTTP уведомления

ფორმის შევსების შემდეგ დააჭირეთ «Сохранить».

შექმნის ძველ პირად ანგარიშზე UIS

ტარიფის ჩართვა

მნიშვნელოვანია! MEDLOCK-ში API ტელეფონიის გამოსაყენებლად, თქვენ უნდა ჩართეთ ნებისმიერი ტარიფი კატეგორიიდან«Виртуальная АТС».

თქვენ ასევე დაგჭირდებათ დამატებითი ვარიანტი ტელეფონიის დასაკავშირებლად თქვენს პირად UIS ანგარიშში«Базовые отраслевые решения». აუცილებელია ინტეგრაციამ სწორად იმუშაოს.

  1. დააჭირეთ მომხმარებლის სახელს ზედა მარჯვენა კუთხეში და აირჩიეთ «Аккаунт».
Открыть аккаунт в старом ЛК UIS

2. გვერდზე, რომელიც იხსნება, დააჭირეთ «Тарифы и опции»და გაააქტიურეთ ვარიანტი«Базовые отраслевые решения».

Подключить дополнительный тариф

მომხმარებლის კონფიგურაცია და მათი უფლებები

  1. დააჭირეთ მომხმარებლის სახელს ზედა მარჯვენა კუთხეში და აირჩიეთ «Управление пользователями».
Создайте пользователя

2. დააჭირეთ «Добавить пользователя».

Добавить пользователя в старом ЛК UIS

3. მიანიჭეთ მომხმარებლის წვდომის უფლებები მონაცემთა API-სა და ზარის API-ზე.

Использовать Data Api

3. ჩართეთ API გასაღები.

4. გენერირება და შენახვა API გასაღები. თქვენ დაგჭირდებათ, როდესაც მოდულის დაკავშირება MedLock-ში.

Создайте ключ API

შექმნის უსაფრთხოების

უსაფრთხოების პარამეტრები ხელმისაწვდომია მომხმარებლისთვის როლით«Администратор».

  1. დააჭირეთ მომხმარებლის სახელს ზედა მარჯვენა კუთხეში და აირჩიეთ «Аккаунт».
Открыть аккаунт в старом ЛК UIS

2. გახსენით გვერდი «Правила и настройки безопасности»და გადადით ჩანართზე«API».

Открыть правила и настройки безопасности

3. დააჭირეთ «+ Добавить»და დაამატეთ ip მისამართი 0.0.0.0/0 დაშვებულ სიაში.

Добавить IP МедЛока в белый список в старом личном кабинете UIS

4. შეინახეთ ცვლილებები ფლოპი დისკის ხატულაზე დაჭერით მარჯვნივ.

მნიშვნელოვანია! ცვლილებები ძალაში ერთ საათში შევა.
მნიშვნელოვანია! თუ MedLock-ის IP მისამართი არ არის დამატებული დაშვებული UIS-ის სიაში პირად ანგარიშზე«Телефония», შეცდომა გამოჩნდება მოდულის დაკავშირებისას.
Ошибка на первом шаге если не указан IP

მოდულის დაკავშირება «Телефония»მედლოკში

მოდულის დაკავშირება და კონფიგურაცია «Телефония»მედლოკში.

დამატებითი ინფორმაციისთვის იხილეთ როგორ დააკავშიროთ მოდულის სტატია«Телефония».

HTTP შეტყობინებების კონფიგურაცია UIS-ში

Medlock-ში მოდულის დაკავშირების შემდეგ, თქვენ უნდა დააყენოთ შეტყობინებები uis-ის პირად ანგარიშზე ისე, რომ ზარები გამოჩნდეს სისტემაში.

  1. გადადით UIS-ის პირად ანგარიშზე.
  2. გახსენით განყოფილება«Уведомления».
  3. აირჩიეთ ქვეპუნქტი «HTTP-уведомления».
  4. დააჭირეთ«+ Добавить HTTP-уведомление».
Добавить новое уведомление в старом лк UIS
მნიშვნელოვანია! თქვენ უნდა შექმნათ და დააკონფიგურიროთ SIP ხაზები თქვენს პირად uis ანგარიშში. დამატებითი ინფორმაციისთვის იხილეთ SIP ნომრები მუხლი.

HTTP შეტყობინების ფორმის შევსება

შექმენით ექვსი ტიპის შეტყობინებები. მათი სახელები, ტერმინები და ტექსტები მოცემულია განყოფილებაში «Создание HTTP-уведомлений»ქვემოთ.

ფორმის შევსების შემდეგ დააჭირეთ «Сохранить».

Создание уведомления в старом интерфейсе

HTTP შეტყობინებების შექმნა

შეტყობინება No1. საუბრის დასაწყისი

  • სახელი არის «Начало разговора».
  • ღონისძიების ტიპია: «Начало разговора».
  • შექმნის HTTP პოსტი.
  • URL-ჩასვით URL, რომ თქვენ გადაწერა, როდესაც დამაკავშირებელი მოდულის MedLock.

შეტყობინების ტექსტი:

{
"notification_name":"call_answered",
"notification_timestamp": {{notification_timestamp}},
"call_session_id": {{call_session_id}},
"employee_phone_number": {{employee_phone_number}},
"მიმართულება": {{მიმართულება}},
"virtual_phone_number": {{virtual_phone_number}} ,
"contact_phone_number": {{contact_phone_number}},
"ექსტერნალ_იდი": {{ექსტერნალ_იდი}}
}

შეტყობინება No2. ზარის შეწყვეტა

  • სახელი არის «Завершение звонка».
  • ღონისძიების ტიპია: «Завершение звонка».
  • შექმნის HTTP პოსტი.
  • URL-ჩასვით URL, რომ თქვენ გადაწერა, როდესაც დამაკავშირებელი მოდულის MedLock.

შეტყობინების ტექსტი:

{
""notification_name":"call_finished",
"lost_reason": {{lost_reason}},
"finish_reason": {{finish_reason}},
"is_lost": {{is_lost}},
"კალ_სტატუსი": {{კალ_სტატუსი}},
"call_session_id": {{call_session_id}},
"notification_timestamp": {{notification_timestamp}},
"employee_phone_number": {{employee_phone_number}},
"მიმართულება": {{მიმართულება}},
"ვირტუალური_ფონი_ნუმერი": {{ვირტუალური_ფონი_ნუმერი}},
"contact_phone_number": {{contact_phone_number}},
"ექსტერნალ_იდი": {{ექსტერნალ_იდი}}
}

შეტყობინება No3. საუბრის დასასრული

  • სახელი არის «Окончание разговора».
  • ღონისძიების ტიპია: «Окончание разговора».
  • შექმნის HTTP პოსტი.
  • URL-ჩასვით URL, რომ თქვენ გადაწერა, როდესაც დამაკავშირებელი მოდულის MedLock.

შეტყობინების ტექსტი:

{
""notification_name":"conversation_ended",
"call_session_id": {{call_session_id}},
"notification_timestamp": {{notification_timestamp}},
"employee_phone_number": {{employee_phone_number}},
"მიმართულება": {{მიმართულება}},
"ვირტუალური_ფონი_ნუმერი": {{ვირტუალური_ფონი_ნუმერი}},
"contact_phone_number": {{contact_phone_number}},
"ექსტერნალ_იდი": {{ექსტერნალ_იდი}}
}

შეტყობინება No4. ბერკეტის შეწყვეტა

  • სახელი არის «Завершение плеча».
  • ღონისძიების ტიპია: «Завершение плеча».
  • შექმნის HTTP პოსტი.
  • URL-ჩასვით URL, რომ თქვენ გადაწერა, როდესაც დამაკავშირებელი მოდულის MedLock.

პირობები:

  1. ჩართეთ პირობები.
  2. სფეროში«Параметр», აირჩიეთ «Направление плеча».
  3. მიუთითეთ მდგომარეობა «Точно соответствует».
  4. აირჩიეთ«Исходящее».
Настройка условий

შეტყობინების ტექსტი:

{
""notification_name":"leg_ended",
"call_session_id": {{call_session_id}},
"notification_timestamp": {{notification_timestamp}},
"ექსტერნალ_იდი": {{ექსტერნალ_იდი}},
"employee_phone_number": {{employee_phone_number}},
"ლეგ_იდი": {{ლეგ_იდი}},
"მიმართულება": {{მიმართულება}},
"ვირტუალური_ფონი_ნუმერი": {{ვირტუალური_ფონი_ნუმერი}},
"contact_phone_number": {{contact_phone_number}}
}

შეტყობინება No5. გამავალი მხრის

  • სახელი არის «Исходящее плечо».
  • ღონისძიების ტიპია: «Исходящее плечо».
  • შექმნის HTTP პოსტი.
  • URL-ჩასვით URL, რომ თქვენ გადაწერა, როდესაც დამაკავშირებელი მოდულის MedLock.

შეტყობინების ტექსტი:

{
""notification_name":"outbound_leg",
"call_session_id": {{call_session_id}},
"notification_timestamp": {{notification_timestamp}},
"ექსტერნალ_იდი": {{ექსტერნალ_იდი}},
"employee_phone_number": {{employee_phone_number}},
"ლეგ_იდი": {{ლეგ_იდი}},
"მიმართულება": {{მიმართულება}},
"ვირტუალური_ფონი_ნუმერი": {{ვირტუალური_ფონი_ნუმერი}},
"contact_phone_number": {{contact_phone_number}}
}

შეტყობინება No6. შემომავალი ბერკეტი

  • სახელი არის «Входящее плечо».
  • ღონისძიების ტიპია: «Входящее плечо».
  • შექმნის HTTP პოსტი.
  • URL-ჩასვით URL, რომ თქვენ გადაწერა, როდესაც დამაკავშირებელი მოდულის MedLock.

შეტყობინების ტექსტი:

{
"notification_name":"inbound_leg",
"call_session_id": {{call_session_id}},
"notification_timestamp": {{notification_timestamp}},
"ექსტერნალ_იდი": {{ექსტერნალ_იდი}},
"employee_phone_number": {{employee_phone_number}},
"ლეგ_იდი": {{ლეგ_იდი}},
"მიმართულება": {{მიმართულება}},
"ვირტუალური_ფონი_ნუმერი": {{ვირტუალური_ფონი_ნუმერი}},
"contact_phone_number": {{contact_phone_number}}
}

შექმნის softphones

თუ ტელეფონი პირველად არის დაკავშირებული

Softphone-ის პარამეტრებში მიუთითეთ uis ოპერატორის მომხმარებლის სახელი, პაროლი და URL.

თუ ტელეფონი ადრე იყო დაკავშირებული ვარსკვლავით

Softphone-ის პარამეტრებში შეცვალეთ მომხმარებლის სახელი, პაროლი და URL uis-ის პირად ანგარიშში მითითებული მონაცემებით.

Softphone-ის შექმნის შესახებ დამატებითი ინფორმაციისთვის იხილეთ სტატია როგორ შევქმნათ sip ტელეფონი/softphone მოდულისთვის«Телефония».

პარამეტრების შემოწმება

მნიშვნელოვანია! შეტყობინების URL-ის ხელახლა ნახვა კოპირების შემდეგ შეუძლებელია. თუ ის არ გაქვთ შენახული, შექმენით ახალი URL მოდულის პარამეტრებში «Телефония»MedLock-ში და განაახლეთ იგი uis-ის ექვსივე HTTP შეტყობინებაში. დამატებითი ინფორმაციისთვის იხილეთ სტატია როგორ დააკავშიროთ სატელეფონო მოდული.
reload_url

Itog

შეტყობინებების დაყენების შემდეგ, ჩვენ გირჩევთ გააკეთოთ საცდელი ზარი.

ზარის ბარათი უნდა იყოს ნაჩვენები MedLock-ში, ზარის მიღების ან უარყოფის შესაძლებლობით.

ზარის დასრულებული მოქმედებები გამოჩნდება ზარის ისტორიაში MedLock-ში.