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ızda bir Unibox dinleyicisi kullanır. 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 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"
}
}
| 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ü ve boyutu), yanıtlar için message.quoted_message_id ve grup mesajları için group.
Ö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 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 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ınızın mesaj kredisi bitti. Faturalandırma ve planlar sayfasından yükleme yapın. |
| Zap açık ama tetiklenmiyor | Numara 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. |
