Ana içeriğe atla

​
Etiketler

Etiketler, sohbetlerinizi kategorize etmenize ve d\u00fczenlemenize olanak tan\u0131yan bir WhatsApp Business \u00f6zelli\u011fidir. Wappfy API \u00fczerinden \u00f6zel etiketler olu\u015fturabilir, sohbetlere atayabilir ve etikete g\u00f6re sohbetleri alabilirsiniz.
Etiketler yaln\u0131zca WhatsApp Business hesaplar\u0131nda kullan\u0131labilir. Ki\u015fisel WhatsApp hesaplar\u0131 etiketleri desteklemez.
T\u00fcm etiket ucu noktalar\u0131 belirli bir \u00f6rnekle s\u0131n\u0131rl\u0131d\u0131r: 
/api/instances/{instanceId}/labels/...

​
Etiket Olu\u015fturma

\u0130sim ve renk ile yeni bir etiket olu\u015fturun. 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/labels \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "VIP Customer",
    "color": 1
  }'
Yan\u0131t: 
{
  "data": {
    "id": "1",
    "name": "VIP Customer",
    "color": 1
  }
}

​
Etiket Renkleri

WhatsApp Business, numara ile tan\u0131mlanan sabit bir etiket renk seti destekler:
Renk Kimli\u011fiRenk
0A\u00e7\u0131k gri
1Ye\u015fil
2Mavi
3Sar\u0131
4Pembe/K\u0131rm\u0131z\u0131

​
Etiketleri Listeleme

\u00d6rne\u011fin t\u00fcm etiketlerini al\u0131n. 
curl https://api.wappfy.io/api/instances/inst_abc123/labels \
  -H "X-Api-Key: YOUR_API_KEY"
Yan\u0131t: 
{
  "data": [
    { "id": "1", "name": "New Customer", "color": 0 },
    { "id": "2", "name": "VIP Customer", "color": 1 },
    { "id": "3", "name": "Pending Payment", "color": 3 },
    { "id": "4", "name": "Resolved", "color": 2 }
  ]
}

​
Etiket G\u00fcncelleme

Mevcut bir etiketin ad\u0131n\u0131 veya rengini g\u00fcncelleyin. 
curl -X PUT https://api.wappfy.io/api/instances/inst_abc123/labels/2 \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Premium Customer",
    "color": 2
  }'

​
Etiket Silme

Bir etiketi kal\u0131c\u0131 olarak silin. Bu i\u015flem, etiketin atand\u0131\u011f\u0131 t\u00fcm sohbetlerden de kald\u0131r\u0131r. 
curl -X DELETE https://api.wappfy.io/api/instances/inst_abc123/labels/2 \
  -H "X-Api-Key: YOUR_API_KEY"
Bir etiketin silinmesi, etiketin ili\u015fkili t\u00fcm sohbetlerden kald\u0131r\u0131lmas\u0131na neden olur. Bu i\u015flem geri al\u0131namaz.

​
Sohbet Etiketleri

​
Bir Sohbetin Etiketlerini Alma

Belirli bir sohbete atanan t\u00fcm etiketleri al\u0131n. 
curl https://api.wappfy.io/api/instances/inst_abc123/labels/chats/[email protected] \
  -H "X-Api-Key: YOUR_API_KEY"
Yan\u0131t: 
{
  "data": [
    { "id": "1", "name": "New Customer", "color": 0 },
    { "id": "3", "name": "Pending Payment", "color": 3 }
  ]
}

​
Sohbete Etiket Atama

Bir sohbete bir veya daha fazla etiket atay\u0131n. Bu, sohbetteki mevcut etiketlerin yerine ge\u00e7er. 
curl -X PUT https://api.wappfy.io/api/instances/inst_abc123/labels/chats/[email protected] \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label_ids": ["1", "2"]
  }'
Bir sohbetteki t\u00fcm etiketleri kald\u0131rmak i\u00e7in bo\u015f bir dizi ge\u00e7irin: {"label_ids": []}.

​
Etikete G\u00f6re Sohbetleri Alma

Belirli bir etiketin atand\u0131\u011f\u0131 t\u00fcm sohbetleri al\u0131n. 
curl https://api.wappfy.io/api/instances/inst_abc123/labels/2/chats \
  -H "X-Api-Key: YOUR_API_KEY"
Yan\u0131t: 
{
  "data": [
    {
      "chat_id": "[email protected]",
      "name": "Maria Silva"
    },
    {
      "chat_id": "[email protected]",
      "name": "Carlos Oliveira"
    }
  ]
}

​
Yayg\u0131n Kullan\u0131m Senaryolar\u0131

message.received olaylar\u0131n\u0131 dinlemek i\u00e7in bir webhook kullan\u0131n. Bilinmeyen bir ki\u015fiden mesaj geldi\u011finde, API \u00fczerinden “Yeni Potansiyel M\u00fc\u015fteri” etiketini atay\u0131n. Bu, ekibinizin yeni konu\u015fmalar\u0131 h\u0131zla tespit etmesine ve \u00f6nceliklendirmesine yard\u0131mc\u0131 olur.
“A\u00e7\u0131k”, “Devam Ediyor” ve “\u00c7\u00f6z\u00fcld\u00fc” gibi etiketler olu\u015fturun. Ekibiniz destek taleplerini i\u015fledik\u00e7e etiketi g\u00fcncelleyin. Basit bir destek kuyru\u011fu olu\u015fturmak i\u00e7in “Etikete G\u00f6re Sohbetleri Alma” ucu noktas\u0131n\u0131 kullan\u0131n.
M\u00fc\u015fterileri kategoriye g\u00f6re etiketleyin (orn. “VIP”, “Toptan”, “Perakende”). Toplu mesaj g\u00f6nderirken, bir etiketin t\u00fcm sohbetlerini al\u0131n ve mesajlar\u0131 d\u00f6ng\u00fc ile g\u00f6nderin.

​
Ucu Noktas\u0131 Referans\u0131

Y\u00f6ntemUcu Noktas\u0131A\u00e7\u0131klama
POST/api/instances/{id}/labelsYeni etiket olu\u015ftur
GET/api/instances/{id}/labelsT\u00fcm etiketleri listele
PUT/api/instances/{id}/labels/{labelId}Etiket g\u00fcncelle
DELETE/api/instances/{id}/labels/{labelId}Etiket sil
GET/api/instances/{id}/labels/chats/{chatId}Sohbetin etiketlerini al
PUT/api/instances/{id}/labels/chats/{chatId}Sohbete etiket ata
GET/api/instances/{id}/labels/{labelId}/chatsEtikete g\u00f6re sohbetleri al

​
Hata Y\u00f6netimi

Durum KoduA\u00e7\u0131klama
400Ge\u00e7ersiz etiket rengi veya eksik zorunlu alanlar.
404Etiket veya sohbet bulunamad\u0131.
409Ayn\u0131 isimde bir etiket zaten mevcut.
422Ge\u00e7ersiz sohbet kimli\u011fi format\u0131.