Make Entegrasyonu

API anahtarınla bir bağlantı (connection) oluştur

Make’te Purvisor’a özel bir uygulama olmadığı için kimlik doğrulamayı HTTP modülünün içinde tanımlarsın. İki yol var:

• API Key Auth bağlantısı (önerilen): HTTP modülünde yeni bir API key bağlantısı oluştur — anahtar adı X-API-Key, değeri senin pk_live_... anahtarın olsun. Böylece anahtarı senaryolara gömmeden tekrar tekrar kullanırsın.
• Doğrudan header: Her HTTP modülüne elle bir başlık ekle → X-API-Key: pk_live_...

Purvisor üç kimlik yöntemi kabul eder: X-API-Key (birincil), Authorization: Bearer pk_live_... ve ?api_key=... sorgu parametresi. Make için en temizi X-API-Key başlığıdır.

Bağlantıyı test etmek için bir HTTP modülüyle GET https://app.purvisor.ai/api/v1/me çağır. 200 ve { "id": "...", "email": "...", "name": "..." } dönerse anahtar geçerlidir. 401 {"error":"invalid_api_key"} → anahtar yanlış/eksik.

📸 [Ekran görüntüsü: Make HTTP modülü — API Key Auth bağlantısı, anahtar adı X-API-Key]

Kontak oluştur — POST /contacts

Senaryoya bir HTTP → Make a request modülü ekle:

Gövde (alan adları snake_case veya camelCase olabilir):

{
  "first_name": "Ayşe",
  "last_name": "Yılmaz",
  "phone": "+905551234567",
  "email": "ayse@ornek.com",
  "company": "Örnek A.Ş."
}

• Zorunlu: first_name (veya name) ve phone (en az 10 hane).
• Dedupe: Aynı telefon (tam eşleşme veya son 10 hane) zaten varsa yeni kayıt açılmaz — mevcut kontak existing: true ile ve HTTP 200 döner. Yeni kayıt → HTTP 201, existing: false, source: "zapier".
• Yanıt gövdesi: { id, first_name, last_name, name, phone, email, company, title, status, stage, lead_score, heat, source, created_at, existing }. Sonraki modüller için id alanını eşle (map et).

Ayrıntılı alan listesi ve arama (GET /contacts?phone= / ?search=): Kontaklar.

AI araması başlat — POST /calls

Kontak hazır olunca ikinci bir HTTP modülüyle aramayı tetikle:

POST https://app.purvisor.ai/api/v1/calls
X-API-Key: pk_live_...
Content-Type: application/json
 
{
  "phone": "+905551234567",
  "assistant_id": "asst_...",
  "first_name": "Ayşe"
}

Başarılı → HTTP 201 { call_id, status: "initiated", contact_id, assistant_id, from_number, to }.

Asistan ve numara kimliklerini GET /api/v1/assistants ve GET /api/v1/phone-numbers çağrılarıyla (Hesap & Lookup’lar) senaryonun başında bir kez çekip saklayabilirsin.

Anlık tetikleyici kur — Make webhook’unu POST /hooks ile abone et

Purvisor’ın olay olunca seni çağırması için önce Make’te bir hedef URL üret, sonra o URL’i Purvisor’a abone et.

1. Make’te yeni bir senaryo aç, ilk modül olarak Webhooks → Custom webhook ekle. Make sana benzersiz bir URL verir (ör. https://hook.eu2.make.com/xxxxxxxx). Bu, olayların geleceği adrestir.
2. Bir HTTP modülü (veya curl) ile bu URL’i Purvisor’a abone et:

curl -X POST https://app.purvisor.ai/api/v1/hooks \
  -H "X-API-Key: pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "event": "call.completed",
    "targetUrl": "https://hook.eu2.make.com/xxxxxxxx",
    "source": "make"
  }'

Yanıt → HTTP 201 { id, event, targetUrl, secret }.

Artık her call.completed olayında Purvisor senin Make webhook’una şu zarfı POST eder:

{
  "event": "call.completed",
  "timestamp": "2026-07-12T14:03:00.000Z",
  "data": {
    "callId": "...",
    "phoneNumber": "+905551234567",
    "direction": "outbound",
    "durationSeconds": 92,
    "outcome": "...",
    "sentiment": "positive",
    "summary": "...",
    "contactId": "..."
  }
}

İstek başlıkları: X-Purvisor-Event: call.completed ve X-Purvisor-Signature (gövdenin HMAC-SHA256 imzası). İmzayı senaryonda mutlaka doğrula — bkz. İmza Doğrulama.

📸 [Ekran görüntüsü: Make Custom webhook modülü — hedef URL + gelen call.completed veri yapısı]

İmzayı doğrula ve devam et

Gelen isteğin gerçekten Purvisor’dan geldiğini kanıtlamak için: X-Purvisor-Signature başlığını, aboneliğin secret’ı ile ham gövdenin HMAC-SHA256 (hex) özetiyle karşılaştır. Eşleşmiyorsa isteği yok say (Make’te bir Filter ile durdur). Tam algoritma ve örnek kod: İmza Doğrulama.

İmza geçerliyse data içindeki summary, sentiment, outcome gibi alanları bir sonraki modüle (Google Sheets satırı, Slack mesajı, CRM güncellemesi) eşleyerek senaryonu tamamla.