Günümüzde birçok iş süreci hâlâ faks kullanıyor. Sağlık, sigorta, lojistik, hukuk, finans ve arka ofis ekipleri; faturalar, sipariş formları, reçeteler ve imzalı belgeleri faks yoluyla alıyor. Ancak faks geldikten sonra belgelerin manuel olarak işlenmesi zaman alıcı ve hataya açık olabiliyor. Telnyx AI ve Python ile bu süreci otomatikleştirmek artık mümkün. Telnyx'in örnek projesi, gelen faks olaylarını alıp belge metnini yapılandırılmış JSON formatına dönüştüren bir uygulama sunuyor.
Proje, Flask tabanlı küçük bir API'den oluşuyor. API üzerinde `/webhooks/fax` ile faks olayları alınıyor, `/extract` ile belge metninden yapılandırılmış veri çıkarılıyor, `/faxes` ve `/extracted` ile kuyruktaki faks metadataları ve son çıkarım sonuçları listeleniyor. Ayrıca `/health` ile sağlık kontrolü yapılabiliyor. Çıkarım rotası faturalar, satın alma siparişleri, reçeteler ve otomatik algılanan belge türlerini destekliyor. AI çağrısı için `POST /v2/ai/chat/completions` uç noktası kullanılıyor.
Projeyi yerel ortamda çalıştırmak oldukça basit. GitHub deposu klonlandıktan sonra `.env` dosyasına Telnyx API anahtarı, genel anahtar, AI modeli ve host bilgileri giriliyor. Canlı faks göndermeden çıkarım uç noktasını test etmek için `curl` komutu ile doğrudan belge metni gönderilebiliyor. Örneğin, bir fatura metni gönderildiğinde AI, faturaya özgü JSON yapısı döndürüyor. `type: "auto"" kullanıldığında ise model belge türünü kendisi algılıyor.
Canlı faks işleme için `/webhooks/fax` rotası, Telnyx webhook imzasını doğrulayarak gelen `fax.received` olayını işliyor ve faks ID, gönderen, alıcı, sayfa sayısı gibi metadataları kuyruğa alıyor. Yerel test için ngrok ile uygulama dışa açılıp Telnyx Faks Uygulaması webhook URL'si ayarlanıyor. Üretim ortamına geçildiğinde, bellek içi durum yerine medya indirme, OCR, kalıcı depolama, şema doğrulama, yeniden deneme mekanizmaları ve insan onayı gibi geliştirmeler öneriliyor. Bu örnek proje, geliştiricilere faks işleme boru hattı oluştururken referans alabilecekleri kapsamlı bir kaynak sunuyor.
