Maytapi n8n Entegrasyonu - WhatsApp API | İş Akışı Otomasyonu

Maytapi WhatsApp API için n8n Entegrasyonu

n8n iş akışı otomasyon platformu için resmi Maytapi özel düğümleri. WhatsApp mesajlaşmasını otomatikleştirin, kişileri, grupları, oturumları ve daha fazlasını görsel sürükle-bırak iş akışlarıyla yönetin. Kod yazmadan WhatsApp'ı 400+ uygulama ve hizmete bağlayın.

n8n Nedir?

n8n, farklı uygulama ve hizmetleri görsel olarak bağlamanızı sağlayan güçlü bir açık kaynaklı iş akışı otomasyon platformudur. Kod yazmadan sürükle-bırak arayüzünü kullanarak karmaşık otomasyonlar oluşturun.

Maytapi'nin resmi n8n düğümleri ile WhatsApp'ı herhangi bir iş akışına entegre edebilirsiniz -- mesaj gönderin, grupları yönetin, kişileri yönetin, gerçek zamanlı webhook olaylarını alın ve tüm WhatsApp iletişim sürecinizi otomatikleştirin.

Hızlı Kurulum

n8n Topluluk Düğümleri veya npm ile yükleyin:

npm install @maytapi/n8n-nodes-maytapi

Gerekli kimlik bilgileri:

Product ID: Maytapi Konsolu'ndan alınır
API Token: x-maytapi-key anahtarınız
Phone ID: (İsteğe bağlı) Varsayılan WhatsApp örneği

Nasıl Çalışır

Paketi Yükleyin

n8n'de Settings → Community Nodes → Install bölümüne gidin ve @maytapi/n8n-nodes-maytapi yazın. Veya npm ile manuel olarak yükleyip n8n'i yeniden başlatın.

Kimlik Bilgilerini Ekleyin

Maytapi Konsolu'ndan aldığınız Product ID ve API Token ile yeni bir Maytapi API kimlik bilgisi oluşturun. İsteğe bağlı olarak varsayılan bir Phone ID belirleyin.

İş Akışları Oluşturun

İş akışlarınıza Maytapi veya Maytapi Trigger düğümlerini ekleyin ve n8n'deki 400+ diğer uygulama ve hizmetle bağlayın.

İki Güçlü Düğüm

Paket, Maytapi WhatsApp API'sinin tamamını kapsayan iki özel düğüm içerir.

Maytapi Düğümü (Eylemler)

İş akışlarınızda WhatsApp işlemleri gerçekleştirin. 9 kaynak kategorisinde 50+ işlemi destekler:

Mesaj: 23+ mesaj türü gönderin (metin, medya, anket, konum, vcard, butonlar, liste, çıkartma, tepki, iletme, silme, düzenleme ve daha fazlası)
Kişi: Kişileri alın, telefon numaralarını kontrol edin, engelle/engeli kaldır, profil resimleri
Sohbet: Konuşmaları listeleyin, arşivleyin, sabitleyin, sessize alın, favorilere ekleyin, geçmişi temizleyin
Grup: Grup oluşturun, üyeleri, yöneticileri, ayarları, davetleri, katılma isteklerini yönetin
Kuyruk: Mesaj kuyruklarını listeleyin, alın ve temizleyin
Arama: Aramaları reddedin, sesli/görüntülü arama bağlantıları oluşturun
Hesap: Telefonları, webhook'ları, günlükleri, ürün bilgilerini yönetin
Oturum: Durumu kontrol edin, QR kodunu alın, çıkış yapın, telefon numarasıyla bağlanın
Oturum Kontrolü: Yeniden dağıtın, fabrika ayarlarına sıfırlayın, yapılandırmayı alın/ayarlayın

