İçeriğe geç
Wbiztool

Entegrasyonlar

Zapier entegrasyonu

Zapier'deki Wbiztool uygulaması, WhatsApp numaranızı kullandığınız diğer uygulamalara bağlar. Bir WhatsApp mesajı geldiğinde bir Zap başlatın veya başka bir uygulamada bir şey olduğunda WhatsApp mesajı gönderin.

Başlamadan önce#

Hesabınızı bağlayın#

  1. Wbiztool'u bir Zap'e ekleyin

    Zapier'de bir Zap oluşturun ve tetikleyici veya eylem uygulaması olarak Wbiztool'u arayın.

  2. Oturum açın

    Zapier sizden bir hesap bağlamanızı istediğinde Ayarlar → API anahtarları sayfasındaki Client ID ve API anahtarınızı girin.

Zapier'in hangi çalışma alanını kullanacağını API anahtarı belirler. Birden fazla çalışma alanına üyeyseniz bağlamak istediğiniz çalışma alanında oluşturulmuş bir anahtar kullanın. Client ID veya API anahtarı yanlışsa Zapier bağlanırken hatayı gösterir, örneğin Auth Error: invalid api key.

Gelen WhatsApp mesajı tetikleyicisi#

Bu tetikleyici, birisi WhatsApp numaralarınızdan birine her mesaj gönderdiğinde Zap'inizi başlatır. Yeni sohbetleri bir CRM'e eklemek, mesajları bir ekip kanalına göndermek veya konuşmaları bir tabloya kaydetmek için kullanın.

  1. Tetikleyiciyi seçin

    Uygulama olarak Wbiztool'u, tetikleyici olayı olarak Incoming WhatsApp Message'ı seçin.

  2. Bir WhatsApp numarası seçin

    WhatsApp Number altında, gelen mesajları Zap'i başlatacak bağlı numarayı seçin. Liste çalışma alanınızda bağlı olan telefon numaralarını gösterir.

  3. Tetikleyiciyi test edin

    Test trigger'a tıklayın. Zapier, sonraki adımlarda gerçek alanları eşleyebilmeniz için o numarada alınan en son mesajlarınızı yükler. Numarada henüz mesaj yoksa Zapier bunun yerine örnek bir mesaj gösterir.

  4. Zap'i açın

    Zap'i yayınlayın. Wbiztool, Zapier'e otomatik olarak bağlanır. Wbiztool'da herhangi bir yere webhook URL'si eklemeniz gerekmez.

Tetikleyici gereksinimleri#

  • Unibox eklentisi. Tetikleyici, numaranızda bir Unibox dinleyicisi kullanır. Eklenti olmadan Zap'i açmak Unibox add-on subscription required hatasıyla başarısız olur. Eklentiyi Faturalandırma ve planlar sayfasından satın alın: Unibox'ta kullanılan WhatsApp numarası başına aylık 20 $ veya yıllık 200 $.
  • Boş bir Unibox yeri. Numara henüz bir Unibox dinleyicisi değilse, eklentinizin izin verdiği dinleyici sayısına dahil edilir. Zaten dinleyicisi olan numaralar başka bir yer kullanmaz.
  • Sahip veya Editör rolü. API anahtarı bir çalışma alanı Sahibine veya Editörüne ait olmalıdır.
  • Bağlı bir WhatsApp numarası. Yeni mesajların alınması için numaranın bağlı kalması gerekir.

Tetikleyici dinleyicilerinizle nasıl çalışır#

  • Zap'i yalnızca gelen mesajlar başlatır. Numaranızdan gönderilen mesajlar başlatmaz.
  • Yalnızca Zap'i açtıktan sonra alınan mesajlar gönderilir. Eski mesajlar yeniden oynatılmaz.
  • Numaranın kendi webhook URL'nizi kullanan bir dinleyicisi zaten varsa, Zap açıkken Zapier'in webhook'u onun yerini alır. Zap'i kapattığınızda kendi webhook URL'niz, gizli anahtarınız ve olay ayarlarınız geri yüklenir.
  • Bir Zap'i önce kapatmadan silerseniz, Zapier Zap'in silindiğini bildirir bildirmez Wbiztool ona göndermeyi durdurur.
  • Unibox dinleyicileri sayfasında dinleyici bir Zapier rozeti gösterir. Dinleyiciyi orada siler veya devre dışı bırakırsanız Zap, Zapier'de açık kalır ama mesaj almaz; sayfa sizi önceden uyarır. Zap'i durdurmak için bunun yerine onu Zapier'de kapatın. Dinleyiciyi sildikten sonra mesajların yeniden akması için Zap'i Zapier'de kapatıp yeniden açın.

Dinleyicilerin ve webhook'ların nasıl çalıştığı için bkz. Webhook dinleyicileri.

Tetikleyici verileri#

Her Zap çalışması şuna benzer bir mesaj alır:

