API аркылуу байланыштар

API аркылуу байланыштардын тизмесин алып, аларды программалык түрдө кошуп же жаңырта аласыз, мисалы, кардарлар базаңызды вебхуктар аркылуу шайкештештирүү үчүн.

POST /v1/contacts: байланыштарды түзүү же жаңыртуу

Көрсөтүлгөн байланыш линиясына жаңы байланыштарды кошот жана бар байланыштардын аттарын жаңыртат.

URL

POST https://api.wazzabee.com/api-gateway/v1/contacts

Баш саптар

Authorization: Bearer СИЗДИН_API_АЧКЫЧ
Content-Type: application/json

Сурам денеси: бир байланыш

{
  "channel_id": "Байланыш линиясынын UUID",
  "phone": "+996550202160",
  "name": "Диана"
}

Сурам денеси: тизме (бир жолу 1000ге чейин)

{
  "channel_id": "Байланыш линиясынын UUID",
  "contacts": [
    { "phone": "+996550202160", "name": "Диана" },
    { "phone": "77011234567", "name": "Иван" }
  ]
}

Параметрлер

Параметр	Түрү	Милдеттүү	Сүрөттөмө
`channel_id`	string (UUID)	✅ Ооба	Байланыш линиясынын ID. GET /v1/channels аркылуу алыңыз
`phone`	string	✅ Ооба	Каалаган форматтагы номер: ашыкча белгилер (+, боштуктар, кашаалар) алынып салынат
`name`	string	Жок	Байланыштын аты. Эгер көрсөтүлбөсө: жаңы байланыштын аты номер болот, бар байланыштын аты өзгөрбөйт

Иштөө тартиби

Линияда мындай номердеги байланыш жок болсо, ал түзүлөт.
Байланыш бар болуп, name берилсе, аты гана жаңыртылат. Эскертмелер, аватар жана башка маалыматтар өзгөрбөйт.
Номер сандарга чейин нормалдаштырылат; бир сурамдагы кайталанган номерлер бириктирилет.

Жооп

{ "success": true, "added": 2, "updated": 0, "skipped": 0 }

🔒 Маалыматтарды обочолоо: байланыштар сиздин байланыш линияңызга гана кошулат. Өзүңүздүн API ачкычыңыз аркылуу башка аккаунттун байланыштарын жазуу же көрүү мүмкүн эмес.

Мисал (curl)

curl -X POST https://api.wazzabee.com/api-gateway/v1/contacts \
  -H "Authorization: Bearer СИЗДИН_API_АЧКЫЧ" \
  -H "Content-Type: application/json" \
  -d '{"channel_id":"UUID","phone":"+996550202160","name":"Диана"}'

GET /v1/contacts: байланыштардын тизмеси

Байланыштарды барактоо жана издөө менен кайтарат.

GET https://api.wazzabee.com/api-gateway/v1/contacts?limit=50&offset=0&search=Диана

Параметр	Сүрөттөмө
`limit`	Канчасын кайтаруу керек (1–200, демейки боюнча 50)
`offset`	Барактоо үчүн жылыш
`channel_id`	Милдеттүү эмес: ушул линиянын байланыштары гана
`search`	Аты же номери боюнча издөө

Жооп

{
  "success": true,
  "contacts": [
    { "id": "...", "name": "Диана", "phone": "996550202160", "channelId": "...", "channelType": "whatsapp_qr" }
  ],
  "total": 120
}