Entegrasyon

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. 14 kaynak kategorisinde 138 işlemi destekler:

Mesaj: 38 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
Etiket: Etiket oluşturun, düzenleyin, silin; sohbetleri etiketleyin
Çevrimiçi durum: Çevrimiçi, yazıyor ve kaydediyor durumlarını okuyun ve gönderin
İşletme Kataloğu: Ürünler, koleksiyonlar, siparişler ve işletme profili
Grup: Grup oluşturun, üyeleri, yöneticileri, ayarları, davetleri, katılma isteklerini yönetin
Topluluk: Topluluk oluşturun; üyeleri, yöneticileri ve alt grupları yönetin
Kanal: Kanal oluşturun, paylaşın, arayın, takip edin, istatistik okuyun
Hikaye: Hikaye paylaşın, görüntüleyenleri okuyun, gizliliği 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. 38 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
`Delete Profile Image`	WhatsApp hesabınızın profil fotoğrafını silin
`Get Blocked Contacts`	Engellenen kişileri listeleyin
`Add Contact`	Telefon rehberine kişi ekleyin
`Edit Contact`	Kayıtlı bir kişiyi düzenleyin
`Remove Contact`	Rehberden bir kişiyi silin
`LID to Phone`	@lid kimliğini telefon numarasına çevirin
`Phone to LID`	Telefon numarasını @lid kimliğine çevirin
`Phone to Username`	Telefon numarasının WhatsApp kullanıcı adını alın
`Username to Phone`	WhatsApp kullanıcı adını telefon numarasına çevirin
`Get Profile Name`	Numaranızın profil adını alın
`Set Profile Name`	Numaranızın profil adını değiştirin
`Get Profile About`	Numaranızın ya da bir kişinin "Hakkında" metnini alın
`Set Profile About`	Numaranızın "Hakkında" metnini ayarlayın
`Get Profile Username`	Numaranızın WhatsApp kullanıcı adını alın
`Set Profile Username`	Numaranızın WhatsApp kullanıcı adını 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
`Set Disappearing Messages`	Bir sohbetin kaybolan mesaj süresini ayarlayın (kapalı, 24 saat, 7 gün, 90 gün)

Etiket İşlemleri

İşlem	Açıklama
`Get Labels`	Numaranın tüm etiketlerini listeleyin
`Get Labeled Chats`	Bir etiketin bulunduğu sohbetleri listeleyin
`Get Label Colors`	Kullanılabilir etiket renklerini listeleyin
`Create Label`	Yeni etiket oluşturun
`Edit Label`	Etiketi yeniden adlandırın veya rengini değiştirin
`Delete Labels`	WhatsApp hesabından etiketleri silin
`Add Label to Chat`	Bir sohbete etiket ekleyin
`Remove Label from Chat`	Bir sohbetten etiketi kaldırın

Çevrimiçi Durum İşlemleri

İşlem	Açıklama
`Get Presence`	Bir kişinin çevrimiçi/yazıyor durumunu alın
`Subscribe Presence`	Bir kişinin durum güncellemelerine abone olun
`Send Presence`	Bir sohbete yazıyor, kaydediyor veya çevrimiçi durumu gönderin

İşletme Kataloğu İşlemleri

İşlem	Açıklama
`Get Products`	Numaranızın ya da bir kişinin katalog ürünlerini listeleyin
`Get Product`	ID'si ile tek bir ürünü alın
`Add Product`	Kataloğa ürün ekleyin
`Edit Product`	Bir katalog ürününü düzenleyin
`Remove Product`	Katalogdan ürün kaldırın
`Add Product Image`	Bir ürüne görsel ekleyin
`Remove Product Image`	Bir üründen görsel kaldırın
`Get Collections`	Ürün koleksiyonlarını listeleyin
`Get Collection`	Bir koleksiyonu ürünleriyle alın
`Add Collection`	Ürün koleksiyonu oluşturun
`Edit Collection`	Bir koleksiyonu yeniden adlandırın veya güncelleyin
`Remove Collection`	Bir koleksiyonu silin
`Add Collection Products`	Bir koleksiyona ürün ekleyin
`Remove Collection Products`	Bir koleksiyondan ürün çıkarın
`Get Orders`	Oturum açıkken alınan siparişleri listeleyin
`Get Order`	Bir siparişi kalemleriyle alın
`Get Business Profile`	Numaranızın ya da bir kişinin işletme profilini alın
`Set Business Profile`	Numaranızın işletme profilini güncelleyin

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
`Accept Invite V4`	Webhook'tan gelen grup davetini (V4) kabul edin

Topluluk İşlemleri

