Mesajlaşma (Messaging) node'ları

Bu rehberde: WhatsApp, Telegram, Slack, Discord, Messenger, SMS ve e-posta ile mesaj gönderen, toplu kampanya yapan ve konuşmayı insana devreden kutuları öğrenirsiniz. WhatsApp'ın 24 saat kuralı da burada.

⏱ 12 dakika

Kısaca#

Mesajlaşma kutuları bağlı kanallarınıza yazar. Gelen mesajları yakalamak için Mesaj geldi tetikleyicisi kullanılır. Bir kutu, mesaj sağlayıcı tarafından kabul edildiğinde başarılı sayılır.

Teknik ayrıntılar#

Bu node'lar bağlı mesajlaşma kanallarına yazar: WhatsApp, Telegram, Slack, Discord, Messenger, SMS ve e-posta. Gelen mesajlar için trigger.messageReceived kullanılır (Tetikleyiciler). Gönderimler messaging kuyruğuna alınır; node, kuyruğa yazıldığında değil, sağlayıcı kabul ettiğinde başarılı sayılır.

Send message (messaging.send)#

Tek alıcıya mesaj gönderir. Konuşma (Conversation) kaydı varsa mesaj oraya eklenir ve message.sent olayı yayınlanır.

Çıktı: item + messageId, externalMessageId, sentAt, channel. Hatada error handle'ı: { error: { code, message, retryable } }.

WhatsApp 24 saat kuralı#

Müşteri son 24 saat içinde yazmadıysa serbest metin gönderilemez (hata 131047). Bu durumda templateName (WhatsApp Manager'da onaylı şablon) ve templateParams zorunludur; text yok sayılır. Node, konuşma penceresini bilir: pencere açıksa text, kapalıysa şablon kullanır; şablon tanımlı değilse INVALID döner. Ayrıntı: WhatsApp şablonları ve 24 saat penceresi.

Örnek 1 – chatbot yanıtı (şablondan): channel {{ $json.channel }} (tetikleyiciden gelen kanal), to {{ $json.contactId }}, text {{ $json.reply }}.

Örnek 2 – WhatsApp randevu hatırlatması: channel WHATSAPP, to {{ $json.phone }}, templateName appointment_reminder, templateParams ["{{ $json.name }}", "{{ $date($json.appointmentAt, "DD.MM.YYYY HH:mm") }}"].

Örnek 3 – Slack'e rapor: channel SLACK, to C0123ABCD, text "*{{ $json.title }}*\n{{ $json.summary }}".

Send email (messaging.sendEmail)#

SMTP veya Resend hesabıyla e-posta gönderir.

Çıktı: item + messageId, sentAt, conversationId (trackReplies açıksa). Gönderen adresi entegrasyonun From address alanıdır. Abonelikten çıkma linki için {{ $json.unsubscribeUrl }} alanı outreach/broadcast item'larında hazır gelir.

Örnek – form teşekkür e-postası:

trigger.form → leads.create → messaging.sendEmail
  to: {{ $json.email }}
  subject: Talebinizi aldık, {{ $json.name.split(" ")[0] }}
  html: |
    Merhaba {{ $json.name }},
    
    {{ $project.name }} ekibi olarak mesajınızı aldık. En geç 1 iş günü içinde dönüş yapacağız.
  replyTo: satis@ornek.com

Broadcast campaign (messaging.broadcast)#

Bir lead segmentine hız sınırlı, opt-out'a saygılı toplu mesaj gönderir ve bir Kampanya kaydı oluşturur (Kampanyalar sayfasında ilerleme, teslim ve yanıt istatistikleri).

Gelen item'lar segmenti genişletir: node'a leads.query çıktısı bağlarsanız o lead'ler kullanılır, aksi halde segment filtresi çalışır. Opt-out etiketi (unsubscribed) veya doNotContact: true olan lead'ler otomatik atlanır. Çıktı: tek item { campaignId, total, queued, skipped, skippedReasons }. Gönderimler campaigns kuyruğunda ilerler; campaign.started / campaign.finished olayları yayınlanır.

Örnek – WhatsApp kampanyası:

trigger.manual → leads.query (status [QUALIFIED, CONTACTED], tags [webinar], minScore 60)
→ messaging.broadcast
   channel: WHATSAPP
   template: Merhaba {{ $json.name }}, {{ $vars.eventName }} webinarımız {{ $vars.eventDate }} tarihinde. Katılım linki: {{ $vars.link }}
   perMinute: 30
   campaignName: Webinar duyurusu – {{ $today }}

WhatsApp'ta pazarlama mesajı için alıcının opt-in'i ve onaylı Marketing şablonu gerekir; bkz. Broadcast kampanyaları ve izin.

Hand off to human (messaging.handoff)#

Konuşmayı HUMAN durumuna alır, botu durdurur (trigger.messageReceived bu konuşma için tetiklenmez), ekibe bildirir ve conversation.handoff olayı yayınlar.

Çıktı: item + conversationStatus: "HUMAN", assignedToId (atama kuralı varsa). İnsan işini bitirince Gelen Kutusu'ndan Bota geri ver (POST /conversations/:id/release).

Örnek: Chatbot şablonu: logic.if ({{ $json.handoff === true }}) → true → messaging.handoff (reason {{ $json.handoffReason }}, notifyVia [inapp, email]). Müşteriye bilgi vermek için ardından messaging.send (text "Sizi bir temsilcimize bağlıyorum, {{ $json.workingHoursMessage ?? "en kısa sürede dönüş yapacağız" }}.").

İpuçları ve sınırlar#

• Test modunda tüm gönderim node'ları dry-run olur; messaging.handoff gerçek durum değişikliği yapar.
• Alıcı biçimleri: WhatsApp 905551112233 (artı işareti olmadan da kabul edilir), Twilio +905551112233, Telegram sayısal chat id (kanal için -100…), Slack C…/U…, Discord kanal id.
• Slack ve Discord'da bot ilgili kanala eklenmiş olmalıdır.
• E-posta gönderim limitleri sağlayıcıya bağlıdır (Gmail Workspace 2.000/gün, Resend planı); broadcast perMinute bunu aşmasın.
• Konuşma tabanlı metrikler (messages.outbound, messages.bot_replies, conversations.handoffs) bu node'lardan beslenir.
• Yasal: ticari elektronik ileti için alıcı onayı ve İYS kaydı (Türkiye) / GDPR onayı gerekir; STOP, İPTAL, unsubscribe yanıtları otomatik opt-out yapar.

Sık sorulan sorular#

Müşteriye ilk mesajı WhatsApp'tan atabilir miyim? Yalnızca onaylı şablonla ve müşterinin önceden onayıyla. Bkz. WhatsApp şablonları.

Test modunda mesaj gider mi? Hayır; gönderim kutuları kuru çalışır. İnsana devret ise gerçek durum değişikliği yapar.

Toplu mesajda çıkış yapanlara da gider mi? Hayır. Çıkış etiketi veya "iletişim kurma" işareti olan adaylar otomatik atlanır.

Sonraki adım#

• AI Chatbot
• Outreach Agent
• Gelen kutusu ve insan devralma