WhatsApp mesajlarını bir Flowise chatflow ile yanıtlayın

Flowise'ın önünde neden bir aracıya ihtiyaç var?

Çünkü Meta'nın webhook'u ile Flowise'ın API'si farklı biçimlerde konuşur. Meta, bir hedefi hub.challenge değerini ham gövde olarak döndürmesi gereken bir GET ile doğrular, ardından her mesajı iç içe geçmiş bir JSON POST olarak iletir. Flowise'ın Prediction API'si ise /api/v1/prediction/ ve ardından akış kimliğinden oluşan adrese, question alanıyla bir POST bekler. İkisi de diğerine uyum sağlamaz, bu yüzden aralarında bir alıcı çeviri yapar.

Alıcı bir n8n Webhook düğümü, Python ya da Node'da bir rota veya herhangi bir serverless fonksiyon olabilir. Doğrulama GET'ini yanıtlar, webhook URL'sine konan uzun rastgele bir sırrı kontrol eder, Meta'ya hemen 200 döner ve işi ondan sonra yapar. URL'deki sır burada işe yarayan kimlik doğrulamadır: Meta teslimatları Tech Provider'ın uygulama sırrıyla imzalar ve bu sır hiç paylaşılmaz, bu yüzden X-Hub-Signature-256 başlığı sizin tarafınızda doğrulanamaz.

Alıcı Prediction API'yi nasıl çağırmalı?

Müşterinin metnini question olarak, müşterinin WhatsApp numarasını da oturum olarak vererek. Flowise her istekte overrideConfig kabul eder; içindeki sessionId, bellek düğümlerinin herkesi tek bir konuşmada karıştırmak yerine kişi başına ayrı bir konuşma tutmasını sağlar. Webhook payload'undaki gönderen numarası bunun için kararlı ve doğal bir anahtardır.

Chatflow bir API anahtarıyla korunuyorsa alıcı bunu bearer token olarak gönderir. Alıcı bir akışı birleştirecek şekilde yazılmadıysa streaming değerini false yapın; çünkü WhatsApp parça parça değil, bitmiş tek bir mesaj iletir.

Yanıt, aynı numaradan bir Cloud API metin mesajı olarak gider. Bu ücretsizdir ve müşterinin mesajının açtığı 24 saatlik pencere içinde serbesttir. Akışın sonradan göndermek istediği her şey, örneğin bir hatırlatma, onaylı bir şablon olmalıdır.

POST https://your-flowise-host/api/v1/prediction/<flow-id>
Authorization: Bearer <flowise-api-key>
Content-Type: application/json

{
  "question": "do you have anything friday?",
  "streaming": false,
  "overrideConfig": { "sessionId": "14155550188" }
}

Bir Flowise ajanı EasyCoexistence MCP sunucusunu kullanabilir mi?

Şu an hayır. Flowise'ın Custom MCP'si, bir Streamable HTTP sunucusuna URL ve bir dizi başlıkla bağlanır; bunlar genellikle bir Flowise değişkeninde tutulan statik bir bearer token'dır. EasyCoexistence MCP sunucusu ise OAuth ile doğrulama yapar: tarayıcıda oturum açılır ve token'ları kendisi verir, dolayısıyla bir başlığa konacak statik anahtar yoktur.

İşleyen ayrım, kararı akışın verip gönderimi alıcının yapmasıdır. Akış söylenecek metni, müşteri bir günden uzun süredir sessizse de bir şablonun adını döndürür; alıcı Cloud API çağrısını numaranın token'ıyla yapar. Böylece token hiçbir zaman Flowise'ın içinde durmaz ve 24 saat kuralı, unutabilecek bir modele bırakılmak yerine, kişinin en son ne zaman yazdığı kontrol edilerek kodda uygulanır.

Gelen mesajlar, gönderim hangi yolla yapılırsa yapılsın, yine yalnızca webhook üzerinden gelir.

Yaygın hatalar

• sessionId alanını atlamak. Bu durumda tüm müşteriler tek bir belleği paylaşır ve bir kişinin bilgileri başka birinin yanıtında görünebilir.
• Meta'ya yanıt vermeden önce Flowise'ı beklemek. Geç gelen 200 yeniden denenir ve aynı mesaj iki kez işlenir.
• Akışın bir gün sonra serbest metin göndermesine izin vermek. Pencerenin dışında Meta bunu 131047 kodlu hatayla reddeder.

Sık sorulan sorular

Okumaya devam edin