İşlem	Açıklama
`Create Community`	Yeni topluluk oluşturun
`Get Communities`	Tüm toplulukları alt gruplarıyla listeleyin
`Get Community`	Tek bir topluluğu alın
`Add Participants`	Topluluğa üye ekleyin
`Remove Participant`	Topluluktan üye çıkarın
`Promote Admin`	Bir üyeyi topluluk yöneticisi yapın
`Demote Admin`	Bir topluluk yöneticisinin yetkisini alın
`Add Sub-Groups`	Mevcut grupları topluluğa bağlayın
`Remove Sub-Groups`	Grupların topluluk bağlantısını kaldırın
`Revoke Invite`	Topluluk davet linkini iptal edip yenisini oluşturun
`Get Unjoined Sub-Groups`	Henüz katılmadığınız alt grupları listeleyin
`Join Sub-Group`	Topluluğun bir alt grubuna katılın
`Deactivate Community`	Bir topluluğu devre dışı bırakın (geri alınamaz)

Kanal İşlemleri

İşlem	Açıklama
`Create Channel`	Yeni kanal oluşturun
`Get Channels`	Sahibi olduğunuz veya takip ettiğiniz kanalları listeleyin
`Get Channel`	Tek bir kanalı alın
`Delete Channel`	Sahibi olduğunuz bir kanalı silin
`Set Channel Config`	Kanal adını, açıklamasını veya görselini güncelleyin
`Get Invite Code`	Bir kanalın davet linkini alın
`Search by Country`	Ülke koduna göre kanal keşfedin
`Search by Text`	Metne göre kanal arayın
`Get Channel Messages`	Bir kanalın mesajlarını okuyun
`Subscribe`	Bir kanalı takip edin
`Unsubscribe`	Bir kanalı takipten çıkın
`Subscribe by Invite Code`	Davet koduyla bir kanalı takip edin
`Unsubscribe by Invite Code`	Davet koduyla bir kanalı takipten çıkın
`Get Info by Invite Code`	Davet kodundan kanal bilgisini alın
`Get Statistics`	Bir kanalın takipçi ve erişim istatistiklerini alın
`Demote Admin`	Bir kanal yöneticisinin yetkisini alın
`Accept Admin Invite`	Kanal yöneticisi olma davetini kabul edin
`Revoke Admin Invite`	Bekleyen bir kanal yöneticisi davetini iptal edin

Hikaye İşlemleri

İşlem	Açıklama
`Create Story`	Metin, medya veya ses hikayesi paylaşın
`Get My Stories`	Hikayelerinizi görüntüleyenlerle birlikte listeleyin
`Get Contacts Stories`	Kişilerinizin paylaştığı hikayeleri listeleyin
`Get Story Privacy`	Hikayelerinizi kimlerin görebildiğini alın
`Set Story Privacy`	Hikayelerinizi kimlerin göreceğini ayarlayı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
`Get Calls`	Arama geçmişini listeleyin
`Get Call`	ID'si ile tek bir aramayı alın
`Start Call`	Çalan ve otomatik kapanan bir dikkat çekme araması başlatın (ses taşımaz)

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
`Get New Chat Limit`	WhatsApp'ın numaraya uyguladığı yeni sohbet limitini alı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

Neden Maytapi n8n Düğümlerini Kullanmalısınız?

Amaca yönelik tasarlanmış düğümlerle WhatsApp API'sinin tüm gücünü n8n iş akışlarınıza taşıyın.

14 kaynak kategorisinde 138 işlemle tam API kapsamı
Mesajlar, teslim durumu, grup olayları, aramalar ve hikayeler için gerçek zamanlı webhook tetikleyicileri
Kod yazmaya gerek yok -- görsel sürükle-bırak iş akışı oluşturucu
Phone ID esnekliği -- her işlem için varsayılan veya özel telefon kullanın
Yeniden deneme mantığı ve ayrıntılı hata mesajları ile yerleşik hata yönetimi
WhatsApp'ı 400+ uygulamaya bağlayın: CRM'ler, veritabanları, e-posta, Slack ve daha fazlası

WhatsApp iletişiminizi zaten kullandığınız araçlarla otomatikleştirin.

Teknik Ayrıntılar

Paket Adı:

@maytapi/n8n-nodes-maytapi

API Uç Noktası:

https://api.maytapi.com/api/{pid}

Kimlik Doğrulama:

Başlık: x-maytapi-key
URL yolunda Product ID
İşlem başına isteğe bağlı Phone ID parametresi

Kaynaklar:

Mesaj, Kişi, Sohbet, Etiket, Çevrimiçi Durum, İşletme Kataloğu, Grup, Topluluk, Kanal, Hikaye, Kuyruk, Arama, Hesap, Oturum, Oturum Kontrolü

WhatsApp İletişiminizi Güçlendirmeye Hazır mısınız?

WhatsApp API’miz ile işletme mesajlaşması ve otomasyon için güçlü özelliklerin kilidini açın

WhatsApp API’yi Keşfedin →

İşletmeler, geliştiriciler ve ileri düzey kullanıcılar için mükemmel

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.