{"id":34069,"date":"2025-11-10T16:31:15","date_gmt":"2025-11-10T13:31:15","guid":{"rendered":"https:\/\/fatihsoysal.com\/blog\/python-ile-go-high-level-entegrasyonu-api-gucunu-kesfedin\/"},"modified":"2025-11-10T16:31:15","modified_gmt":"2025-11-10T13:31:15","slug":"python-ile-go-high-level-entegrasyonu-api-gucunu-kesfedin","status":"publish","type":"post","link":"https:\/\/fatihsoysal.com\/blog\/python-ile-go-high-level-entegrasyonu-api-gucunu-kesfedin\/","title":{"rendered":"Python ile Go High Level Entegrasyonu: API G\u00fcc\u00fcn\u00fc Ke\u015ffedin"},"content":{"rendered":"

<\/p>\n

Dijital pazarlama ve m\u00fc\u015fteri ili\u015fkileri y\u00f6netimi d\u00fcnyas\u0131nda Go High Level (GHL), ajanslar ve i\u015fletmeler i\u00e7in vazge\u00e7ilmez bir ara\u00e7 haline gelmi\u015ftir. Bu kapsaml\u0131 platform; CRM, sat\u0131\u015f hunileri, e-posta pazarlamas\u0131, SMS kampanyalar\u0131 ve daha bir\u00e7ok \u00f6zelli\u011fi tek bir \u00e7at\u0131 alt\u0131nda sunar. Ancak, her ne kadar g\u00fc\u00e7l\u00fc olursa olsun, standart \u00f6zellikler bazen i\u015fletmenizin \u00f6zel ihtiya\u00e7lar\u0131n\u0131 tam olarak kar\u015f\u0131layamayabilir. \u0130\u015fte tam da bu noktada, Python’\u0131n esnekli\u011fi ve Go High Level API’sinin g\u00fcc\u00fc devreye giriyor. Bu makalede, GHL’nin yeteneklerini Python ile nas\u0131l geni\u015fletebilece\u011finizi, otomasyonlar\u0131n\u0131z\u0131 nas\u0131l bir \u00fcst seviyeye ta\u015f\u0131yabilece\u011finizi ve i\u015f s\u00fcre\u00e7lerinizi nas\u0131l optimize edebilece\u011finizi ad\u0131m ad\u0131m inceleyece\u011fiz. Bu sayede, GHL’den maksimum verimi alarak rekabet avantaj\u0131 elde edebilirsiniz.<\/p>\n

G\u00fcn\u00fcm\u00fcz\u00fcn h\u0131zla de\u011fi\u015fen pazar\u0131nda, i\u015fletmelerin \u00e7evik ve uyarlanabilir olmas\u0131 kritik \u00f6neme sahiptir. Go High Level gibi hepsi bir arada pazarlama platformlar\u0131, bu \u00e7evikli\u011fi sa\u011flamak i\u00e7in harika bir ba\u015flang\u0131\u00e7 noktas\u0131d\u0131r. Ancak her i\u015fletmenin kendine \u00f6zg\u00fc operasyonlar\u0131, mevcut sistemleri ve m\u00fc\u015fteri etkile\u015fim stratejileri vard\u0131r. \u00d6rne\u011fin, \u00f6zel bir e-ticaret sitenizden gelen sipari\u015f verilerini do\u011frudan GHL’deki bir potansiyel m\u00fc\u015fteri kayd\u0131na ba\u011flamak isteyebilir veya harici bir anket arac\u0131ndan toplanan verileri belirli bir i\u015f ak\u0131\u015f\u0131n\u0131 tetiklemek i\u00e7in kullanman\u0131z gerekebilir. GHL’nin dahili otomasyonlar\u0131 bu t\u00fcr senaryolar\u0131n \u00e7o\u011funu kapsasa da, bazen daha derin entegrasyonlar, karma\u015f\u0131k veri manip\u00fclasyonlar\u0131 veya \u00e7oklu sistemler aras\u0131 k\u00f6pr\u00fcler kurma ihtiyac\u0131 do\u011far. Python, programlama kolayl\u0131\u011f\u0131, geni\u015f k\u00fct\u00fcphane ekosistemi ve g\u00fc\u00e7l\u00fc API etkile\u015fim yetenekleri sayesinde bu bo\u015flu\u011fu doldurmak i\u00e7in ideal bir dildir. Bu entegrasyonlar sayesinde, manuel veri giri\u015fini azaltabilir, hatalar\u0131 minimize edebilir ve en \u00f6nemlisi, m\u00fc\u015fterilerinize daha ki\u015fiselle\u015ftirilmi\u015f ve tutarl\u0131 bir deneyim sunabilirsiniz. Dolay\u0131s\u0131yla, GHL’nin sundu\u011fu temel otomasyonlar\u0131n \u00f6tesine ge\u00e7erek tamamen size \u00f6zel \u00e7\u00f6z\u00fcmler yaratmak art\u0131k hayal de\u011fil, Python ile ula\u015f\u0131labilir bir ger\u00e7ekliktir.<\/p>\n

Temel Kavramlar: Go High Level API’si ve Python’\u0131n G\u00fcc\u00fc Nereden Geliyor?<\/h2>\n

Go High Level (GHL) API’si ile Python entegrasyonlar\u0131n\u0131n derinliklerine dalmadan \u00f6nce, bu iki temel bile\u015fenin ne oldu\u011funu ve neden bu kadar g\u00fc\u00e7l\u00fc bir ikili olu\u015fturduklar\u0131n\u0131 anlamak \u00f6nemlidir. GHL, ajanslar ve i\u015fletmeler i\u00e7in \u00f6zel olarak tasarlanm\u0131\u015f, pazarlama ve sat\u0131\u015f s\u00fcre\u00e7lerini tek bir platformda birle\u015ftiren kapsaml\u0131 bir yaz\u0131l\u0131md\u0131r. \u0130\u00e7erisinde CRM, kampanya y\u00f6netimi, randevu planlay\u0131c\u0131, web sitesi ve a\u00e7\u0131l\u0131\u015f sayfas\u0131 olu\u015fturucu gibi bir\u00e7ok ara\u00e7 bar\u0131nd\u0131r\u0131r. Bu platformun sundu\u011fu temel \u00f6zellikler zaten olduk\u00e7a etkileyici olsa da, API (Uygulama Programlama Aray\u00fcz\u00fc) sayesinde GHL’nin kap\u0131lar\u0131 d\u0131\u015f d\u00fcnyaya a\u00e7\u0131l\u0131r. API, farkl\u0131 yaz\u0131l\u0131mlar\u0131n birbiriyle g\u00fcvenli ve yap\u0131land\u0131r\u0131lm\u0131\u015f bir \u015fekilde ileti\u015fim kurmas\u0131n\u0131 sa\u011flayan bir dizi kural ve protokoller b\u00fct\u00fcn\u00fcd\u00fcr. GHL API’si, platformdaki verilere (m\u00fc\u015fteriler, f\u0131rsatlar, kampanyalar vb.) programatik olarak eri\u015fmenizi ve \u00fczerinde i\u015flemler yapman\u0131z\u0131 sa\u011flar.<\/p>\n

Peki, bu noktada neden Python? Python, basit s\u00f6zdizimi, okunabilirli\u011fi ve \u00e7ok y\u00f6nl\u00fcl\u00fc\u011f\u00fc ile bilinen pop\u00fcler bir programlama dilidir. \u00d6zellikle veri i\u015fleme, otomasyon ve web geli\u015ftirme alanlar\u0131ndaki g\u00fc\u00e7l\u00fc k\u00fct\u00fcphaneleri (\u00f6rne\u011fin, requests<\/code>, pandas<\/code>) sayesinde API entegrasyonlar\u0131 i\u00e7in m\u00fckemmel bir se\u00e7enektir. GHL API’si genellikle RESTful prensiplere uygun olarak tasarlanm\u0131\u015ft\u0131r; bu da HTTP metotlar\u0131n\u0131 (GET, POST, PUT, DELETE) kullanarak kaynaklara eri\u015fildi\u011fi anlam\u0131na gelir. Python’\u0131n requests<\/code> k\u00fct\u00fcphanesi, bu HTTP isteklerini olduk\u00e7a kolay bir \u015fekilde yapmam\u0131z\u0131 sa\u011flar. Ayr\u0131ca, Python’\u0131n geni\u015f geli\u015ftirici toplulu\u011fu ve zengin dok\u00fcmantasyonu, kar\u015f\u0131la\u015fabilece\u011finiz herhangi bir sorun i\u00e7in h\u0131zl\u0131 \u00e7\u00f6z\u00fcmler bulman\u0131za yard\u0131mc\u0131 olur. Bu sinerji sayesinde, GHL’de yap\u0131lamayan \u00f6zel raporlamalar\u0131 Python ile olu\u015fturabilir, mevcut CRM’inizdeki m\u00fc\u015fteri verilerini otomatik olarak GHL’ye aktarabilir veya GHL i\u00e7indeki bir olay tetiklendi\u011finde harici bir sistemde otomatik bir eylem ba\u015flatabilirsiniz. K\u0131sacas\u0131, Python, GHL’nin sadece bir pazarlama otomasyon arac\u0131 olmaktan \u00e7\u0131k\u0131p, i\u015fletmenizin t\u00fcm ekosistemiyle b\u00fct\u00fcnle\u015fen merkezi bir operasyonel g\u00fc\u00e7 merkezine d\u00f6n\u00fc\u015fmesini sa\u011flar.<\/p>\n

Python Ortam\u0131n\u0131z\u0131 Haz\u0131rlama ve \u0130lk API \u00c7a\u011fr\u0131n\u0131z\u0131 Yapma: Go High Level Entegrasyonuna Giri\u015f<\/h2>\n

Go High Level ile Python aras\u0131nda k\u00f6pr\u00fc kurmaya ba\u015flamak i\u00e7in \u00f6ncelikle d\u00fczg\u00fcn bir geli\u015ftirme ortam\u0131 olu\u015fturman\u0131z gerekir. Bu, sorunsuz bir entegrasyon deneyiminin temelini olu\u015fturur. \u0130lk ad\u0131m, bilgisayar\u0131n\u0131zda Python’\u0131n kurulu oldu\u011fundan emin olmakt\u0131r. Python’\u0131 resmi web sitesinden<\/a> indirebilir ve kurabilirsiniz. Genellikle Python 3.x versiyonlar\u0131 tercih edilir.<\/p>\n

Python’\u0131 kurduktan sonra, projeleriniz i\u00e7in sanal ortamlar (virtual environments) kullanmak iyi bir pratiktir. Sanal ortamlar, her projenin kendi ba\u011f\u0131ms\u0131z paket k\u00fcmelerine sahip olmas\u0131n\u0131 sa\u011flayarak ba\u011f\u0131ml\u0131l\u0131k \u00e7ak\u0131\u015fmalar\u0131n\u0131 \u00f6nler. Sanal ortam olu\u015fturmak ve etkinle\u015ftirmek i\u00e7in \u015fu komutlar\u0131 kullanabilirsiniz:<\/p>\n

\npython3 -m venv ghl_entegrasyonu\nsource ghl_entegrasyonu\/bin\/activate  # macOS\/Linux\nghl_entegrasyonu\\Scripts\\activate  # Windows\n    <\/pre>\n
<\/code><\/p>\n
Sanal ortam\u0131n\u0131z etkinle\u015ftirildikten sonra, GHL API'si ile ileti\u015fim kurmak i\u00e7in ihtiya\u00e7 duyaca\u011f\u0131n\u0131z temel k\u00fct\u00fcphane olan requests<\/code>'\u0131 y\u00fcklemeniz gerekir:<\/p>\n
\npip install requests\n    <\/pre>\n
<\/code><\/p>\n
\u015eimdi GHL API anahtar\u0131n\u0131z\u0131 edinme zaman\u0131. Bu anahtar, Python beti\u011finizin GHL hesab\u0131n\u0131za g\u00fcvenli bir \u015fekilde eri\u015fmesini sa\u011flar. GHL paneline giri\u015f yap\u0131n, sa\u011f \u00fcst k\u00f6\u015fedeki profilinize t\u0131klay\u0131n ve \"API Keys\" veya \"Settings\" alt\u0131nda bu anahtar\u0131 bulabilirsiniz. Anahtar\u0131n\u0131z\u0131 not al\u0131n, \u00e7\u00fcnk\u00fc her API iste\u011finde kimlik do\u011frulama i\u00e7in kullan\u0131lacakt\u0131r. Anahtar\u0131n\u0131z\u0131 asla do\u011frudan kod i\u00e7ine yazmak yerine, ortam de\u011fi\u015fkenleri (environment variables) kullanarak veya bir yap\u0131land\u0131rma dosyas\u0131nda g\u00fcvenli bir \u015fekilde saklamak en iyi uygulamad\u0131r.<\/p>\n
Art\u0131k ilk API \u00e7a\u011fr\u0131n\u0131z\u0131 yapmaya haz\u0131rs\u0131n\u0131z. GHL'deki t\u00fcm lokasyonlar\u0131 listeleyen bir GET iste\u011fi ile ba\u015flayabiliriz. Bu, API'nin nas\u0131l \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 anlamak i\u00e7in harika bir yoldur. A\u015fa\u011f\u0131daki Python kodu, GHL API'sine basit bir GET iste\u011fi g\u00f6ndermeyi g\u00f6stermektedir:<\/p>\n
\nimport requests\nimport os\n\n# GHL API anahtar\u0131n\u0131z\u0131 ortam de\u011fi\u015fkeninden al\u0131n veya g\u00fcvenli bir \u015fekilde yap\u0131land\u0131r\u0131n\nGHL_API_KEY = os.getenv(\"GHL_API_KEY\", \"YOUR_GHL_API_KEY_HERE\") # G\u00fcvenlik i\u00e7in ortam de\u011fi\u015fkeni kullan\u0131n!\nBASE_URL = \"https:\/\/rest.gohighlevel.com\/v1\" # GHL API'sinin temel URL'si\n\nheaders = {\n    \"Authorization\": f\"Bearer {GHL_API_KEY}\",\n    \"Accept\": \"application\/json\"\n}\n\ntry:\n    response = requests.get(f\"{BASE_URL}\/locations\", headers=headers)\n    response.raise_for_status() # HTTP hatalar\u0131n\u0131 yakala (4xx veya 5xx)\n\n    locations = response.json()\n    print(\"Go High Level Lokasyonlar\u0131:\")\n    for location in locations.get('locations', []):\n        print(f\"- ID: {location.get('id')}, Ad\u0131: {location.get('name')}\")\n\nexcept requests.exceptions.HTTPError as errh:\n    print(f\"HTTP Hatas\u0131: {errh}\")\nexcept requests.exceptions.ConnectionError as errc:\n    print(f\"Ba\u011flant\u0131 Hatas\u0131: {errc}\")\nexcept requests.exceptions.Timeout as errt:\n    print(f\"Zaman A\u015f\u0131m\u0131 Hatas\u0131: {errt}\")\nexcept requests.exceptions.RequestException as err:\n    print(f\"Bir Hata Olu\u015ftu: {err}\")\n    <\/pre>\n
<\/code><\/p>\n
Bu kod blo\u011fu, requests<\/code> k\u00fct\u00fcphanesini kullanarak GHL API'sine nas\u0131l istek g\u00f6nderebilece\u011finizi g\u00f6stermektedir. Authorization<\/code> ba\u015fl\u0131\u011f\u0131nda API anahtar\u0131n\u0131z\u0131 \"Bearer\" token olarak ge\u00e7irdi\u011fimize dikkat edin. response.raise_for_status()<\/code> \u00e7a\u011fr\u0131s\u0131, 4xx (istemci hatas\u0131) veya 5xx (sunucu hatas\u0131) durum kodlar\u0131na sahip bir yan\u0131t al\u0131nmas\u0131 durumunda bir istisna (exception) f\u0131rlatarak hata y\u00f6netimini kolayla\u015ft\u0131r\u0131r. B\u00f6ylece, API ile ba\u015far\u0131yla ileti\u015fim kurabildi\u011finizden ve verileri alabildi\u011finizden emin olabilirsiniz. Bu ilk ad\u0131m\u0131 tamamlad\u0131\u011f\u0131n\u0131zda, GHL API'si ile daha karma\u015f\u0131k entegrasyonlar geli\u015ftirmeye haz\u0131rs\u0131n\u0131z demektir.<\/p>\n
Vaka Analizi 1: Otomatik M\u00fc\u015fteri Verisi Senkronizasyonu ile Potansiyellerinizi H\u0131zland\u0131r\u0131n<\/h2>\n
Go High Level'\u0131n en temel ve g\u00fc\u00e7l\u00fc \u00f6zelliklerinden biri, potansiyel m\u00fc\u015fteri (lead) y\u00f6netimidir. Ancak, bir\u00e7ok i\u015fletme, potansiyel m\u00fc\u015fterileri farkl\u0131 kaynaklardan (\u00f6zel web siteleri, \u00fc\u00e7\u00fcnc\u00fc parti CRM'ler, \u00e7evrimd\u0131\u015f\u0131 formlar vb.) toplar. Bu verileri manuel olarak GHL'ye aktarmak zaman al\u0131c\u0131, hataya a\u00e7\u0131k ve verimsiz bir s\u00fcre\u00e7tir. Python ile GHL API entegrasyonu sayesinde, bu s\u00fcreci tamamen otomatikle\u015ftirebilir, yeni potansiyel m\u00fc\u015fterilerinizi an\u0131nda GHL'ye ta\u015f\u0131yarak sat\u0131\u015f ekibinizin h\u0131zla harekete ge\u00e7mesini sa\u011flayabilirsiniz. Bu vaka analizinde, harici bir kaynaktan gelen m\u00fc\u015fteri verilerini Python kullanarak GHL'ye nas\u0131l aktaraca\u011f\u0131m\u0131z\u0131 inceleyece\u011fiz.<\/p>\n
Senaryo:<\/strong> Bir e-ticaret \u015firketi, web sitesindeki \u00f6zel bir \"indirim talebi\" formundan veya bir i\u015f orta\u011f\u0131n\u0131n veri taban\u0131ndan yeni potansiyel m\u00fc\u015fteriler topluyor. Bu potansiyel m\u00fc\u015fterilerin GHL'ye otomatik olarak eklenmesi ve belirli bir \"\u0130ndirim Talebi \u0130\u015f Ak\u0131\u015f\u0131\"na (Discount Request Workflow) dahil edilmesi gerekmektedir. B\u00f6ylece GHL, bu potansiyel m\u00fc\u015fterilere otomatik e-posta serileri g\u00f6nderebilir veya sat\u0131\u015f ekibine bir g\u00f6rev atayabilir.<\/p>\n
Uygulama Ad\u0131mlar\u0131:<\/strong><\/p>\n
    \n
  1. Veri Haz\u0131rl\u0131\u011f\u0131:<\/strong> Harici kaynaktan gelen m\u00fc\u015fteri verilerini Python'\u0131n anlayabilece\u011fi bir yap\u0131ya (\u00f6rne\u011fin, bir s\u00f6zl\u00fck veya JSON format\u0131) d\u00f6n\u00fc\u015ft\u00fcr\u00fcn. GHL, yeni bir ileti\u015fim (contact) olu\u015fturmak i\u00e7in ad, soyad, e-posta, telefon gibi temel bilgileri bekler.<\/li>\n
  2. GHL API Endpoint'ini Belirleme:<\/strong> GHL API d\u00f6k\u00fcmantasyonunda ileti\u015fim olu\u015fturma (Create Contact) i\u00e7in kullan\u0131lan POST endpoint'ini bulun. Genellikle bu \/contacts<\/code> veya \/contacts\/upsert<\/code> gibi bir yoldad\u0131r.<\/li>\n
  3. POST \u0130ste\u011fi G\u00f6nderme:<\/strong> Python'\u0131n requests<\/code> k\u00fct\u00fcphanesini kullanarak haz\u0131rlad\u0131\u011f\u0131n\u0131z m\u00fc\u015fteri verilerini GHL API'sine bir POST iste\u011fi olarak g\u00f6nderin.<\/li>\n
  4. Yan\u0131t\u0131 \u0130\u015fleme:<\/strong> API'den gelen yan\u0131t\u0131 kontrol edin. Ba\u015far\u0131l\u0131 bir yan\u0131tta, yeni olu\u015fturulan ileti\u015fimin ID'si gibi bilgiler yer alacakt\u0131r. Hatalar\u0131 yakalamak ve uygun \u015fekilde y\u00f6netmek \u00f6nemlidir.<\/li>\n<\/ol>\n
    \nimport requests\nimport os\nimport json\n\nGHL_API_KEY = os.getenv(\"GHL_API_KEY\", \"YOUR_GHL_API_KEY_HERE\")\nLOCATION_ID = os.getenv(\"GHL_LOCATION_ID\", \"YOUR_LOCATION_ID_HERE\") # Hangi lokasyona eklenecekse o ID'yi girin\nBASE_URL = \"https:\/\/rest.gohighlevel.com\/v1\"\n\nheaders = {\n    \"Authorization\": f\"Bearer {GHL_API_KEY}\",\n    \"Content-Type\": \"application\/json\",\n    \"Accept\": \"application\/json\"\n}\n\ndef create_ghl_contact(first_name, last_name, email, phone, tags=None):\n    \"\"\"\n    Go High Level'da yeni bir ileti\u015fim (contact) olu\u015fturur veya g\u00fcnceller (upsert).\n    \"\"\"\n    contact_data = {\n        \"firstName\": first_name,\n        \"lastName\": last_name,\n        \"email\": email,\n        \"phone\": phone,\n        \"locationId\": LOCATION_ID,\n        \"tags\": tags if tags else []\n    }\n\n    try:\n        response = requests.post(f\"{BASE_URL}\/contacts\/upsert\", headers=headers, data=json.dumps(contact_data))\n        response.raise_for_status()\n        result = response.json()\n        print(f\"\u0130leti\u015fim ba\u015far\u0131yla olu\u015fturuldu\/g\u00fcncellendi: {result.get('contact', {}).get('id')}\")\n        return result.get('contact', {}).get('id')\n    except requests.exceptions.HTTPError as errh:\n        print(f\"HTTP Hatas\u0131: {errh.response.status_code} - {errh.response.text}\")\n    except requests.exceptions.RequestException as err:\n        print(f\"Bir Hata Olu\u015ftu: {err}\")\n    return None\n\n# --- \u00d6rnek Kullan\u0131m ---\n# Harici bir sistemden gelen \u00f6rnek m\u00fc\u015fteri verisi\nnew_lead_data = {\n    \"ad\": \"Ay\u015fe\",\n    \"soyad\": \"Y\u0131lmaz\",\n    \"eposta\": \"ayse.yilmaz@example.com\",\n    \"telefon\": \"+905321234567\"\n}\n\n# GHL'de ileti\u015fim olu\u015fturma\ncontact_id = create_ghl_contact(\n    new_lead_data[\"ad\"],\n    new_lead_data[\"soyad\"],\n    new_lead_data[\"eposta\"],\n    new_lead_data[\"telefon\"],\n    tags=[\"\u0130ndirim Talebi\", \"Web Form\"]\n)\n\nif contact_id:\n    print(f\"Yeni ileti\u015fim olu\u015fturuldu, ID: {contact_id}. \u015eimdi GHL'deki i\u015f ak\u0131\u015f\u0131na eklenebilir.\")\n    # Burada isterseniz contact_id ile bu ileti\u015fimi bir i\u015f ak\u0131\u015f\u0131na ekleme i\u015flemini yapabilirsiniz.\n    <\/pre>\n
    <\/code><\/p>\n
    \n        Uzman \u0130pucu: \/contacts\/upsert<\/code> endpoint'i, mevcut bir e-posta veya telefon numaras\u0131yla e\u015fle\u015fen bir ileti\u015fim varsa onu g\u00fcnceller, yoksa yeni bir tane olu\u015fturur. Bu, yinelenen kay\u0131tlar\u0131 \u00f6nlemek i\u00e7in \u00e7ok kullan\u0131\u015fl\u0131d\u0131r. API anahtar\u0131n\u0131z ve lokasyon ID'niz gibi hassas bilgileri do\u011frudan koda yazmak yerine, os.getenv()<\/code> gibi y\u00f6ntemlerle ortam de\u011fi\u015fkenlerinden alman\u0131z\u0131 \u015fiddetle tavsiye ederiz. Bu, uygulaman\u0131z\u0131n g\u00fcvenli\u011fini art\u0131r\u0131r ve farkl\u0131 ortamlarda (geli\u015ftirme, \u00fcretim) kolayca yap\u0131land\u0131rma yapman\u0131z\u0131 sa\u011flar.\n    <\/div>\n
    Bu entegrasyon sayesinde, e-ticaret \u015firketi yeni potansiyel m\u00fc\u015fterileri an\u0131nda GHL'ye senkronize edebilir. Sat\u0131\u015f ekibi, manuel m\u00fcdahaleye gerek kalmadan yeni indirim taleplerine h\u0131zl\u0131ca yan\u0131t verebilir, bu da m\u00fc\u015fteri memnuniyetini art\u0131r\u0131r ve d\u00f6n\u00fc\u015f\u00fcm oranlar\u0131n\u0131 y\u00fckseltir. Benzer \u015fekilde, emlak acenteleri yeni ev listeleme taleplerini, e\u011fitim kurumlar\u0131 ise yeni \u00f6\u011frenci kay\u0131tlar\u0131n\u0131 GHL'ye otomatik olarak aktarabilirler.<\/p>\n
    Vaka Analizi 2: \u00d6zel \u0130\u015f Ak\u0131\u015flar\u0131 ve Otomasyonlar\u0131 Python ile Ak\u0131ll\u0131ca Tetikleyin<\/h2>\n
    Go High Level, dahili i\u015f ak\u0131\u015flar\u0131 (workflows) ve otomasyon ara\u00e7lar\u0131 ile olduk\u00e7a g\u00fc\u00e7l\u00fcd\u00fcr. Ancak baz\u0131 senaryolarda, bu otomasyonlar\u0131 tetikleyecek olaylar GHL d\u0131\u015f\u0131ndaki sistemlerde meydana gelebilir. \u00d6rne\u011fin, bir \u00f6deme a\u011f ge\u00e7idinden gelen \"\u00f6deme ba\u015far\u0131l\u0131\" bildirimi, harici bir anket platformundaki \"anket tamamland\u0131\" durumu veya \u00f6zel bir IoT cihaz\u0131ndan gelen bir tetikleyici, GHL i\u00e7inde belirli bir i\u015f ak\u0131\u015f\u0131n\u0131 ba\u015flatman\u0131z\u0131 gerektirebilir. Python, bu harici olaylar\u0131 dinleyip GHL API'si arac\u0131l\u0131\u011f\u0131yla ilgili i\u015f ak\u0131\u015flar\u0131n\u0131 tetikleyerek, otomasyonlar\u0131n\u0131z\u0131 mevcut teknoloji y\u0131\u011f\u0131n\u0131n\u0131za sorunsuz bir \u015fekilde entegre etmenizi sa\u011flar.<\/p>\n
    Senaryo:<\/strong> Bir e\u011fitim kurumu, \u00f6\u011frencilerin kurs kay\u0131tlar\u0131n\u0131 kendi \u00f6zel \u00f6\u011frenci y\u00f6netim sistemi (\u00d6YS) \u00fczerinden yap\u0131yor. \u00d6\u011frenci bir kursa ba\u015far\u0131yla kaydoldu\u011funda, bu \u00f6\u011frencinin GHL'deki \"Kurs Kay\u0131t Tamamland\u0131\" i\u015f ak\u0131\u015f\u0131na eklenmesi gerekmektedir. Bu i\u015f ak\u0131\u015f\u0131, \u00f6\u011frenciye ho\u015f geldin e-postas\u0131 g\u00f6nderecek, bir kurs ba\u015flang\u0131\u00e7 materyalleri paketi sa\u011flayacak ve \u00f6\u011frenciyi \u00f6zel bir \"Kurs \u00d6\u011frencileri\" segmentine ekleyecektir.<\/p>\n
    Uygulama Ad\u0131mlar\u0131:<\/strong><\/p>\n
      \n
    1. GHL \u0130\u015f Ak\u0131\u015f\u0131 ID'sini Belirleme:<\/strong> GHL panelinizde, tetiklemek istedi\u011finiz i\u015f ak\u0131\u015f\u0131n\u0131n (\u00f6rne\u011fin, \"Kurs Kay\u0131t Tamamland\u0131\") ID'sini bulun. Bu ID genellikle i\u015f ak\u0131\u015f\u0131n\u0131n URL'sinde yer al\u0131r veya API dok\u00fcmantasyonunda belirtilir.<\/li>\n
    2. Mevcut \u0130leti\u015fimi veya Yeni \u0130leti\u015fimi Haz\u0131rlama:<\/strong> E\u011fer \u00f6\u011frenci zaten GHL'de bir ileti\u015fim olarak mevcutsa, onun contactId<\/code> de\u011ferine ihtiyac\u0131n\u0131z olacak. E\u011fer yoksa, \u00f6nceki vaka analizinde g\u00f6sterildi\u011fi gibi yeni bir ileti\u015fim olu\u015fturman\u0131z gerekecektir.<\/li>\n
    3. API Endpoint'i Kullanma:<\/strong> GHL API'sinde, bir ileti\u015fimi belirli bir i\u015f ak\u0131\u015f\u0131na eklemek i\u00e7in kullan\u0131lan endpoint'i (genellikle \/workflows\/{workflowId}\/execute<\/code> veya \/contacts\/{contactId}\/addToWorkflow<\/code> benzeri bir yap\u0131) kullan\u0131n.<\/li>\n
    4. POST \u0130ste\u011fi G\u00f6nderme:<\/strong> Python ile contactId<\/code> ve workflowId<\/code> bilgilerini i\u00e7eren bir POST iste\u011fi g\u00f6ndererek i\u015f ak\u0131\u015f\u0131n\u0131 tetikleyin.<\/li>\n<\/ol>\n
      \nimport requests\nimport os\nimport json\n\nGHL_API_KEY = os.getenv(\"GHL_API_KEY\", \"YOUR_GHL_API_KEY_HERE\")\nBASE_URL = \"https:\/\/rest.gohighlevel.com\/v1\"\nLOCATION_ID = os.getenv(\"GHL_LOCATION_ID\", \"YOUR_LOCATION_ID_HERE\")\n\nheaders = {\n    \"Authorization\": f\"Bearer {GHL_API_KEY}\",\n    \"Content-Type\": \"application\/json\",\n    \"Accept\": \"application\/json\"\n}\n\ndef add_contact_to_workflow(contact_id, workflow_id):\n    \"\"\"\n    Belirtilen ileti\u015fimi Go High Level'daki bir i\u015f ak\u0131\u015f\u0131na ekler.\n    \"\"\"\n    payload = {\n        \"contactId\": contact_id\n    }\n    \n    try:\n        response = requests.post(f\"{BASE_URL}\/workflows\/{workflow_id}\/execute\", headers=headers, data=json.dumps(payload))\n        response.raise_for_status()\n        print(f\"\u0130leti\u015fim {contact_id} ba\u015far\u0131yla {workflow_id} i\u015f ak\u0131\u015f\u0131na eklendi.\")\n        return True\n    except requests.exceptions.HTTPError as errh:\n        print(f\"HTTP Hatas\u0131: {errh.response.status_code} - {errh.response.text}\")\n    except requests.exceptions.RequestException as err:\n        print(f\"Bir Hata Olu\u015ftu: {err}\")\n    return False\n\n# --- \u00d6rnek Kullan\u0131m ---\n# Bu b\u00f6l\u00fcm genellikle bir \u00d6YS'den veya ba\u015fka bir harici sistemden tetiklenir.\n# Diyelim ki, \u00d6YS'de yeni bir \u00f6\u011frenci kursa kaydoldu.\nogrenci_eposta = \"yeni.ogrenci@egitimkurumu.com\"\nkurs_workflow_id = \"your_course_workflow_id_here\" # GHL'deki \"Kurs Kay\u0131t Tamamland\u0131\" i\u015f ak\u0131\u015f\u0131n\u0131n ID'si\n\n# \u0130lk olarak \u00f6\u011frencinin GHL'de bir ileti\u015fim olarak mevcut olup olmad\u0131\u011f\u0131n\u0131 kontrol edin\n# veya create_ghl_contact fonksiyonu ile yeni bir tane olu\u015fturun (\u00f6nceki vaka analizinden)\n# Basitlik i\u00e7in burada varsay\u0131lan bir contact_id kullan\u0131yoruz.\n# Ger\u00e7ek senaryoda bu contact_id'yi ya bir arama ile almal\u0131 ya da yeni olu\u015fturmal\u0131s\u0131n\u0131z.\ncontact_id_from_ghl = \"your_existing_contact_id_here\" # \u00d6rnek: 'cnt_abcdef123456'\n\nif contact_id_from_ghl:\n    success = add_contact_to_workflow(contact_id_from_ghl, kurs_workflow_id)\n    if success:\n        print(f\"\u00d6\u011frenci {ogrenci_eposta} i\u00e7in kurs kay\u0131t otomasyonu ba\u015far\u0131yla ba\u015flat\u0131ld\u0131.\")\nelse:\n    print(f\"\u00d6\u011frenci {ogrenci_eposta} i\u00e7in GHL'de bir ileti\u015fim bulunamad\u0131 veya olu\u015fturulamad\u0131.\")\n    <\/pre>\n
      <\/code><\/p>\n
      \n        Uzman \u0130pucu: Bu otomasyonu daha g\u00fc\u00e7l\u00fc hale getirmek i\u00e7in Python beti\u011finizi bir webhook veya API Gateway arkas\u0131na yerle\u015ftirebilirsiniz. Bu sayede, harici sistem (\u00d6YS gibi) bir olay tetikledi\u011finde (\u00f6rn. \u00f6\u011frenci kayd\u0131), do\u011frudan bu Python beti\u011fine bir HTTP POST iste\u011fi g\u00f6ndererek GHL entegrasyonunu ger\u00e7ek zamanl\u0131 olarak ba\u015flatabilir. Bu y\u00f6ntem, anl\u0131k senkronizasyon ve daha dinamik otomasyonlar sa\u011flar.\n    <\/div>\n
      Bu entegrasyon sayesinde e\u011fitim kurumu, \u00f6\u011frenci kay\u0131t s\u00fcre\u00e7lerini tamamen otomatikle\u015ftirebilir. \u00d6\u011frenciler, kay\u0131t olur olmaz ilgili ho\u015f geldin materyallerini al\u0131r ve GHL'deki ileti\u015fim bilgileri g\u00fcncel kal\u0131r. Bu t\u00fcr otomasyonlar, sadece zamandan tasarruf etmekle kalmaz, ayn\u0131 zamanda insan hatas\u0131n\u0131 azalt\u0131r ve tutarl\u0131 bir m\u00fc\u015fteri\/\u00f6\u011frenci deneyimi sunar. Perakende sekt\u00f6r\u00fcnde, belirli bir \u00fcr\u00fcn kategorisini sat\u0131n alan m\u00fc\u015fterileri \u00f6zel bir \"sadakat program\u0131\" i\u015f ak\u0131\u015f\u0131na eklemek veya finans sekt\u00f6r\u00fcnde, belirli bir hizmete kaydolan m\u00fc\u015fterileri \"dan\u0131\u015fmanl\u0131k takibi\" i\u015f ak\u0131\u015f\u0131na dahil etmek gibi say\u0131s\u0131z senaryo bu yakla\u015f\u0131mla uygulanabilir.<\/p>\n
      \u0130leri D\u00fczey Teknikler ve Performans \u0130pu\u00e7lar\u0131: GHL Entegrasyonunuzu Bir \u00dcst Seviyeye Ta\u015f\u0131y\u0131n<\/h2>\n
      Go High Level API'si ile Python entegrasyonlar\u0131n\u0131z\u0131 temel seviyenin \u00f6tesine ta\u015f\u0131mak, daha sa\u011flam, verimli ve g\u00fcvenilir sistemler olu\u015fturman\u0131z\u0131 sa\u011flar. Bu b\u00f6l\u00fcmde, daha deneyimli kullan\u0131c\u0131lar i\u00e7in \u00f6nemli ileri d\u00fczey teknikleri ve performans ipu\u00e7lar\u0131n\u0131 ele alaca\u011f\u0131z. Bu teknikler, b\u00fcy\u00fck veri setleriyle \u00e7al\u0131\u015f\u0131rken, API k\u0131s\u0131tlamalar\u0131n\u0131 y\u00f6netirken ve olas\u0131 sorunlara kar\u015f\u0131 entegrasyonunuzu g\u00fc\u00e7lendirirken kritik \u00f6neme sahiptir.<\/p>\n
      Hata Y\u00f6netimi ve \u0130stisna \u0130\u015fleme Nas\u0131l Yap\u0131l\u0131r?<\/h3>\n
      Herhangi bir API entegrasyonunda, hatalar\u0131n ka\u00e7\u0131n\u0131lmaz oldu\u011funu kabul etmek ve bunlar\u0131 uygun \u015fekilde ele almak \u00e7ok \u00f6nemlidir. A\u011f sorunlar\u0131, ge\u00e7ersiz veri giri\u015fleri veya API taraf\u0131ndaki k\u0131s\u0131tlamalar gibi bir\u00e7ok durum hataya yol a\u00e7abilir. Python'da try-except<\/code> bloklar\u0131 ve requests<\/code> k\u00fct\u00fcphanesinin sa\u011flad\u0131\u011f\u0131 \u00f6zel istisnalar (\u00f6rn. requests.exceptions.HTTPError<\/code>, ConnectionError<\/code>, Timeout<\/code>), bu hatalar\u0131 yakalamak ve kullan\u0131c\u0131ya veya g\u00fcnl\u00fcklere anlaml\u0131 mesajlar sa\u011flamak i\u00e7in kullan\u0131l\u0131r. API'den gelen HTTP durum kodlar\u0131n\u0131 (\u00f6rn. 400 Bad Request, 401 Unauthorized, 404 Not Found, 429 Too Many Requests, 500 Internal Server Error) kontrol etmek ve bunlara g\u00f6re farkl\u0131 eylemler ger\u00e7ekle\u015ftirmek, entegrasyonunuzun dayan\u0131kl\u0131l\u0131\u011f\u0131n\u0131 art\u0131r\u0131r.<\/p>\n
      B\u00fcy\u00fck Veri Setlerini Sayfalama (Pagination) ile Nas\u0131l Y\u00f6netirsiniz?<\/h3>\n
      Go High Level gibi platformlar, binlerce hatta on binlerce ileti\u015fim veya f\u0131rsat kayd\u0131na sahip olabilir. API'ler genellikle tek bir yan\u0131tta d\u00f6nd\u00fcr\u00fclen kay\u0131t say\u0131s\u0131n\u0131 s\u0131n\u0131rlar (\u00f6rn. 100 veya 500 kay\u0131t). B\u00fcy\u00fck veri setlerini \u00e7ekerken t\u00fcm veriye eri\u015fmek i\u00e7in sayfalama (pagination) mekanizmas\u0131n\u0131 kullanman\u0131z gerekir. Bu, bir d\u00f6ng\u00fc i\u00e7inde ard\u0131\u015f\u0131k API istekleri yaparak verinin tamam\u0131n\u0131 sayfa sayfa \u00e7ekmek anlam\u0131na gelir. GHL API'si genellikle yan\u0131tlar\u0131nda bir sonraki sayfa i\u00e7in bir i\u015faret\u00e7i (next_page_url<\/code> veya offset<\/code>\/limit<\/code> parametreleri) sa\u011flar. Bu mekanizmay\u0131 do\u011fru bir \u015fekilde uygulamak, t\u00fcm veriye eri\u015fiminizi garanti eder ve API'nin a\u015f\u0131r\u0131 y\u00fcklenmesini \u00f6nler.<\/p>\n
      API H\u0131z S\u0131n\u0131rlamalar\u0131 (Rate Limiting) Nas\u0131l A\u015f\u0131l\u0131r?<\/h3>\n
      API sa\u011flay\u0131c\u0131lar\u0131, sunucular\u0131n\u0131 k\u00f6t\u00fcye kullan\u0131mdan korumak ve t\u00fcm kullan\u0131c\u0131lara adil eri\u015fim sa\u011flamak i\u00e7in h\u0131z s\u0131n\u0131rlamalar\u0131 uygular. GHL API'si de belirli bir zaman diliminde yapabilece\u011finiz istek say\u0131s\u0131na bir s\u0131n\u0131r koyar. Bu s\u0131n\u0131rlara \u00e7arpmamak i\u00e7in entegrasyonlar\u0131n\u0131zda gecikmeler (delays) kullanman\u0131z veya istekler aras\u0131nda belirli bir s\u00fcre beklemeniz gerekebilir. time.sleep()<\/code> fonksiyonu, basit bir gecikme mekanizmas\u0131 sunar. Daha geli\u015fmi\u015f yakla\u015f\u0131mlar, API yan\u0131tlar\u0131ndaki RateLimit-Remaining<\/code> ve RateLimit-Reset<\/code> HTTP ba\u015fl\u0131klar\u0131n\u0131 okuyarak kalan istek say\u0131s\u0131n\u0131 ve s\u0131f\u0131rlanma zaman\u0131n\u0131 takip etmek ve buna g\u00f6re ak\u0131ll\u0131ca beklemektir.<\/p>\n
      \nimport time\nimport requests # ... di\u011fer import'lar\n\n# ... headers ve BASE_URL tan\u0131mlamalar\u0131 ...\n\ndef make_ghl_request_with_rate_limit(method, url, **kwargs):\n    \"\"\"\n    H\u0131z s\u0131n\u0131rlamalar\u0131n\u0131 g\u00f6z \u00f6n\u00fcnde bulundurarak GHL API iste\u011fi yapar.\n    \"\"\"\n    max_retries = 3\n    for attempt in range(max_retries):\n        response = requests.request(method, url, headers=headers, **kwargs)\n        if response.status_code == 429: # Too Many Requests\n            retry_after = int(response.headers.get(\"Retry-After\", 1)) # Genellikle saniye cinsinden\n            print(f\"H\u0131z s\u0131n\u0131rlamas\u0131na ula\u015f\u0131ld\u0131. {retry_after} saniye bekleniyor...\")\n            time.sleep(retry_after + 1) # Biraz daha fazla bekleyin\n        elif response.status_code >= 400:\n            response.raise_for_status() # Di\u011fer HTTP hatalar\u0131n\u0131 f\u0131rlat\n        else:\n            return response\n    raise requests.exceptions.RequestException(\"API h\u0131z s\u0131n\u0131rlamas\u0131n\u0131 a\u015ft\u0131ktan sonra maksimum deneme say\u0131s\u0131na ula\u015f\u0131ld\u0131.\")\n\n# \u00d6rnek kullan\u0131m:\n# response = make_ghl_request_with_rate_limit(\"GET\", f\"{BASE_URL}\/locations\")\n    <\/pre>\n
      <\/code><\/p>\n
      \n        Uzman \u0130pucu: \u00c7ok say\u0131da API iste\u011fi yapman\u0131z gerekti\u011finde, istekleri toplu halde (batch) g\u00f6nderme imkan\u0131 sunan endpoint'ler olup olmad\u0131\u011f\u0131n\u0131 kontrol edin. GHL API'sinde bu t\u00fcr bir \u00f6zellik yoksa, kendi Python kodunuzda verileri par\u00e7alara ay\u0131rarak ve her par\u00e7ay\u0131 ayr\u0131 ayr\u0131 ancak h\u0131z s\u0131n\u0131rlamalar\u0131n\u0131 a\u015fmadan g\u00f6nderecek mant\u0131klar geli\u015ftirebilirsiniz. Bu, toplam istek say\u0131s\u0131n\u0131 ve dolay\u0131s\u0131yla bekleme s\u00fcresini optimize etmenize yard\u0131mc\u0131 olur.\n    <\/div>\n
      Webhooks vs. Polling: Hangi Durumda Hangisi Kullan\u0131lmal\u0131?<\/h3>\n
      Ger\u00e7ek zamanl\u0131 entegrasyonlar i\u00e7in iki ana yakla\u015f\u0131m vard\u0131r: polling (sorgulama) ve webhooks. Polling, Python beti\u011finizin d\u00fczenli aral\u0131klarla (\u00f6rne\u011fin, her 5 dakikada bir) GHL API'sini sorgulayarak de\u011fi\u015fiklikleri kontrol etmesidir. Bu y\u00f6ntem basittir ancak gecikme yaratabilir ve gereksiz API isteklerine neden olabilir. Webhooks ise GHL'nin belirli bir olay (\u00f6rne\u011fin, yeni bir ileti\u015fim olu\u015fturuldu\u011funda veya bir f\u0131rsat durumu de\u011fi\u015fti\u011finde) meydana geldi\u011finde Python beti\u011finizin belirledi\u011fi bir URL'ye otomatik olarak bir bildirim (HTTP POST iste\u011fi) g\u00f6ndermesini sa\u011flar. Webhooks, ger\u00e7ek zamanl\u0131 entegrasyonlar i\u00e7in \u00e7ok daha verimli ve idealdir. Python beti\u011finizin bir web sunucusu (\u00f6rn. Flask veya FastAPI ile) olarak \u00e7al\u0131\u015fmas\u0131 ve gelen webhook bildirimlerini i\u015flemek \u00fczere bir endpoint sa\u011flamas\u0131 gerekir. Bu, anl\u0131k tepki verme yetene\u011fi kazand\u0131r\u0131r.<\/p>\n
      Mobil Uyumluluk ve Performans Optimizasyonu<\/h3>\n
      API entegrasyonlar\u0131n\u0131z\u0131n do\u011frudan mobil uygulamalarla etkile\u015fimi genellikle backend sunucular\u0131n\u0131z \u00fczerinden ger\u00e7ekle\u015fir. Yani, mobil uygulama do\u011frudan GHL API'sini \u00e7a\u011f\u0131rmak yerine, kendi backend API'nizi \u00e7a\u011f\u0131r\u0131r ve bu backend API, Python betiklerinizle GHL API'si aras\u0131nda k\u00f6pr\u00fc g\u00f6revi g\u00f6r\u00fcr. Bu yakla\u015f\u0131m, g\u00fcvenlik, h\u0131z s\u0131n\u0131rlamas\u0131 y\u00f6netimi ve veri d\u00f6n\u00fc\u015f\u00fcm\u00fc gibi konularda size tam kontrol sa\u011flar. GHL'nin kendi mobil uygulamalar\u0131 ve mobil uyumlu web aray\u00fczleri, API entegrasyonlar\u0131n\u0131zla ekledi\u011finiz veya g\u00fcncelledi\u011finiz verileri otomatik olarak mobil cihazlarda da tutarl\u0131 bir \u015fekilde g\u00f6sterir. Performans optimizasyonu a\u00e7\u0131s\u0131ndan, API isteklerinizi minimumda tutmak, yaln\u0131zca ihtiyac\u0131n\u0131z olan verileri \u00e7ekmek (filtreleme ve alan se\u00e7imi kullanarak) ve yan\u0131tlar\u0131 \u00f6nbelle\u011fe almak (caching) gibi teknikler, hem Python beti\u011finizin hem de genel GHL deneyiminin h\u0131z\u0131n\u0131 art\u0131r\u0131r. GHL i\u00e7indeki sayfalar\u0131n veya formlar\u0131n mobil uyumlulu\u011fu i\u00e7in, GHL'nin dahili ara\u00e7lar\u0131 responsive tasar\u0131m prensiplerine uygun yap\u0131lar sunar. E\u011fer kendi \u00f6zel HTML'inizi kullan\u0131yorsan\u0131z, a\u015fa\u011f\u0131daki gibi temel bir mobil uyumluluk i\u00e7in CSS media query \u00f6rne\u011fi ekleyebilirsiniz:<\/p>\n
      \n