okulcom-api — Gelen Arama (Inbound Number) Sistemi

Proje: Okul Platform · Hub: Okul Platform — Domain

Inbound Number Nedir?

Her okul için ayrılan sanal telefon numaraları. Veli bu numarayı aradığında okula yönlendirilir ve otomatik lead oluşur.

Sağlayıcılar (InboundNumberProviderType)

Sağlayıcı	Endpoint
sonitel	188.166.11.215:5121
verimor	194.49.126.46:50601
foniva	Henüz desteklenmiyor (exception fırlatır)

Numara Durumları (InboundNumberStatusType)

• using — Bir okula tahsis edilmiş
• empty — Boşta, kullanılabilir
• okulcomtr — Okul.com’un kendi kullanımı için ayrılmış (note kolonuna bakınız)

İlgili Modeller

• InboundNumberPool — Telefon numaraları havuzu
• SchoolInboundCallLog — Okula gelen arama kayıtları

Önceki migration: 2026_01_26_100421_delete_old_inbound_number_pool_types.php — Eski tip değerleri silindi

B2B’de Kullanımı

Her okul bir inbound numaraya sahip olabilir. Arama geldiğinde Sonitel webhook’u tetikler → POST /webhooks/sonitel/inbound-call. Lead otomatik oluşur (entry_method: call, status: created_via_inbound).

Call Center

• Config::SONITEL_CALL_AGENT_INFO_TYPE_KEY = 'sonitel_call_agent_info' — Çağrı merkezi ajan bilgileri
• Config::CALL_AGENTS_KEY = 'call_agents'
• Admin: POST /admin/call/b2b/forward + POST /admin/call/b2b/hangup

Müşteri İletişim Tipleri (ContactType)

Okul için birden fazla iletişim tipi var:

• telephone (3) — Sabit telefon
• inbound_number (7) — Sanal inbound numara
• notify_gsm (9) — Lead bildirim GSM
• whatsapp (12) — WhatsApp
• notify_email (10), notify_email_cc (11) — Lead e-posta bildirimi

SchoolContact Modeli

school_id + contact_type_id + value kombinasyonu.

Related

• api-key-integrations — Sonitel entegrasyon detayları
• api-lead-pool-system — Gelen arama → Lead akışı