Adım HTTP request, Chat Flows içinde

Bir Chat Flow, harici bir sisteme HTTPS üzerinden soru sorabilir ve yanıtı konuşmada kullanabilir: bir siparişi sorgulamak, bakiyeyi kontrol etmek, teslimat tarihini almak gibi. Adın adı HTTP request'tir (palet grubu Integrate) ve Bitrix24 içindeki WASync uygulamasının Chat Flows düzenleyicisinde bulunur.

Adımın yaptığı iş

1. İsteği adımın ayarlarından oluşturur: yöntem (GET veya POST), URL, başlıklar ve POST için bir gövde. Önceki adımlardan ve lead ya da deal kaydından gelen {{VARIABLES}} değerleri yerine konur: URL içinde URL-encoded, JSON gövdesinde JSON-escaped olarak.
2. İsteği gönderir ve yanıt için en fazla 10 saniye bekler.
3. JSON yanıtını response mapping ile akış değişkenlerine eşler: solda bir JSON yolu (data.order.status, items[0].id), sağda bir değişken adı (ESTADO). Sonraki adımlar bunları herhangi bir yanıt gibi kullanır: bir mesajda {{ESTADO}}, bir Branch içinde koşul, Fill in a field içinde değer.

Her çağrı ayrıca üç değişken belirler:

İki çıkış bağlantısı

Düğümün normal bir bağlantısı (başarı) ve kırmızı bir error bağlantısı vardır. Çağrı zaman aşımına uğradığında, URL reddedildiğinde, sistem 4xx veya 5xx ile yanıt verdiğinde ya da ağ başarısız olduğunda error bağlantısı izlenir. Error bağlantısı bağlı değilse akış, HTTP_OK = false ile normal bağlantıdan devam eder; böylece HTTP_OK üzerindeki bir Branch yine de tepki verebilir.

İsteğin yapıldığı yer

İstek WASync sunucularından yapılmaz. WASync'in iç sistemlerine erişimi olmayan, ayrı bir Cloudflare Worker (egress.wasync.app) tarafından yapılır. İki sonucu vardır:

• Çağrı sisteminize sabit bir WASync adresinden değil, Cloudflare'in IP aralıklarından ulaşır. API'niz yalnızca listelenmiş IP'lere izin veriyorsa bunun yerine bir API key veya imza kullanın; izin listesine eklenecek bir WASync IP'si yoktur.
• Yavaş veya hatalı bir API, WhatsApp mesajlarını asla geciktiremez ya da çoğaltamaz: çağrı mesaj hattının dışında çalışır ve akış, yanıt gelene veya zaman aşımı dolana kadar adımda bekler.

Adımın erişebildikleri

User agent her zaman WASync-Flows/1.0 (+https://wasync.app) değeridir.

Gizli bilgiler

Bir başlığı secret olarak işaretlerseniz (bir API key, bir bearer token) WASync onu şifreli saklar. Düzenleyicide bir daha gösterilmez, akışla birlikte dışa aktarılmaz, günlüklere ya da denetim kaydına yazılmaz. Değiştirmek için yeni bir değer girin; korumak için kaydederken alanı boş bırakın.

Kaydetmeden önce test edin

Adım panelindeki Test request, değişkenler için örnek değerlerle gerçek çağrıyı yapar ve durumu, geçen süreyi, eşlenen değişkenleri ve gövdeyi gösterir. Use as sample response bu gövdeyi adımda saklar: simülatör sistemi aramak yerine bunu kullanır, böylece tüm akış çevrimdışı önizlenebilir.

Örnek: sipariş durumu

• Question: "¿Cuál es tu número de pedido?" (PEDIDO olarak kaydedilir)
• HTTP request: GET https://erp.example.com/api/orders/{{PEDIDO}}, başlık X-Api-Key (secret), eşleme data.status → ESTADO, data.eta → ENTREGA
• HTTP_OK üzerinde Branch: true → Message Tu pedido está {{ESTADO}}, llega el {{ENTREGA}}. · false → Message No pude consultar tu pedido ahora, un asesor te escribe en breve. → Hand to a person

Bu sürümde olmayanlar

PUT, PATCH ve DELETE; harici sisteme yönelik OAuth; otomatik yeniden denemeler; dosya indirmeleri; sistemden bir geri çağrı (callback) beklemek. Bunlar için yardımcı tarifi kullanın: akış bir CRM alanına yazar, bir Bitrix24 otomasyon kuralı sisteminizi bilgilendirir, sisteminiz sonucu Bitrix24 REST API üzerinden geri yazar ve WASync: Send WhatsApp Message kuralı bunu gönderir.

Her çağrı çalışma alanının denetim kaydına işlenir (host ve yol, durum, süre, hangi değişkenlerin ayarlandığı; gövde ve başlıklar asla).