{
  "info": {
    "_postman_id": "614007cc-f93a-460d-9132-94e9801dd842",
    "name": "ZenWapp External API (1.0.0)",
    "description": "ZenWapp External API, mesaj gönderimi, sohbet ve kişi yönetimi, şablonlar, zamanlanmış mesajlar, toplu gönderim ve webhook yönetimi için kullanılır. Tüm çağrılar API anahtarı ile kimlik doğrulaması gerektirir.\n\n## Kurulum\n\n1. `ZenWapp-Production.postman_environment.json` ortam dosyasını da içe aktarın.\n2. Sağ üstten **ZenWapp Production** ortamını seçin.\n3. `api_key` değişkenine panelden aldığınız anahtarı yazın (Ayarlar → API).\n4. **System → Sağlık kontrolü** isteğini çalıştırarak bağlantıyı doğrulayın.\n\nYetkilendirme koleksiyon düzeyinde tanımlıdır; her istek `Authorization: Bearer {{api_key}}` başlığını otomatik alır.\n\nBu koleksiyon OpenAPI spec'inden üretilmiştir — elle düzenlemeyin. Kaynak: docs.zenwapp.com",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{api_key}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://api.zenwapp.com/api/v1/whatsapp/external",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "System",
      "description": "Sağlık kontrolü ve bağlı hesap bilgisi. Entegrasyonunuzu doğrulamak için ilk çağıracağınız uçlar.",
      "item": [
        {
          "name": "Sağlık kontrolü",
          "id": "3c54a93b-f306-4629-8837-5890a2629ae7",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/health",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "health"
              ]
            },
            "description": "API anahtarınızın geçerliliğini ve bağlı hesabın durumunu doğrular. Entegrasyon kurulumunda ilk çağrılması önerilen uçtur.\n\n**Gerekli yetki:** `API anahtarı doğrulaması`\n\n**Yanıt kodları:** 200, 401"
          },
          "response": []
        },
        {
          "name": "Hesap bilgisi",
          "id": "91c7480f-bb9b-4e38-b7ee-f2c13d39fba2",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/account",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "account"
              ]
            },
            "description": "API anahtarının bağlı olduğu kanal hesabının profil ve bağlantı bilgilerini döndürür.\n\n**Gerekli yetki:** `API anahtarı doğrulaması`\n\n**Yanıt kodları:** 200, 401"
          },
          "response": []
        }
      ],
      "id": "fa533b08-7109-42cf-b8b4-f135c88527eb"
    },
    {
      "name": "Chats",
      "description": "Sohbet listesi, telefon numarasından sohbet eşleştirme ve sohbet mesaj geçmişi.",
      "item": [
        {
          "name": "Sohbetleri listele",
          "id": "74644752-2b6a-424b-9279-6054b50a743d",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/chats",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "chats"
              ]
            },
            "description": "Hesaba bağlı tüm sohbetleri döndürür.\n\n**Gerekli yetki:** `chats:read`\n\n**Yanıt kodları:** 200, 401, 403"
          },
          "response": []
        },
        {
          "name": "Telefondan sohbet bul",
          "id": "86e15571-c222-471f-9311-6c0f1dbf05cf",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/chats/resolve?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "chats",
                "resolve"
              ],
              "query": [
                {
                  "key": "phone",
                  "value": "905551234567",
                  "description": "Ülke kodlu telefon numarası. `+90 555 123 45 67`, `05551234567` ve `905551234567` aynı sonucu verir.",
                  "disabled": false
                }
              ]
            },
            "description": "Serbest formatlı bir telefon numarasını normalize ederek ilgili sohbeti bulur. Numara biçimi farklılıklarını (boşluk, +, 0 öneki) kendisi çözer.\n\n**Gerekli yetki:** `chats:read`\n\n**Yanıt kodları:** 200, 400, 404"
          },
          "response": []
        },
        {
          "name": "Sohbet mesajlarını getir",
          "id": "43d63e34-00cf-4681-bd13-ace3d3236f7e",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/chats/:chatId/messages?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "chats",
                ":chatId",
                "messages"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Döndürülecek mesaj sayısı.",
                  "disabled": true
                },
                {
                  "key": "before",
                  "value": "",
                  "description": "Bu zaman damgasından önceki mesajları getirir (ISO 8601). Sayfalama imleci.",
                  "disabled": true
                },
                {
                  "key": "include_raw",
                  "value": "true",
                  "description": "Ham sağlayıcı verisini yanıta ekler.",
                  "disabled": true
                },
                {
                  "key": "include_presigned_url",
                  "value": "true",
                  "description": "Medya mesajları için süreli indirme bağlantısı üretir.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "chatId",
                  "value": "905551234567@c.us",
                  "description": "Sohbet kimliği (örn. `905551234567@c.us`)."
                }
              ]
            },
            "description": "Bir sohbetin mesaj geçmişini en yeniden eskiye doğru döndürür. Sayfalama `before` imleci ile yapılır.\n\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200, 401, 403"
          },
          "response": []
        }
      ],
      "id": "5fe01c90-821c-402e-b487-3c08e532a66a"
    },
    {
      "name": "Messages",
      "description": "Metin mesajı gönderimi, kuyruk ve hız limiti durumu, içerik doğrulama.",
      "item": [
        {
          "name": "Metin mesajı gönder",
          "id": "f2d66b78-47bc-49e2-852d-fe0fc5611996",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": \"905551234567\",\n  \"message\": \"Merhaba, siparişiniz kargoya verildi.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/send",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "send"
              ]
            },
            "description": "Varsayılan olarak asenkron çalışır: mesaj kuyruğa alınır ve `202 Accepted` döner. Teslimat durumunu webhook üzerinden takip edin. `sync: true` ile yanıtı gönderim tamamlanana kadar bekletebilirsiniz — bu mod zaman aşımına (504) açıktır, toplu işlerde kullanmayın.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 202, 400, 429, 504"
          },
          "response": []
        },
        {
          "name": "Hız limiti durumu",
          "id": "dfa0599c-63e8-4cea-9280-20f237afb5fc",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/messages/rate-limit",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "rate-limit"
              ]
            },
            "description": "Hesabın anlık gönderim limiti ve kalan kotasını döndürür.\n\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Kuyruk durumu",
          "id": "0dbf078e-3dc7-46c1-8a8b-8d77b92d0594",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/messages/queue",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "queue"
              ]
            },
            "description": "Bekleyen, işlenen ve başarısız iş sayılarını döndürür. Toplu gönderim sırasında ilerlemeyi izlemek için kullanın.\n\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Mesaj içeriğini doğrula",
          "id": "08c46a33-3a44-46f4-a9b5-38d5d805c90c",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Kampanya metni burada\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/validate",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "validate"
              ]
            },
            "description": "Mesajı göndermeden önce içerik politikası ve uzunluk kontrolünden geçirir. Toplu gönderim öncesi ön kontrol için kullanışlıdır.\n\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200, 400"
          },
          "response": []
        }
      ],
      "id": "b7aa0bb8-1acb-4edc-8bd6-30489efff26b"
    },
    {
      "name": "Media",
      "description": "Görsel, doküman, ses, voice ve sticker gönderimi ile medya dosyalarına erişim.",
      "item": [
        {
          "name": "Medya gönder",
          "id": "a81b81b0-79a4-4f43-9530-81d27b4a7295",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": \"905551234567\",\n  \"media_url\": \"https://cdn.example.com/katalog.pdf\",\n  \"filename\": \"katalog.pdf\",\n  \"caption\": \"2026 ürün kataloğu\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/send-media",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "send-media"
              ]
            },
            "description": "Görsel, video, ses veya doküman gönderir. Medyayı üç yoldan biriyle verebilirsiniz: `media_url` (uzak dosya), `media_data` (base64) veya `multipart/form-data` içinde `file` alanı. `as_document`, `as_voice`, `as_sticker` bayrakları gönderim biçimini belirler.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 202, 400, 504"
          },
          "response": []
        },
        {
          "name": "Görsel gönder",
          "id": "d8dca14a-aef1-40d3-82a2-806248f4424c",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": \"905551234567\",\n  \"media_url\": \"https://cdn.example.com/gorsel.jpg\",\n  \"caption\": \"Yeni ürün\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/send-image",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "send-image"
              ]
            },
            "description": "`/messages/send-media` ile aynı gövdeyi alır; `media_type` otomatik olarak `image` atanır.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 202, 400"
          },
          "response": []
        },
        {
          "name": "Doküman gönder",
          "id": "84b80f7b-a044-4480-bc8c-082012239139",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": \"905551234567\",\n  \"media_url\": \"https://cdn.example.com/gorsel.jpg\",\n  \"caption\": \"Yeni ürün\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/send-document",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "send-document"
              ]
            },
            "description": "Dosyayı önizlemesiz doküman olarak gönderir (`as_document: true` kısayolu).\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 202, 400"
          },
          "response": []
        },
        {
          "name": "Ses dosyası gönder",
          "id": "4863ed53-7494-4654-a03a-8e499603ae94",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": \"905551234567\",\n  \"media_url\": \"https://cdn.example.com/gorsel.jpg\",\n  \"caption\": \"Yeni ürün\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/send-audio",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "send-audio"
              ]
            },
            "description": "Ses dosyasını müzik/ses eki olarak gönderir.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 202, 400"
          },
          "response": []
        },
        {
          "name": "Sesli mesaj (PTT) gönder",
          "id": "f54c3caa-d0fa-447a-8173-9095b27a60c3",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": \"905551234567\",\n  \"media_url\": \"https://cdn.example.com/gorsel.jpg\",\n  \"caption\": \"Yeni ürün\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/send-voice",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "send-voice"
              ]
            },
            "description": "Ses dosyasını WhatsApp sesli mesajı olarak gönderir (`as_voice: true` kısayolu). Kaynak dosya OGG/Opus değilse dönüştürülür.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 202, 400"
          },
          "response": []
        },
        {
          "name": "Sticker gönder",
          "id": "161b5a5a-0fac-4161-a881-b89c2785adf1",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": \"905551234567\",\n  \"media_url\": \"https://cdn.example.com/gorsel.jpg\",\n  \"caption\": \"Yeni ürün\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/send-sticker",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "send-sticker"
              ]
            },
            "description": "Görseli sticker olarak gönderir (`as_sticker: true` kısayolu).\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 202, 400"
          },
          "response": []
        },
        {
          "name": "Medya dosyasına eriş",
          "id": "4ff706a8-21e2-4bc7-b57c-44b430715172",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/media/:filename?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "media",
                ":filename"
              ],
              "query": [
                {
                  "key": "download",
                  "value": "",
                  "description": "`true` ise `Content-Disposition: attachment` ile döner.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "filename",
                  "value": "",
                  "description": ""
                }
              ]
            },
            "description": "Depolanan medya dosyasını döndürür. Varsayılan olarak tarayıcıda görüntülenir; `download=true` ile indirme başlığıyla servis edilir.\n\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200, 400, 404"
          },
          "response": []
        },
        {
          "name": "Mesajın medyasına eriş",
          "id": "f879b3bc-3b89-4f58-8e29-9f10ccb07159",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/messages/:messageId/media?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                ":messageId",
                "media"
              ],
              "query": [
                {
                  "key": "format",
                  "value": "json",
                  "description": "`json` ise dosya yerine meta veri döner.",
                  "disabled": true
                },
                {
                  "key": "download",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "inline",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "messageId",
                  "value": "",
                  "description": ""
                }
              ]
            },
            "description": "Bir mesaja ekli medyayı döndürür. `format=json` ile dosya yerine meta veri ve indirme bağlantısı alırsınız.\n\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        }
      ],
      "id": "f90a6412-4846-4060-87e7-78919cf6847a"
    },
    {
      "name": "Contacts",
      "description": "Kişi listeleme, detay, güncelleme, silme, WhatsApp numara kontrolü ve toplu senkron.",
      "item": [
        {
          "name": "Kişileri listele",
          "id": "3782bb7a-3d3f-4520-8ab4-86fd9ea5c1cd",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/contacts?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "contacts"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "search",
                  "value": "",
                  "description": "İsim veya telefonda arama.",
                  "disabled": true
                },
                {
                  "key": "tags",
                  "value": "",
                  "description": "Virgülle ayrılmış etiket adları.",
                  "disabled": true
                },
                {
                  "key": "is_whatsapp_user",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "sort_by",
                  "value": "last_message_at",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "sort_order",
                  "value": "desc",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Sayfalanmış kişi listesi döndürür. Arama, etiket ve WhatsApp kullanıcı durumuna göre filtrelenebilir.\n\n**Gerekli yetki:** `chats:read`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Kişi detayı",
          "id": "122afc6e-f3db-45e5-8aae-ca933d29355e",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/contacts/:phone",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "contacts",
                ":phone"
              ],
              "variable": [
                {
                  "key": "phone",
                  "value": "905551234567",
                  "description": "Ülke kodlu telefon numarası."
                }
              ]
            },
            "description": "Telefon numarasına göre kişi kaydını döndürür.\n\n**Gerekli yetki:** `chats:read`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Kişiyi güncelle",
          "id": "f4575234-b952-413c-8b48-47a5c4b0b362",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Ahmet Yılmaz\",\n  \"tags\": [\n    \"bayi\",\n    \"istanbul\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/contacts/:phone",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "contacts",
                ":phone"
              ],
              "variable": [
                {
                  "key": "phone",
                  "value": "905551234567",
                  "description": "Ülke kodlu telefon numarası."
                }
              ]
            },
            "description": "Kişinin adı, etiketleri, notu, özel alanları ve engel durumu güncellenir. Yalnızca gönderilen alanlar değişir.\n\n**Gerekli yetki:** `chats:read`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Kişiyi sil",
          "id": "0a839abe-ed3b-47b7-9df2-e3f4de00d993",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/contacts/:phone",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "contacts",
                ":phone"
              ],
              "variable": [
                {
                  "key": "phone",
                  "value": "905551234567",
                  "description": "Ülke kodlu telefon numarası."
                }
              ]
            },
            "description": "Kişi kaydını siler. Sohbet geçmişi silinmez.\n\n**Gerekli yetki:** `chats:read`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Numara WhatsApp'ta mı?",
          "id": "3d190d5f-90c9-47a7-9a8f-095aa155f3df",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/contacts/:phone/check",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "contacts",
                ":phone",
                "check"
              ],
              "variable": [
                {
                  "key": "phone",
                  "value": "905551234567",
                  "description": "Ülke kodlu telefon numarası."
                }
              ]
            },
            "description": "Numaranın WhatsApp'ta kayıtlı olup olmadığını canlı olarak sorgular. Hesabın bağlı (connected) olması gerekir.\n\n**Gerekli yetki:** `chats:read`\n\n**Yanıt kodları:** 200, 400"
          },
          "response": []
        },
        {
          "name": "Toplu kişi senkronu",
          "id": "bff0dd3b-71c4-4892-98d8-a7a97d2e03f7",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phones\": [\n    \"905551234567\",\n    \"905339876543\"\n  ],\n  \"update_existing\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/contacts/sync",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "contacts",
                "sync"
              ]
            },
            "description": "Numara listesini toplu olarak kontrol eder ve kişi kayıtlarını oluşturur/günceller. Tek çağrıda gönderilebilecek numara sayısı sınırlıdır; aşımda `too_many_phones` döner.\n\n**Gerekli yetki:** `chats:read`\n\n**Yanıt kodları:** 200, 400"
          },
          "response": []
        }
      ],
      "id": "487cc6a9-b6d0-4bfb-80cd-fd40c7a101c5"
    },
    {
      "name": "Groups & Tags",
      "description": "Grup ve etiket listeleme/oluşturma.",
      "item": [
        {
          "name": "Grupları listele",
          "id": "3fce2bf9-cf78-4be0-84b5-d1237cdaee07",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/groups",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "groups"
              ]
            },
            "description": "\n**Gerekli yetki:** `chats:read`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Grup oluştur",
          "id": "20037fc2-ee55-45e1-b5ae-22a793a17448",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Bayiler\",\n  \"color\": \"#25D366\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/groups",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "groups"
              ]
            },
            "description": "\n**Gerekli yetki:** `chats:write`\n\n**Yanıt kodları:** 201, 400"
          },
          "response": []
        },
        {
          "name": "Etiketleri listele",
          "id": "378fa7a5-ff3e-4daa-845f-fcb0aa622ddb",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/tags",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "tags"
              ]
            },
            "description": "\n**Gerekli yetki:** `chats:read`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Etiket oluştur",
          "id": "6e9ffd18-fe8b-4adf-87f2-b36d148455bf",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"sicak-lead\",\n  \"color\": \"#F59E0B\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/tags",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "tags"
              ]
            },
            "description": "\n**Gerekli yetki:** `chats:write`\n\n**Yanıt kodları:** 201"
          },
          "response": []
        }
      ],
      "id": "eaf1f46d-d56f-476d-bf4d-42b0dfcf89f4"
    },
    {
      "name": "Templates",
      "description": "Değişken destekli mesaj şablonlarının yönetimi ve şablonla gönderim.",
      "item": [
        {
          "name": "Şablonları listele",
          "id": "2408f7e9-306e-421f-bb77-774110d082dd",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/templates?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "templates"
              ],
              "query": [
                {
                  "key": "category",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "is_active",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "search",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Şablon oluştur",
          "id": "ad962ad6-f8a2-4c41-846d-c07955aa3e2f",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"kargo_bildirimi\",\n  \"content\": \"Merhaba {{ad}}, {{siparis_no}} numaralı siparişiniz kargoya verildi.\",\n  \"variables\": [\n    \"ad\",\n    \"siparis_no\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/templates",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "templates"
              ]
            },
            "description": "Şablon içeriğinde `{{degisken}}` biçiminde yer tutucular kullanılır; gönderim sırasında `variables` ile doldurulur.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 201, 400"
          },
          "response": []
        },
        {
          "name": "Şablon detayı",
          "id": "b7418e84-e79b-4436-843b-120521e525cb",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/templates/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "templates",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Şablonu güncelle",
          "id": "065f86a0-debd-4953-b290-b29278c300f7",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"is_active\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/templates/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "templates",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Şablonu sil",
          "id": "55a16118-567a-43ad-bfe3-8d6350d9c274",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/templates/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "templates",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Şablonla mesaj gönder",
          "id": "fba18f11-318a-405b-9bdc-bb62ac1294c3",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": \"905551234567\",\n  \"template_name\": \"kargo_bildirimi\",\n  \"variables\": {\n    \"ad\": \"Ahmet\",\n    \"siparis_no\": \"SP-10245\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/send-template",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "send-template"
              ]
            },
            "description": "Şablonu `template_id` veya `template_name` ile seçer, `variables` içindeki değerlerle doldurup gönderir.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 202, 400"
          },
          "response": []
        }
      ],
      "id": "638d56a9-7698-4b32-b105-9f56048c69cf"
    },
    {
      "name": "Scheduled",
      "description": "İleri tarihli mesaj planlama, listeleme, güncelleme ve iptal.",
      "item": [
        {
          "name": "Zamanlanmış mesajları listele",
          "id": "73e30526-c4e3-4196-928a-eb4200c25352",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/messages/scheduled?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "scheduled"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "pending",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "page",
                  "value": "1",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Zamanlanmış mesaj oluştur",
          "id": "9d14a6a9-343b-45ac-b7e3-97a4c737511d",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": \"905551234567\",\n  \"message\": \"Randevunuz yarın saat 14:00'te.\",\n  \"scheduled_at\": \"2026-08-01T11:00:00.000Z\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/schedule",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "schedule"
              ]
            },
            "description": "`scheduled_at` ISO 8601 biçiminde olmalıdır. Geçersiz tarihte `invalid_date` döner. Başarısız gönderimler `max_retries` kadar yeniden denenir.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 201, 400"
          },
          "response": []
        },
        {
          "name": "Zamanlanmış mesaj detayı",
          "id": "59c7e4d8-e1cf-4237-942f-74a01a3c6fa6",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/messages/scheduled/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "scheduled",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Zamanlanmış mesajı güncelle",
          "id": "9d9aa9f5-cac1-4d00-8e83-1a65978faa55",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"scheduled_at\": \"2026-08-02T09:00:00.000Z\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/scheduled/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "scheduled",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "Yalnızca henüz gönderilmemiş (`pending`) kayıtlar güncellenebilir.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Zamanlanmış mesajı iptal et",
          "id": "1038ed19-f062-421e-95b0-a4468073acc3",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/messages/scheduled/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "scheduled",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        }
      ],
      "id": "423e417c-8d5d-4bb7-9c98-38d405087aed"
    },
    {
      "name": "Auto Replies",
      "description": "Anahtar kelime, regex veya mesai saatine göre tetiklenen otomatik yanıt kuralları.",
      "item": [
        {
          "name": "Otomatik yanıtları listele",
          "id": "8522361a-c263-4c3a-9ebd-bae738ebd496",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/auto-replies?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "auto-replies"
              ],
              "query": [
                {
                  "key": "is_active",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "trigger_type",
                  "value": "keyword",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Otomatik yanıt oluştur",
          "id": "11c0a84e-3d4c-451d-b85c-0ce90498fd27",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Fiyat sorusu\",\n  \"trigger_type\": \"keyword\",\n  \"trigger_value\": \"fiyat\",\n  \"response_content\": \"Fiyat listemizi hemen paylaşıyorum.\",\n  \"delay_seconds\": 3\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/auto-replies",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "auto-replies"
              ]
            },
            "description": "Birden fazla kural eşleşirse `priority` değeri büyük olan kazanır. `delay_seconds` ile insan benzeri gecikme verebilirsiniz.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 201, 400"
          },
          "response": []
        },
        {
          "name": "Otomatik yanıt detayı",
          "id": "7eb656d0-9bd7-492e-a476-762d2b7df05b",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/auto-replies/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "auto-replies",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Otomatik yanıtı güncelle",
          "id": "659cc2e1-cb39-47d1-9e70-2aee38ab1354",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"is_active\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/auto-replies/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "auto-replies",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Otomatik yanıtı sil",
          "id": "ca673031-c15c-4ed1-b6b5-98307a2c0f8f",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/auto-replies/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "auto-replies",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        }
      ],
      "id": "41681067-33cb-4eb3-be73-f847432171f1"
    },
    {
      "name": "Broadcast",
      "description": "Çok alıcılı kampanya gönderimi, ilerleme takibi ve iptal.",
      "item": [
        {
          "name": "Toplu gönderimleri listele",
          "id": "ed95aa1e-0ff1-45fc-a75d-ab019478d564",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/broadcasts?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "broadcasts"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "page",
                  "value": "1",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "20",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Toplu mesaj gönder",
          "id": "61ebb72a-ebbf-4ba5-b52e-a2158f8e885c",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Ağustos kampanyası\",\n  \"message\": \"Ağustos'a özel %20 indirim!\",\n  \"phones\": [\n    \"905551234567\",\n    \"905339876543\"\n  ],\n  \"delay_between_messages\": 4000\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/messages/broadcast",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "messages",
                "broadcast"
              ]
            },
            "description": "Alıcıları `phones` dizisiyle ya da `recipient_filter` ile (etiket, arama vb.) belirtin — en az biri zorunludur. `delay_between_messages` gönderimler arası bekleme süresidir; hesabın engellenmemesi için düşük değer vermeyin.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 201, 400"
          },
          "response": []
        },
        {
          "name": "Kampanya detayı",
          "id": "f9af8180-8f05-44bc-aecc-7413c1076ffd",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/broadcasts/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "broadcasts",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "Kampanyanın ilerleme sayaçlarını (gönderilen, başarısız, bekleyen) içerir.\n\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Kampanyayı iptal et",
          "id": "b04a3022-8eeb-49e7-ac44-8db369694c21",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/broadcasts/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "broadcasts",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "Henüz gönderilmemiş alıcılar iptal edilir; gönderilmiş mesajlar geri alınamaz.\n\n**Gerekli yetki:** `messages:send`\n\n**Yanıt kodları:** 200, 404"
          },
          "response": []
        },
        {
          "name": "Kampanya alıcılarını listele",
          "id": "4a6de4bc-e9e2-4665-b086-5ee87f388f1f",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/broadcasts/:id/recipients?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "broadcasts",
                ":id",
                "recipients"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "pending",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "page",
                  "value": "1",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Kaynak kimliği (UUID)."
                }
              ]
            },
            "description": "\n**Gerekli yetki:** `messages:read`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        }
      ],
      "id": "013513d8-9096-41b7-9d48-7afa9d6f40aa"
    },
    {
      "name": "Webhooks",
      "description": "Gerçek zamanlı olay teslimatı için webhook URL yönetimi, test ve secret rotasyonu.",
      "item": [
        {
          "name": "Webhook ayarını getir",
          "id": "71ead510-b25c-44aa-a343-d6e3595aa50b",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/webhooks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "webhooks"
              ]
            },
            "description": "\n**Gerekli yetki:** `API anahtarı doğrulaması`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Webhook tanımla/güncelle",
          "id": "2cb79b29-b2eb-42c5-b269-6b937c097ed3",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://partner.example.com/zenwapp/webhook\",\n  \"events\": [\n    \"message.received\",\n    \"message.status\"\n  ],\n  \"timeout_seconds\": 30\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{base_url}}/webhooks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "webhooks"
              ]
            },
            "description": "Production ortamında webhook URL'i **HTTPS olmak zorundadır**. Geçersiz event adı gönderilirse istek reddedilir ve geçerli event listesi yanıtta döner.\n\n**Gerekli yetki:** `API anahtarı doğrulaması`\n\n**Yanıt kodları:** 200, 400"
          },
          "response": []
        },
        {
          "name": "Webhook'u devre dışı bırak",
          "id": "6ee47462-7b79-42ef-8175-17f85ed8f52d",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/webhooks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "webhooks"
              ]
            },
            "description": "\n**Gerekli yetki:** `API anahtarı doğrulaması`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Test olayı gönder",
          "id": "0a6b3101-33c0-433e-a7f4-ccf16b661127",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/webhooks/test",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "webhooks",
                "test"
              ]
            },
            "description": "Kayıtlı webhook URL'ine örnek bir olay gönderir. İmza doğrulama kurulumunuzu canlı trafikten önce sınamak için kullanın.\n\n**Gerekli yetki:** `API anahtarı doğrulaması`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        },
        {
          "name": "Secret'ı yenile",
          "id": "d1513f7b-011e-4dd6-a78e-ff25e6003a2d",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/webhooks/rotate-secret",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "webhooks",
                "rotate-secret"
              ]
            },
            "description": "İmzalama secret'ını yeniler ve yanıtta **yalnızca bir kez** döndürür. Yeni secret devreye girdiği anda eski imzalar geçersiz olur.\n\n**Gerekli yetki:** `API anahtarı doğrulaması`\n\n**Yanıt kodları:** 200"
          },
          "response": []
        }
      ],
      "id": "acfe6b0a-cb6d-4fdc-8a23-76946b0eb10a"
    }
  ]
}