{
  "event": "message_received",
  "timestamp": "2026-09-16T10:31:12.482913+00:00",
  "webhook_id": 42,
  "whatsapp_client_id": "678",
  "whatsapp_phone": "919812345678",
  "message": {
    "id": "[email protected]_3EB0C1A2B3D4E5F60718",
    "type": "chat",
    "content": "Hi, is my order #4821 out for delivery?",
    "from": "919876543210",
    "from_name": "Aman",
    "to": "919812345678",
    "timestamp": "2026-09-16T10:29:58+00:00",
    "whatsapp_timestamp": 1789554598,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "919876543210",
    "lid": null,
    "phone_hidden": false,
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}
AlanAçıklama
whatsapp_phoneMesajı alan WhatsApp numaranız.
message.typeMetin için chat. Medya mesajları image, video, audio, ptt (sesli not), document ve sticker gibi türler kullanır.
message.contentMetin. Medya için "📸 Image" gibi kısa bir etiket.
message.fromGönderenin + olmadan numarası. WhatsApp gizlediğinde boştur (aşağıya bakın).
contact.phoneKişinin + olmadan numarası. WhatsApp gizlediğinde boştur.
contact.lidWhatsApp bir gizlilik kimliği kullandığında kişinin 62337239240946@lid gibi gizlilik kimliği. Aksi halde null.
contact.phone_hiddenWhatsApp kişinin numarasını paylaşmadığında true.
contact.is_groupMesaj bir gruptan geldiğinde true. Grup mesajları ayrıca group.name içerir.

Bazı mesajlar ek alanlar içerir: medya için message.media (dosya adı, türü ve boyutu), yanıtlar için message.quoted_message_id ve grup mesajları için group.

Örnek: gelen mesajları Google Sheets'e kaydedin#

  1. Tetikleyici: Wbiztool, Incoming WhatsApp Message.
  2. Eylem: Google Sheets, Create Spreadsheet Row. Contact Phone'u bir Phone sütununa, Contact Name'i bir Name sütununa ve Message Content'i bir Message sütununa eşleyin.

Bir Zap'ten WhatsApp mesajı gönderin#

Wbiztool'u eylem olarak ekleyin ve şu eylem olaylarından birini seçin:

EylemNe gönderir
Send Text-Only WhatsApp MessageBir metin mesajı.
Send Image File With Text on WhatsAppHerkese açık bir görsel URL'sinden, isteğe bağlı açıklamayla bir görsel.
Send PDF File With Text on WhatsAppHerkese açık bir URL'den, isteğe bağlı mesajla bir dosya.
Send Advanced WhatsApp Messageİsteğe bağlı bir durum webhook'uyla metin, görsel veya dosya.
Send WhatsApp Message on GroupTam grup adıyla bir WhatsApp grubuna mesaj.

Her eylemde gönderen numarayı WhatsApp Number altında seçin. Alıcının telefon numarasını 919876543210 gibi ülke koduyla girin ya da ülke kodunu isteğe bağlı Country Code alanına (91 gibi) yazın. Send WhatsApp Message on Group eyleminde telefon veya ülke kodu yoktur; bunun yerine Group Name alır.

Wbiztool bir mesajı kabul edemediğinde adım başarısız olur ve Zapier nedenini gösterir, örneğin WbizTool: Invalid phone number veya WbizTool: Not enough credits. Başarılı bir adım, mesajın kuyruğa alındığı anlamına gelir. Wbiztool ardından onu bağlı numaranızdan gönderir.

API'yi Webhooks by Zapier ile doğrudan da çağırabilirsiniz:

AyarDeğer
Eylem olayıPOST
URLhttps://wbiztool.com/api/v1/send_msg/
İçerik türü (Payload type)json veya form
Vericlient_id, api_key, whatsapp_client, country_code, phone, msg

Her alanın ne anlama geldiği için Herhangi bir otomasyon aracından WhatsApp mesajı gönderin sayfasına, tüm seçenekler için Mesaj gönderme sayfasına bakın.

Sorun giderme#

SorunNeyi kontrol etmeli
Auth Error: invalid api keyAnahtar silinmiş, yanlış yazılmış veya Client ID ile eşleşmiyor. Ayarlar → API anahtarları sayfasında yeni bir anahtar oluşturun ve yeniden bağlanın.
This API key is not linked to a workspace. Create a new API key in WbizTool.Anahtar eski bir hesap yapılandırmasından. Ayarlar → API anahtarları sayfasında yeni bir anahtar oluşturun ve yeniden bağlanın.
Unibox add-on subscription requiredFaturalandırma ve planlar sayfasından Unibox eklentisini satın alın, ardından Zap'i yeniden açın.
Unibox numbers limit reached for your plan. Remove a listener or upgrade to connect this number.Tüm Unibox yerleriniz kullanımda. Unibox dinleyicileri sayfasında artık ihtiyacınız olmayan bir dinleyiciyi silin veya eklenti adedini artırın.
Only workspace owners and editors can connect Zapier triggersZapier'i bir çalışma alanı Sahibinin veya Editörünün oluşturduğu bir API anahtarıyla yeniden bağlayın.
Invalid WhatsApp clientTetikleyicide seçilen numara şu anda bağlı değil. WhatsApp ayarları sayfasında yeniden bağlayın.
Invalid phone number veya Phone number is invalidAlıcı numarası yanlış veya ülke kodu eksik. 919876543210 gibi yalnızca rakam kullanın ya da Country Code alanını doldurun.
Not enough creditsÇalışma alanınızın mesaj kredisi bitti. Faturalandırma ve planlar sayfasından yükleme yapın.
Zap açık ama tetiklenmiyorNumara bağlı kalmalıdır. WhatsApp ayarları sayfasında kontrol edin ve Unibox dinleyicileri sayfasında dinleyicisinin bulunduğunu, Zapier gösterdiğini ve etkin olduğunu kontrol edin. Dinleyici silindiyse veya Zapier rozeti göstermiyorsa Zap'i Zapier'de kapatıp yeniden açın. Mesajlar birkaç dakika içinde alınır.
Contact Phone boşWhatsApp o kişinin numarasını gizliyor. Bkz. Telefon numarası gizli olduğunda.