AmoCRM integratsiyasi

AmoCRM integratsiyasi orqali Utel tizimi va AmoCRM CRM o'rtasida qo'ng'iroqlar avtomatik sinxronlashtiriladi. Kiruvchi va chiquvchi qo'ng'iroqlar AmoCRM da avtomatik qayd etiladi, lidlar va kontaktlar aniqlanadi, qo'ng'iroq yozuvi CRM ga yuklanadi.

Imkoniyatlar

• Kiruvchi/chiquvchi qo'ng'iroqlar AmoCRM da lid sifatida avtomatik qayd etiladi
• Mijozlarni lidi/kontaktiga asosan mas'ul menejer aniqlanadi
• Qo'ng'iroq audio yozuvini AmoCRM ga yuklash
• AmoCRM pipeline va bosqichlari bilan moslashtirilgan sozlamalar
• Foydalanuvchilarni AmoCRM menejerlar bilan bog'lash
• Smart Redirect uchun AmoCRM orqali mas'ul operator aniqlash

Ulanish

AmoCRM integratsiyasi OAuth 2.0 orqali amalga oshiriladi. Ulanish uchun AmoCRM admin panelidagi integratsiya sahifasidan Utel ilovasini qo'shish va keyin Utel tizimida OAuth kodi orqali tasdiqlash kerak.

---

API

Ogohlantirish

Barcha endpointlar Bearer token talab qiladi. Batafsil: Auth

Integratsiya holati

Endpoint

GET /integration/amocrm/info

AmoCRM integratsiyasining joriy holati haqida ma'lumot qaytaradi.

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result.enabled	boolean	Integratsiya yoqilganmi
result.client_id	string | null	AmoCRM ilovasi client_id
result.domain	string | null	AmoCRM subdomain

Example

{
  "status": "success",
  "code": 200,
  "result": {
    "enabled": true,
    "client_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "domain": "mycompany.amocrm.ru"
  },
  "message": "Ok"
}

---

OAuth — ulanish

Endpoint

POST /integration/amocrm/oauth

AmoCRM tomonidan qaytarilgan code orqali OAuth jarayonini yakunlaydi.

Request

Field	Type	Required	Description
referer	string	Yes	AmoCRM portal domain (masalan: mycompany.amocrm.ru)
code	string	Yes	AmoCRM tomonidan berilgan OAuth kodi

Example

{
  "referer": "mycompany.amocrm.ru",
  "code": "def50200abc..."
}

Response

Field	Type	Description
message	string	OAuth successfully registered

---

Ulanishni uzish

Endpoint

DELETE /integration/amocrm/disconnect

AmoCRM bilan ulanishni uzib, barcha tokenlarni o'chiradi.

Response

Field	Type	Description
message	string	Successfully disconnected from amocrm

---

Sozlamalarni olish

Endpoint

GET /integration/amocrm/settings

AmoCRM integratsiya sozlamalarini qaytaradi (pipeline sozlamalari).

---

Sozlamalarni saqlash

Endpoint

PUT /integration/amocrm/settings

AmoCRM integratsiya sozlamalarini yangilaydi (pipeline va bosqich bog'liqliklar).

---

AmoCRM pipeline larini olish

Endpoint

GET /integration/amocrm/amocrm-pipelines

AmoCRM dagi barcha pipelinelar va ularning bosqichlari ro'yxatini qaytaradi. Sozlamalar uchun ishlatiladi.

WARNING

Ushbu endpoint AmoCRM API ga so'rov yuboradi, shuning uchun AmoCRM bilan faol ulanish bo'lishi shart.

---

AmoCRM foydalanuvchilarini olish

Endpoint

GET /integration/amocrm/amocrm-users

AmoCRM dagi barcha foydalanuvchilar ro'yxatini qaytaradi. Utel foydalanuvchilari bilan bog'lash uchun ishlatiladi.

---

Foydalanuvchi bog'liqliklarini olish

Endpoint

GET /integration/amocrm/bind-users

Utel foydalanuvchilari va AmoCRM menejerlar o'rtasidagi bog'liqliklar ro'yxatini qaytaradi.

Response

Field	Type	Description
result	array	Bog'liqliklar ro'yxati
result[*].sip_user_id	int	Utel foydalanuvchi moduli
result[*].amocrm_user_id	int	AmoCRM menejer ID

---

Foydalanuvchi bog'liqliklarini saqlash

Endpoint

PUT /integration/amocrm/bind-users

Utel foydalanuvchilarini AmoCRM menejerlar bilan bog'laydi.

Request

[
  { "sip_user_id": 101, "amocrm_user_id": 12345 },
  { "sip_user_id": 102, "amocrm_user_id": 12346 }
]

---

Manual integratsiya ma'lumotlari

Endpoint

GET /integration/amocrm/manual

AmoCRM widget uchun kerakli texnik ma'lumotlarni qaytaradi (URL va token).

Response

Field	Type	Description
result.domain	string	Utel API domain manzili
result.utel_token	string	AmoCRM widget autentifikatsiya tokeni

---

Qo'ng'iroq boshlash (Originate)

Endpoint

POST /integration/amocrm/originate

AmoCRM interfeysidan to'g'ridan-to'g'ri qo'ng'iroq boshlash.

Request

Field	Type	Required	Description
user_id	int	Yes	AmoCRM foydalanuvchi ID (qo'ng'iroq qiladigan operator)
call_to	string	Yes	Terilishi kerak bo'lgan telefon raqam

Example

{
  "user_id": 12345,
  "call_to": "+998901234567"
}

Developer notes:

• user_id AmoCRM menejer ID bo'lib, tizim uni Utel moduliga (sip_user_id) avtomatik tarjima qiladi
• Tarjima bind-users orqali sozlanadi