Webhook

Nereden: Ayarlar → Entegrasyonlar → Webhook → Webhook (CRM) → Bağla

Görüşme sonuçlarını, ayarlanan toplantıları ve aranmak istemeyen kişileri kendi sisteminize (CRM, Zapier, Make, n8n…) anlık olarak gönderin.

Başlamadan önce

• İnternetten https:// ile erişilebilen ve POST isteği kabul eden bir adres.
• Kendi sunucunuzsa, gelen isteğin imzasını doğrulayacak küçük bir kod (örnek aşağıda).

Adım adım

1. Adresinizi girin, göndermek istediğiniz olayları seçip kaydedin.
2. Ekranda bir kez gösterilen imza anahtarını (whsec_…) kopyalayıp güvenli bir yerde saklayın.
3. Test et ile adresinize bir ping olayı gönderilir; 2xx yanıt dönerse bağlantı çalışıyor demektir.
4. Her istek JSON gövdesiyle gelir: id, event (ör. call.finalized), created_at ve data. Başlıklarda X-Arar-Event, X-Arar-Event-Id, X-Arar-Timestamp ve X-Arar-Signature bulunur.
5. İmzayı doğrulayın: X-Arar-Signature = v1= + HMAC-SHA256(anahtar, X-Arar-Timestamp + "." + ham gövde). 5 dakikadan eski istekleri reddedin.

İmza doğrulama örneği (PHP)

$body = file_get_contents('php://input');
$timestamp = (int) $_SERVER['HTTP_X_ARAR_TIMESTAMP'];
$expected = 'v1=' . hash_hmac('sha256', $timestamp . '.' . $body, $secret);

if (! hash_equals($expected, $_SERVER['HTTP_X_ARAR_SIGNATURE'] ?? '') || abs(time() - $timestamp) > 300) {
    http_response_code(401);
    exit;
}

$event = json_decode($body, true); // ['id' => …, 'event' => 'call.finalized', 'data' => […]]

Sorun yaşarsanız

• Zaman aşımı, 429 ve 5xx yanıtlarında istek otomatik olarak yeniden denenir; aynı X-Arar-Event-Id tekrar gelebilir, tekrarları bu kimlikle ayıklayın.
• Yönlendirmeler (3xx) izlenmez; adres doğrudan isteği karşılayan son adres olmalıdır.
• Anahtarı kaybettiyseniz kartta Anahtarı yenile'ye basın; eski anahtar hemen geçersiz olur.

Olayların içeriği ve alanları için geliştirici rehberindeki Webhook olayları makalesine bakın.