Skip to main content
Bu rehber, belirli bir hastaya bir mesaj göndermek için izlenecek yolu anlatır. Akış hem WhatsApp hem Telegram için aynıdır — kanal türünü Flextell conversation’a göre seçer.
Gerekli scope: conversations:write (medya için ek olarak files:write gerekebilir). Hastaya yeni bir görüşme açmak için bir kanal oluşturulmuş olmalıdır — Entegrasyonlar sayfasına bakın.

1. Hastanın görüşmesini bul veya oluştur

Hasta daha önce size yazdıysa bir conversation mevcuttur:
Eşleşme yoksa ve ilk mesajı siz atacaksanız:
Telegram’da ilk mesajı siz atamazsınız. Hasta önce botunuzu /start ile başlatmalı. Detay için Telegram entegrasyonu sayfasına bakın.

2. Metin mesajı gönder

Yanıt

Mesajın son teslim durumu için GET /v1/conversations/58/messages/{id} ile tekrar sorgulayabilirsiniz.

3. Medya gönder

Multipart istek ve dosya sınırları için Dosya Yükleme sayfasına bakın.

4. Hastanın yanıtını bekle

Hastanın cevabını anlık almak için chat-log.{tenantId} kanalına abone olun:
Realtime yerine polling tercih ederseniz:

5. Okundu olarak işaretle

Hasta yazdığı mesajı okuyan kullanıcı (panel veya otomasyon) tarafında okundu işaretlemek için:
Bu, diğer dinleyen istemcilere ConversationRead event’i yayar.

Yaygın hatalar

İpuçları

  • Çok kanallı bildirim — Bir hasta iki kanaldan da size yazdıysa iki ayrı conversation olur. Bildirimi hastanın son aktif kanalına göndermek iyi bir varsayılandır.
  • Mesajın “gönderim başarısız” halistatus: failed geldi ise kanal sağlayıcısı (WhatsApp/Telegram) tarafından reddedildi demektir. Paneldeki konuşmada detay not olarak görünebilir.
  • Çift gönderim engelleme — Butona birden fazla tıklanmasını engelleyin; detay için Idempotency.