Maytapi Trigger Düğümü (Webhook'lar)

İş akışlarınızı tetiklemek için gerçek zamanlı WhatsApp olaylarını alın. Dinlemek istediğiniz olayları seçin:

Mesaj Olayları: Tam meta verilerle yeni gelen/giden mesajlar (tür, alt tür, gönderen, metin, medya, zaman damgası)
ACK Olayları: Mesaj teslim durumu değişiklikleri (gönderildi, teslim edildi, okundu)
Grup Olayları: Üye katılımları, ayrılmalar, davetler, çıkarmalar, ayar değişiklikleri
Arama Olayları: Gelen, giden, cevapsız, reddedilen aramalar
Hikaye Olayları: Kişiler tarafından paylaşılan yeni hikayeler

Webhook'lar, iş akışını etkinleştirdiğinizde otomatik olarak yapılandırılır ve devre dışı bıraktığınızda temizlenir.

Mevcut İşlemler

Maytapi Node'da bulunan işlemlerin tam listesi, kaynağa göre gruplandırılmıştır.

Mesaj İşlemleri

İşlem	Açıklama
`Send Message`	Herhangi bir sohbete mesaj gönderin. 23+ mesaj türünü destekler: metin, medya, anket, konum, vcard, kişi, bağlantı, ürün, butonlar, liste, çıkartma, kısa video, iletme, silme, tepki, tepki kaldırma, düzenleme, grup daveti, mesaj sabitleme, yıldızlama, etkinlik oluşturma, hikaye metin yanıtı ve hikaye medya yanıtı.
`Get Message`	Belirli bir mesaj hakkında ID ile bilgi alın
`Get Messages`	Sayfalandırma, yazar filtresi ve gönderen filtresi ile bir konuşmadaki mesajları alın

Kişi İşlemleri

İşlem	Açıklama
`Get Contacts`	Tüm WhatsApp kişilerini listeleyin
`Get Contact`	Belirli bir kişinin bilgilerini alın
`Check Phones`	Telefon numaralarının WhatsApp'ta kayıtlı olup olmadığını kontrol edin
`Block Contact`	Bir kişiyi engelleyin veya engeli kaldırın
`Get Profile Image`	Bir kişinin veya grubun profil resmini alın
`Set Profile Image`	WhatsApp hesabınızın profil resmini ayarlayın

Sohbet İşlemleri

İşlem	Açıklama
`Get Conversations`	Sayfalandırma ile tüm konuşmaları/sohbetleri listeleyin
`Get Conversation`	Mesajlarla birlikte belirli bir konuşmanın ayrıntılarını alın
`Favorite Chat`	Bir konuşmayı favorilere ekleyin veya çıkarın
`Pin Chat`	Bir konuşmayı sabitleyin veya sabitlemeyi kaldırın
`Archive Chat`	Bir konuşmayı arşivleyin veya arşivden çıkarın
`Mute Chat`	Bir konuşmayı sessize alın veya sessizden çıkarın (8 saat, 1 hafta veya süresiz)
`Clear Chat`	Bir konuşmadaki tüm mesajları temizleyin

Grup İşlemleri

İşlem	Açıklama
`Create Group`	Katılımcılarla, isteğe bağlı davet mesajı ve profil resmiyle yeni bir WhatsApp grubu oluşturun
`Get Groups`	İsteğe bağlı katılımcı yükleme, sıralama, davet bağlantıları ve sayfalandırma ile tüm grupları listeleyin
`Get Group`	İsteğe bağlı davet bağlantısı oluşturma ile belirli grup bilgilerini alın
`Set Group Image`	Grup profil resmini ayarlayın
`Delete Group Image`	Grup profil resmini silin
`Add Participants`	İsteğe bağlı davetle bir gruba üye ekleyin
`Remove Participant`	Bir gruptan üye çıkarın
`Promote Admin`	Bir katılımcıyı yönetici yapın
`Demote Admin`	Bir yöneticiyi katılımcıya düşürün
`Set Group Config`	Grup ayarlarını yapılandırın: izinler, kaybolan mesajlar, üye ekleme onayı, ad, açıklama
`Accept Invite`	Davet koduyla bir grup davetini kabul edin
`Revoke Invite`	Grup davet bağlantısını iptal edin ve yeniden oluşturun
`Leave Group`	Bir WhatsApp grubundan ayrılın
`Get Approval Requests`	Bir grup için bekleyen katılma isteklerini listeleyin
`Approve Join Requests`	Bekleyen katılma isteklerini onaylayın
`Reject Join Requests`	Bekleyen katılma isteklerini reddedin
`Get Group Info by Invite Code`	Davet kodu kullanarak grup bilgilerini alın

Kuyruk İşlemleri

İşlem	Açıklama
`List Queues`	Tüm telefon mesaj kuyruklarını listeleyin
`Get Queue`	Belirli bir telefonun mesaj kuyruğunu alın
`Clear Queue`	Telefon mesaj kuyruğunu temizleyin

Arama İşlemleri

İşlem	Açıklama
`Reject Call`	Gelen bir aramayı reddedin (callId, webhook bildiriminden alınır)
`Create Call Link`	Zamanlanmış zaman damgası ile sesli veya görüntülü aramalar için paylaşılabilir bir arama bağlantısı oluşturun

Hesap İşlemleri

İşlem	Açıklama
`Get Product Info`	Ürün bilgilerini alın
`Add Phone`	İsteğe bağlı telefon numarası ile ürüne yeni bir telefon ekleyin
`List Phones`	Tüm kayıtlı telefonları listeleyin
`Set Webhook`	Ürün için webhook URL'sini yapılandırın
`Set ACK Preference`	Webhook üzerinden onay bildirimlerini etkinleştirin veya devre dışı bırakın
`Get Logs`	Tüm telefonların günlüklerini alın
`Get Phone Logs`	Belirli bir telefonun günlüklerini alın

Oturum İşlemleri

İşlem	Açıklama
`Get Status`	Oturumun bağlantı durumunu kontrol edin
`Get Screen`	Mevcut oturum ekranının ekran görüntüsünü alın (ikili görüntü döndürür)
`Get QR Code`	Telefon eşleştirme için QR kodunu alın (ikili görüntü döndürür)
`Logout`	WhatsApp oturumunun bağlantısını kesin
`Connect with Phone Number`	QR kodu yerine telefon numarası kullanarak bağlanın

Oturum Kontrol İşlemleri

İşlem	Açıklama
`Redeploy`	Oturumu yeniden başlatmak için Docker örneğini yeniden dağıtın
`Factory Reset`	Telefonu ilk durumuna fabrika ayarlarına sıfırlayın
`Get Config`	Telefona özel yapılandırmayı alın
`Set Config`	Telefona özel webhook URL'si ve ACK teslim ayarlarını belirleyin

Webhook Tetikleyici Olayları

Olay Türü	Açıklama
`Message`	Tam meta verilerle yeni gelen/giden mesajlar: mesaj türü, alt tür, gönderen numarası, gönderen adı, alıcı, mesaj metni, mesaj ID, zaman damgası, konuşma ayrıntıları
`ACK`	Mesaj teslim durumu değişiklikleri: gönderildi, teslim edildi, okundu -- mesaj ID ve zaman damgasıyla birlikte
`Group`	Grup üye olayları: katılımlar, ayrılmalar, davetler, çıkarmalar, ayar değişiklikleri -- grup ID, ad, eylem türü ve katılımcı ayrıntılarıyla birlikte
`Call`	Arama olayları: gelen, giden, cevapsız, reddedilen aramalar -- arama ID, durum ve arayan ayrıntılarıyla birlikte
`Story`	Hikaye olayları: kişiler tarafından paylaşılan yeni hikayeler -- hikaye ID, gönderen, hikaye türü ve içerikle birlikte

Sıkça Sorulan Sorular

Maytapi n8n düğümlerini nasıl yüklerim?

n8n örneğinizde Settings → Community Nodes → Install bölümüne gidin ve @maytapi/n8n-nodes-maytapi arayın. Veya npm ile manuel olarak yükleyin: npm install @maytapi/n8n-nodes-maytapi ve n8n'i yeniden başlatın.

Hangi kimlik bilgilerine ihtiyacım var?

Maytapi Konsolu'ndan Product ID ve API Token'ınıza ihtiyacınız var. İsteğe bağlı olarak, WhatsApp örneğiniz için varsayılan bir Phone ID belirtebilirsiniz.

Birden fazla WhatsApp numarası kullanabilir miyim?

Evet! Kimlik bilgilerinde varsayılan bir Phone ID ayarlayabilir veya düğüm başına geçersiz kılabilirsiniz. "Phone ID Source" seçeneği, her işlem için kimlik bilgileri veya özel Phone ID arasında seçim yapmanızı sağlar.

Webhook'lar n8n ile nasıl çalışır?

Maytapi Trigger düğümü, iş akışını etkinleştirdiğinizde Maytapi ile webhook'ları otomatik olarak yapılandırır. Hangi olayları alacağınızı seçebilirsiniz (mesajlar, ACK, gruplar, aramalar, hikayeler). İş akışını devre dışı bıraktığınızda webhook otomatik olarak temizlenir.

Hangi mesaj türlerini gönderebilirim?

Send Message işlemi tüm Maytapi mesaj türlerini destekler: metin, resim, video, belge, ses, konum, kişi kartları, çıkartmalar, anketler, tepkiler, butonlar, liste mesajları, kısa video, iletme, silme, düzenleme, sabitleme ve daha fazlası.

n8n entegrasyonu ücretsiz mi?

Maytapi n8n düğümleri paketi ücretsiz ve açık kaynaklıdır. WhatsApp API'sini kullanmak için yalnızca aktif bir Maytapi aboneliğine ihtiyacınız vardır. Tüm Maytapi planları, n8n entegrasyonu için ekstra ücret olmaksızın tam API erişimi içerir.