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#
- WhatsApp ayarları sayfasında bağlı bir WhatsApp numarası olan bir WbizTool hesabı.
- Ayarlar → API anahtarları sayfasından Client ID ve API anahtarınız.
- Gelen mesaj tetikleyicisi için: planınızda Unibox eklentisi. Bkz. Tetikleyici gereksinimleri.
Hesabınızı bağlayın#
WbizTool'u bir Zap'e ekleyin
Zapier'de bir Zap oluşturun ve tetikleyici veya eylem uygulaması olarak WbizTool'u arayın.
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.
Tetikleyiciyi seçin
Uygulama olarak WbizTool'u, tetikleyici olayı olarak Incoming WhatsApp Message'ı seçin.
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.
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.
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ızı Unibox gelen kutusuna ekler (bir gelen kutusu numarası olarak). Eklenti olmadan Zap'i açmak
Unibox add-on subscription requiredhatası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 gelen kutusu numarası. Numara henüz gelen kutusunda değilse, eklentinizin izin verdiği gelen kutusu numaralarından birini kullanır. Zaten gelen kutusunda olan bir numara başka bir tane 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 gelen kutusu numaralarınızla 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.
- Numara kendi webhook URL'nizle zaten gelen kutusundaysa, 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.
- Gelen kutusu numaraları sayfasında numaranın webhook'u bir Zapier rozeti gösterir. Orada numarada Durdur'a veya Kaldır'a tıklarsanı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.
Gelen kutusu numaralarının ve webhook'ların nasıl çalıştığı için bkz. Gelen mesaj webhook'ları.
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"
}
}
| Alan | Açıklama |
|---|---|
whatsapp_phone | Mesajı alan WhatsApp numaranız. |
message.type | Metin için chat. Medya mesajları image, video, audio, ptt (sesli not), document ve sticker gibi türler kullanır. |
message.content | Metin. Medya için "📸 Image" gibi kısa bir etiket. |
message.from | Gönderenin + olmadan numarası. WhatsApp gizlediğinde boştur (aşağıya bakın). |
contact.phone | Kişinin + olmadan numarası. WhatsApp gizlediğinde boştur. |
contact.lid | WhatsApp bir gizlilik kimliği kullandığında kişinin 62337239240946@lid gibi gizlilik kimliği. Aksi halde null. |
contact.phone_hidden | WhatsApp kişinin numarasını paylaşmadığında true. |
contact.is_group | Mesaj 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ü, boyutu ve 7 gün çalışan bir indirme bağlantısı olan url), yanıtlar için message.quoted_message_id ve grup mesajları için group. Bir dosyayı saklamak için onu bu 7 gün içinde kopyalayın (örneğin bir Google Drive veya Dropbox yükleme adımıyla).
Örnek: gelen mesajları Google Sheets'e kaydedin#
- Tetikleyici: WbizTool, Incoming WhatsApp Message.
- 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:
| Eylem | Ne gönderir |
|---|---|
| Send Text-Only WhatsApp Message | Bir metin mesajı. |
| Send Image File With Text on WhatsApp | Herkese açık bir görsel URL'sinden, isteğe bağlı açıklamayla bir görsel. |
| Send PDF File With Text on WhatsApp | Herkese 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 Group | Tam 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:
| Ayar | Değer |
|---|---|
| Eylem olayı | POST |
| URL | https://wbiztool.com/api/v1/send_msg/ |
| İçerik türü (Payload type) | json veya form |
| Veri | client_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#
| Sorun | Neyi kontrol etmeli |
|---|---|
Auth Error: invalid api key | Anahtar 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 required | Faturalandı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 gelen kutusu numaralarınız kullanımda. Gelen kutusu numaraları sayfasında artık ihtiyacınız olmayan bir numarayı kaldırın veya eklenti adedini artırın. |
Only workspace owners and editors can connect Zapier triggers | Zapier'i bir çalışma alanı Sahibinin veya Editörünün oluşturduğu bir API anahtarıyla yeniden bağlayın. |
Invalid WhatsApp client | Tetikleyicide seçilen numara şu anda bağlı değil. WhatsApp ayarları sayfasında yeniden bağlayın. |
Invalid phone number veya Phone number is invalid | Alı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ı ücretsiz planda ve mesajı kalmadı. Faturalandırma ve planlar sayfasından bir plan seçin: ücretli planlar sınırsız mesaj gönderir. |
Daily limit reached: … | WhatsApp numarası son 24 saatte 1.000 mesaj aldı (adil kullanım). Kalanını daha sonra veya başka bir numaradan gönderin. |
| Zap açık ama tetiklenmiyor | Numara bağlı kalmalıdır. WhatsApp ayarları sayfasında kontrol edin ve numaranın Gelen kutusu numaraları sayfasında bulunduğunu, Zapier gösterdiğini ve Senkronize ediliyor durumunda olduğunu kontrol edin. Numara kaldırıldıysa 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. |

