Ürün kılavuzları
Gelen kutusu numaraları ve gelen mesaj webhook'ları
Gelen kutusu numaraları sayfasında, WhatsApp numaralarınızdan hangilerinin Unibox gelen kutusuna senkronize edileceğini seçersiniz; ekibiniz sohbetleri orada okur ve yanıtlar. Bir numaraya webhook URL'si verirseniz WbizTool, o numaranın aldığı veya gönderdiği her yeni mesajı imzalı JSON olarak sunucunuza da gönderir: sohbetleri bir CRM'e kaydedin, ekibinizi uyarın veya otomatik yanıt çalıştırın.
Alıcıyı mı geliştiriyorsunuz? Webhook'lar nasıl iletilir, İmzayı doğrulayın ve İçerik (payload) bölümlerine gidin.
Kimler yapabilir: Sahipler ve Editörler numara ekler, webhook'ları değiştirir ve webhook gizli anahtarını görür. Analistler kenar çubuğunda Gelen kutusu numaraları öğesini görmez. Unibox eklentisi gerekir: gelen kutusundaki her numara için ABD liste fiyatlarıyla aylık 20 $ veya yıllık 200 $ (fiyatınız Faturalandırma ve planlar sayfasında görünür); eklentiyi ücretli veya ömür boyu bir plana bir Sahip Faturalandırma ve planlar sayfasında ekler (bkz. Eklentiler). Eklentinin adedi, gelen kutusunda aynı anda kaç numara olabileceğini belirler.
Kenar çubuğunda Gelen kutusu altından Gelen kutusu numaraları'nı açın veya /unibox/listeners/ adresine gidin.
Başlamadan önce#
- Boş bir gelen kutusu numarası olan Unibox eklentisi: sayfa başlığının altındaki satırda örneğin "2 / 3 gelen kutusu numarası kullanımda (Unibox eklentisi)" ya da "Unibox eklentisi yok" yazar (bkz. Unibox eklentisi olmadan).
- WhatsApp numaraları sayfasında Bağlı görünen, QR kodla veya eşleştirme koduyla bağlanmış bir WhatsApp numarası. Tarayıcı uzantısıyla bağlanan numaralar eklenemez. Bağlı bir Telegram hesabı bir numara gibi eklenebilir.
- Webhook için: herkese açık internette (
localhostveya özel bir ağda değil), en fazla 500 karakterlik, JSON gövdeliPOSTisteklerini kabul eden ve 8 saniye içinde2xxile yanıt veren birhttps://adresi.
Gelen kutusuna numara ekleyin#
Pencereyi açın
Sayfanın sağ üstündeki Gelen kutusuna numara ekle'ye tıklayın.
Numarayı seçin
WhatsApp numarası altından seçin. Liste, henüz gelen kutusunda olmayan bağlı numaralarınızı gösterir.
Webhook ekleyin (isteğe bağlı)
Ekleyin
Numara ekle'ye tıklayın. "Numara eklendi – sohbetleri birkaç dakika içinde senkronize edilmeye başlar." mesajını görürsünüz. Bir webhook URL'si girdiyseniz Webhook gizli anahtarınız açılır: Kopyala'ya tıklayın ve gizli anahtarı sunucunuzun okuyabileceği bir yerde saklayın. Daha sonra Webhook ayarları içinde yeniden görüntüleyebilirsiniz.
- Yalnızca yeni mesajlar. Bir numara, eklediğiniz andan itibaren senkronize edilir: eski mesajlar içe aktarılmaz veya gönderilmez.
- Tüm numaralar kullanımda mı? Pencerede "Tüm gelen kutusu numaralarınız kullanımda. Birini durdurun veya kaldırın ya da Unibox eklentisine daha fazla numara ekleyin." yazar. Bir numarayı durdurun veya kaldırın ya da bir Sahip'ten eklentinin adedini artırmasını isteyin (Eklentileri gör).
- Kaldırılmış bir numarayı yeniden eklemek gelen kutusunu geri getirir ("Numara yeniden eklendi – sohbetleri bundan sonra yeniden senkronize edilir."); kaldırılmışken gelen mesajlar alınmaz. Webhook URL'siyle eklenirse, varsa önceki gizli anahtarını korur (Webhook ayarları içinde Göster'i kullanın); yoksa yeni bir anahtarla Webhook gizli anahtarınız açılır.
Bir numaranın kartında neler görünür#
Her kart numarayı, WbizTool'un mesajlar için onu en son ne zaman kontrol ettiğini ("Son kontrol: 1 dk önce" veya Hiç kontrol edilmedi), Mesajlar ve Senkronize kişiler sayısını (gelen kutusunda mesajı olmayanlar dahil, bu numaradan senkronize edilen tüm sohbetler), Son mesaj'ı ve Webhook'u gösterir: URL ve neyi gönderdiği, örneğin "Alınan ve gönderilen her mesajı gönderir · bir gizli anahtarla imzalı" veya "Yok – mesajlar yalnızca gelen kutusunda görünür." Zapier rozeti, mesajları bir Zap'in aldığı anlamına gelir (bkz. Zapier ve gelen kutusu numaraları).
Sağ üstteki rozet numaranın ne yaptığını söyler:
| Rozet | Anlamı |
|---|---|
| Senkronize ediliyor | Yaklaşık dakikada bir kontrol edilir; yeni mesajlar gelen kutusuna ve webhook'unuza ulaşır. |
| Son zamanlarda kontrol edilmedi | "Son 15 dakikada kontrol edilmedi – örneğin numara bir kampanya gönderirken gelen kutusu kontrolleri duraklar. Devam ederse destek ekibiyle iletişime geçin." Mesajlar gönderim bittikten sonra alınır. |
| Numaranın bağlantısı kesildi | "WhatsApp numarasının bağlantısı kesildi, bu yüzden yeni bir şey gelmiyor." Yeniden bağlayın'a tıklayın. |
| Durduruldu | Sizin tarafınızdan ya da eklenti sona erdiğinde veya daha az numarayı kapsadığında WbizTool tarafından durduruldu (bkz. Eklenti sona erdiğinde). Hiçbir şey senkronize edilmez veya gönderilmez. |
| Beklemede | "Numara çevrimdışıyken eklendi (örn. Zapier ile). Başlatılana kadar senkronize edilmez." Gerekirse numarayı yeniden bağlayın, ardından Başlat'a tıklayın. |
Webhook URL'sini veya gönderilen mesajları değiştirin#
Webhook ayarlarını açın
Numaranın kartında Webhook ayarları'na tıklayın.
Ayarları değiştirin
Webhook URL’si (isteğe bağlı) alanını ve Gönderilecek mesajlar altındaki işaretleri düzenleyin. Webhook'u kapatmak için URL'yi temizleyin.
Kaydedin
- URL'yi değiştirmek gizli anahtarı korur. URL'yi temizlemek anahtarı siler; daha sonra eklenen bir URL yeni bir anahtar alır ve bu anahtar Webhook gizli anahtarınız içinde bir kez gösterilir.
- Hiçbir kutu işaretli değilse kartta "Hiçbir olay seçilmedi – hiçbir şey gönderilmez" yazar.
Gizli anahtarı gösterin veya yeniden oluşturun#
Gizli anahtar 32 harf ve rakamdan oluşur. Webhook ayarları içinde, Webhook gizli anahtarı altında Göster anahtarı yanında Kopyala ile görüntüler. Yeniden oluştur şunu sorar: "Yeni bir gizli anahtar oluşturulsun mu? Mevcut anahtar hemen çalışmayı bırakır – imzaları kontrol ettiğiniz her yerde güncelleyin." Yeni gizli anahtar oluştur'a tıklayın: anahtar Kaydet gerekmeden hemen kaydedilir ("Yeni gizli anahtar oluşturuldu.") ve o andan itibaren her istek, önceki mesajların yeniden denemeleri dahil, bu anahtarla imzalanır.
Bir numarayı durdurun, başlatın veya kaldırın#
| Düğme | Ne olur |
|---|---|
| Durdur | Onayladıktan sonra sohbetlerinin senkronizasyonu durur ve hiçbir şey gönderilmez. Artık gelen kutusu numaralarınızdan birini kullanmaz; ayarları korunur. |
| Başlat | Yeniden senkronize eder ve gönderir; gelen kutusu numaralarınızdan birini kullanır. Durdurulmuşken gelen mesajlar 30 güne kadar geriye gelen kutusuna eklenir ama gönderilmez: webhook'unuza yalnızca Başlat'a tıkladığınız andan itibaren gelen mesajlar ulaşır. Bir saatten kısa bir durdurmadan sonra bunlar da gönderilir. Eklenti yoksa ("Unibox eklentisi gerekiyor") veya boş gelen kutusu numarası yoksa ("Tüm gelen kutusu numaralarınız kullanımda – önce başka bir numarayı durdurun veya kaldırın") Başlat gridir. |
| Kaldır | "… gelen kutusundan kaldırılsın mı?" diye sorar. Sohbetlerinin senkronizasyonu durur ve webhook'u kapatılır; daha önce senkronize edilen sohbetler gelen kutusunda kalır. Geri getirmek için yeniden ekleyin. |
Numarayı durdurduğunuzda veya kaldırdığınızda ya da URL'sini değiştirdiğinizde, yeniden denenmeyi bekleyen webhook'lar bırakılır.
Webhook'lar nasıl iletilir#
- Ne zaman: her gelen kutusu numarası bağlıyken yaklaşık dakikada bir kontrol edilir; numara mesaj gönderirken (örneğin bir kampanya) kontroller duraklar. Bir mesaj, onu bulan kontrolden sonra, genellikle bir iki dakika içinde gönderilir. Test düğmesi yoktur: numaraya başka bir telefondan mesaj gönderin.
- Mesaj başına bir istek: Alınan mesajlar için
message_received; telefondan, WhatsApp Web'den veya WbizTool tarafından (kampanyalar, API, hatırlatıcılar) gönderilen Gönderilen mesajlar içinmessage_sent. Unibox gelen kutusundan gönderilen yanıtlar genellikle gönderilmez: gelen kutusunda zaten vardır. - Başarı: 8 saniye içinde herhangi bir
2xxdurumu. Yönlendirmeler izlenmez:3xxbaşarısız sayılır. - Yeniden denemeler: zaman aşımı, bağlantı hatası,
429veya5xx30 saniye, 1 dakika ve 2 dakika sonra olmak üzere 3 kez yeniden denenir.400veya404gibi diğer yanıtlar ve geçersiz bir TLS sertifikası yeniden denenmez. 410 Gone: WbizTool numaranın webhook'unu kapatır (URL ve gizli anahtar kaldırılır; bir Zapier hook'u için kendi önceki webhook'unuz geri gelir). Numara gelen kutusuna senkronize edilmeye devam eder.- Sıra ve tekrarlar: istekler sırasız ve nadiren iki kez gelebilir.
message.whatsapp_timestampdeğerine göre sıralayın ve aynıwhatsapp_client_idiçin işlediğiniz birmessage.iddeğerini atlayın. Aynı gruptaki iki numaranızın her biri kendi kopyasını gönderir. - Geç gelen mesajlar: geç alınan bir mesaj, örneğin numara yeniden bağlandıktan veya kontroller duraklatıldıktan sonra, yine de gönderilir; 10 dakikadan eskiyse
replayeddeğeritrueolur. Numara durdurulmuşken gelen mesajlar Başlat'tan sonra gönderilmez (bkz. Bir numarayı durdurun, başlatın veya kaldırın). - Adres kontrolleri: URL her istekten önce yeniden kontrol edilir; artık özel bir ağı gösteren veya çözümlenemeyen bir ana makineye gönderim yapılmaz ve o mesaj yeniden denenmez.
Başlıklar#
| Başlık | Değer |
|---|---|
Content-Type | application/json |
X-Wbiztool-Event | message_received veya message_sent |
X-Wbiztool-Timestamp | İsteğin yapıldığı zaman, ISO 8601 UTC biçiminde. Gövdedeki timestamp ile aynıdır. |
X-Wbiztool-Webhook-Id | Numaranın gelen kutusu kimliği. Gövdedeki webhook_id ile aynıdır. |
X-Wbiztool-Signature | sha256= ve ardından imza (bkz. İmzayı doğrulayın). |
İmzayı doğrulayın#
Her istek, numaranın webhook gizli anahtarıyla, ham istek gövdesi üzerinden, tam olarak alındığı şekliyle HMAC-SHA256 kullanılarak imzalanır. Küçük harfli onaltılık özet, X-Wbiztool-Signature içinde sha256=<digest> olarak gönderilir. Gelen kutusu numaraları sayfasında ayarlanan bir webhook'un her zaman bir gizli anahtarı vardır, bu yüzden bu başlık her zaman bulunur.
İmzayı JSON'u ayrıştırmadan önce ham baytlardan hesaplayın. Gövdeyi ayrıştırıp yeniden kodlamak onu değiştirir (boşluklar, kaçışlı karakterler) ve imza eşleşmez.
// Express: register this route before app.use(express.json()), or the raw body is lost
import crypto from "node:crypto";
import express from "express";
const app = express();
const SECRET = process.env.WBIZTOOL_WEBHOOK_SECRET;
app.post("/wbiztool/webhook", express.raw({ type: "application/json" }), (req, res) => {
const expected = "sha256=" + crypto.createHmac("sha256", SECRET).update(req.body).digest("hex");
const received = req.get("X-Wbiztool-Signature") || "";
const a = Buffer.from(received), b = Buffer.from(expected);
const valid = a.length === b.length && crypto.timingSafeEqual(a, b);
if (!valid) return res.status(401).send("Invalid signature");
const data = JSON.parse(req.body.toString("utf8"));
if (data.event === "message_received") {
console.log(`New message from ${data.contact.phone}: ${data.message.content}`);
}
res.sendStatus(200); // answer quickly; do slow work in the background
});
app.listen(3000);# Flask
import hashlib
import hmac
import json
import os
from flask import Flask, abort, request
app = Flask(__name__)
SECRET = os.environ["WBIZTOOL_WEBHOOK_SECRET"].encode()
@app.post("/wbiztool/webhook")
def wbiztool_webhook():
raw_body = request.get_data() # raw bytes, before parsing
expected = "sha256=" + hmac.new(SECRET, raw_body, hashlib.sha256).hexdigest()
received = request.headers.get("X-Wbiztool-Signature", "")
if not hmac.compare_digest(expected, received):
abort(401)
data = json.loads(raw_body)
if data["event"] == "message_received":
print(f"New message from {data['contact']['phone']}: {data['message']['content']}")
return "", 200<?php
$secret = getenv('WBIZTOOL_WEBHOOK_SECRET');
$rawBody = file_get_contents('php://input');
$expected = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
$received = $_SERVER['HTTP_X_WBIZTOOL_SIGNATURE'] ?? '';
if (!hash_equals($expected, $received)) {
http_response_code(401);
exit('Invalid signature');
}
$data = json_decode($rawBody, true);
if ($data['event'] === 'message_received') {
error_log('New message from ' . $data['contact']['phone'] . ': ' . $data['message']['content']);
}
http_response_code(200);Gerçek bir mesaj gelmeden alıcınızı test etmek için bir gövdeyi kendiniz imzalayıp gönderin:
BODY='{"event":"message_received","message":{"content":"Test"},"contact":{"phone":"12125550120"}}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$WBIZTOOL_WEBHOOK_SECRET" | sed 's/^.* //')
curl -X POST https://your-server.example/wbiztool/webhook -H 'Content-Type: application/json' -H "X-Wbiztool-Signature: sha256=$SIG" -d "$BODY"
İmza, her denemede yenilenen timestamp alanı dahil gövdenin tamamını kapsar. Tekrar oynatılan istekleri reddetmek için 5 dakikadan eski bir timestamp değerini reddedin ve işlediğiniz bir message.id değerini atlayın.
İçerik (payload)#
{
"event": "message_received",
"timestamp": "2026-10-15T10:30:31.482913+00:00",
"replayed": false,
"webhook_id": 51,
"whatsapp_client_id": "101",
"whatsapp_phone": "12125550101",
"platform": "whatsapp",
"message": {
"id": "[email protected]_3EB0C1A2B3D4E5F60718",
"type": "chat",
"content": "Can I add a gift note to it?",
"from": "12125550120",
"from_name": "Emma Thompson",
"to": "12125550101",
"timestamp": "2026-10-15T10:30:04+00:00",
"whatsapp_timestamp": 1792060204,
"direction": "incoming",
"status": "pending",
"is_forwarded": false,
"forwarding_score": 0
},
"contact": {
"whatsapp_id": "[email protected]",
"phone": "12125550120",
"lid": null,
"phone_hidden": false,
"name": "Emma Thompson",
"is_group": false,
"is_business": false
},
"organisation": {
"id": "10314",
"name": "Lumen & Wick"
}
}{
"event": "message_sent",
"timestamp": "2026-10-15T10:34:22.117205+00:00",
"replayed": false,
"webhook_id": 51,
"whatsapp_client_id": "101",
"whatsapp_phone": "12125550101",
"platform": "whatsapp",
"message": {
"id": "[email protected]_3EB0F9E8D7C6B5A40312",
"type": "chat",
"content": "Of course! Send us the text and we'll print it on a card.",
"from": "12125550120",
"from_name": "Emma Thompson",
"to": "12125550101",
"timestamp": "2026-10-15T10:33:40+00:00",
"whatsapp_timestamp": 1792060420,
"direction": "outgoing",
"status": "pending",
"is_forwarded": false,
"forwarding_score": 0
},
"contact": {
"whatsapp_id": "[email protected]",
"phone": "12125550120",
"lid": null,
"phone_hidden": false,
"name": "Emma Thompson",
"is_group": false,
"is_business": false
},
"organisation": {
"id": "10314",
"name": "Lumen & Wick"
}
}{
"event": "message_received",
"timestamp": "2026-10-15T10:35:48.904311+00:00",
"replayed": false,
"webhook_id": 51,
"whatsapp_client_id": "101",
"whatsapp_phone": "12125550101",
"platform": "whatsapp",
"message": {
"id": "[email protected]_3EB0A7B6C5D4E3F20109",
"type": "image",
"content": "📸 Image",
"from": "12125550122",
"from_name": "Sofia Martinez",
"to": "12125550101",
"timestamp": "2026-10-15T10:34:51+00:00",
"whatsapp_timestamp": 1792060491,
"direction": "incoming",
"status": "pending",
"is_forwarded": false,
"forwarding_score": 0,
"media": {
"filename": "",
"mimetype": "image/jpeg",
"size": 245760,
"url": "https://wbiztool-static.s3.ap-southeast-1.amazonaws.com/unibox/10314/media/false_12125550122%40c.us_3EB0A7B6C5D4E3F20109.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=…&X-Amz-Date=20261015T103548Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=…"
}
},
"contact": {
"whatsapp_id": "[email protected]",
"phone": "12125550122",
"lid": null,
"phone_hidden": false,
"name": "Sofia Martinez",
"is_group": false,
"is_business": false
},
"organisation": {
"id": "10314",
"name": "Lumen & Wick"
}
}{
"event": "message_received",
"timestamp": "2026-10-15T10:39:40.330187+00:00",
"replayed": false,
"webhook_id": 51,
"whatsapp_client_id": "101",
"whatsapp_phone": "12125550101",
"platform": "whatsapp",
"message": {
"id": "[email protected][email protected]",
"type": "chat",
"content": "Will there be a larger size?",
"from": "120363041234567890",
"from_name": "Lumen VIP Club",
"to": "12125550101",
"timestamp": "2026-10-15T10:39:02+00:00",
"whatsapp_timestamp": 1792060742,
"direction": "incoming",
"status": "pending",
"is_forwarded": false,
"forwarding_score": 0,
"sender": {
"phone": "12125550126",
"name": "Olivia Brooks",
"phone_hidden": false
}
},
"contact": {
"whatsapp_id": "[email protected]",
"phone": "120363041234567890",
"lid": null,
"phone_hidden": false,
"name": "Lumen VIP Club",
"is_group": true,
"is_business": false
},
"organisation": {
"id": "10314",
"name": "Lumen & Wick"
},
"group": {
"name": "Lumen VIP Club"
}
}Yukarıdaki numaralar, kimlikler ve adlar örnektir. Gerçek gövde tek satırlık sıkıştırılmış JSON'dur ve ASCII dışındaki her karakter (aksanlı harfler, diğer alfabeler, emoji) \uXXXX kaçışı olarak gelir; örneğin 📸 için \ud83d\udcf8. Yeni alanlar eklenebilir; kullanmadıklarınızı yok sayın.
Üst düzey alanlar#
| Alan | Tür | Açıklama |
|---|---|---|
event | string | message_received veya message_sent. |
timestamp | string | İsteğin yapıldığı zaman (ISO 8601, UTC). |
replayed | boolean | Mesaj, istekten 10 dakikadan daha eskiyse true: örneğin numara yeniden bağlandıktan sonra yapılan bir telafi gönderimi. Aksi halde false. timestamp yine isteğin zamanıdır. |
webhook_id | integer | Numaranın gelen kutusu kimliği. |
whatsapp_client_id | string | WhatsApp numaranızın kimliği; WhatsApp numaraları sayfasında ve API'de olduğu gibi. |
whatsapp_phone | string | WhatsApp numaranız, yalnızca rakamlar. |
platform | string | whatsapp veya bir Telegram hesabının sohbetleri için telegram. |
message | object | Mesaj, aşağıya bakın. |
contact | object | Sohbetin yapıldığı kişi veya grup, aşağıya bakın. |
organisation | object | Çalışma alanınız: id (string) ve name. |
group | object | Yalnızca grup sohbetleri için: name, grubun adı. |
message alanları#
| Alan | Tür | Açıklama |
|---|---|---|
id | string | WhatsApp'ın mesaj kimliği. Tekrarları atlamak için kullanın. |
type | string | Metin için chat. Aksi halde WhatsApp'ın türü; örneğin image, video, audio, ptt (sesli not), document, sticker, location, vcard (kişi kartı), poll_creation, call_log (arama) veya revoked (silinmiş mesaj). |
content | string | Bir chat mesajının metni. Aksi halde bir etiket: 📸 Image, 🎥 Video, 🎵 Audio, 🎤 Voice Message, 😊 Sticker, Document: ve belgenin metni (metin yoksa Document) ya da sözcük başları büyük harfle yazılmış tür, örneğin Location veya Call_Log. Fotoğraf ve video açıklamaları dahil edilmez. |
from | string | Her iki yönde de her zaman kişinin numarası (veya grubun kimliği). WhatsApp numarayı gizlediğinde boştur. |
from_name | string | Kişinin veya grubun adı. Boş olabilir. |
to | string | Her iki yönde de her zaman sizin WhatsApp numaranız. |
timestamp | string | Mesajın WhatsApp'ta gönderildiği zaman (ISO 8601, UTC). |
whatsapp_timestamp | integer | Aynı zaman, Unix saniyesi olarak. |
direction | string | incoming veya outgoing. Yön için from ve to yerine bunu kullanın. |
status | string | Her zaman pending: bir teslim veya okundu durumu değildir. |
is_forwarded | boolean | Mesajın iletilip iletilmediği. |
forwarding_score | integer | Şu anda her zaman 0. |
media | object | Fotoğraflar, videolar, ses, sesli notlar, belgeler ve çıkartmalar için: filename (fotoğraflarda genellikle boş), mimetype, bayt cinsinden size ve WbizTool bir kopya sakladıysa url. |
media.url | string | 3½ ila 7 gün sonra süresi dolan imzalı bir indirme bağlantısı; bu yüzden dosyayı webhook geldiğinde indirin. Bağlantıyı tam gönderildiği gibi kullanın. 15 MB'tan büyük dosyalar gibi saklanamayan dosyalarda bulunmaz. |
sender | object | Yalnızca grup sohbetleri: mesajı kimin yazdığı – name, phone (WhatsApp numarasını gizlediğinde boş) ve phone_hidden (gizlediğinde true). |
contact alanları#
| Alan | Tür | Açıklama |
|---|---|---|
whatsapp_id | string | Sohbetin WhatsApp kimliği: bir kişi için …@c.us, bir grup için …@g.us veya 62337239240946@lid gibi bir gizlilik kimliği. |
phone | string | + olmadan numara veya grubun kimliği. WhatsApp numarayı gizlediğinde boştur. |
lid | string or null | WhatsApp kullanıyorsa kişinin WhatsApp gizlilik kimliği, aksi halde null. |
phone_hidden | boolean | WhatsApp kişinin numarasını paylaşmadığında true. WhatsApp numarayı kullanılabilir hale getirdiğinde WbizTool onu doldurur. |
name | string | Kişinin adı veya grubun adı. Boş olabilir. |
is_group | boolean | Grup sohbetleri için true. |
is_business | boolean | Biliniyorsa WhatsApp Business hesapları için true. |
Zapier ve gelen kutusu numaraları#
WbizTool'un Zapier içindeki Incoming WhatsApp Message tetikleyicisi bu webhook'ları kullanır. Bir Zap'i açmak, gerekirse numarayı gelen kutusuna ekler (gelen kutusu numaralarınızdan birini kullanarak) ve webhook'unu yalnızca alınan mesajlar için, kendi gizli anahtarıyla Zapier'e yönlendirir; kartta bir Zapier rozeti görünür. Zap kapatıldığında kendi webhook URL'niz, gizli anahtarınız ve işaretleriniz geri gelir.
Ardından Webhook ayarları şu uyarıyı gösterir: "Bu webhook bir Zapier Zap’ine ait. URL’yi değiştirmek veya kaldırmak, Zap’in mesaj almasını durdurur." Durdur ve Kaldır da uyarır: Zap, Zapier'de açık kalır ama hiçbir şey almaz; bu yüzden Zap'i bunun yerine Zapier'de kapatın. Bkz. Tetikleyici gelen kutusu numaralarınızla nasıl çalışır.
Unibox eklentisi olmadan#
Sayfada "Unibox eklentisi yok" ve "Unibox eklentisi bu çalışma alanında aktif değil." yazar; Gelen kutusuna numara ekle ise Unibox eklentisi gerekli penceresini açar: "WhatsApp numaralarını ortak gelen kutusuna eklemek ve mesajlarını webhook ile almak için Unibox eklentisine abone olun." Bir Sahip Eklentileri gör'e tıklar ve ücretli veya ömür boyu bir planda (ücretsiz denemede değil) Faturalandırma ve planlar sayfasından Unibox Telefon Numarası eklentisini ekler.
Eklenti sona erdiğinde veya bir numaranın bağlantısı kesildiğinde#
- Eklenti sona erer: her gelen kutusu numarası hemen veya yaklaşık bir saat içinde durdurulur. Kartlarda "Unibox eklentisi bu çalışma alanında aktif olmadığı için durduruldu." notuyla Durduruldu görünür. Sahiplere ve Editörlere hangi gelen kutularının durduğu, faturalandırma e-postasında veya "… çalışma alanının bazı numaraları veya özellikleri durdu" uyarısında bildirilir (Bildirimler içinde Numara ve gönderim sorunları). Sohbetler, webhook URL'leri ve gizli anahtarlar korunur: eklenti geri geldiğinde her numarada Başlat'a tıklayın. Durdurulduğu süredeki mesajlar daha sonra 30 güne kadar geriye gelen kutusuna eklenir ama webhook'unuza gönderilmez.
- Eklenti, açık olan numaralardan azını kapsar: "Eklentinizin izin verdiğinden daha fazla numara açık. En yeni fazla numaralar yaklaşık bir saat içinde otomatik olarak durdurulur."
- Numaranın bağlantısı kesilir: kartta Numaranın bağlantısı kesildi görünür ve hiçbir şey senkronize edilmez veya gönderilmez. Yeniden bağladıktan sonra bu sırada gelen mesajlar da alınır ve gönderilir; 10 dakikadan eski olanlarda
replayeddeğeritrueolur. - Numara farklı bir telefonla yeniden bağlanır: gelen kutusu numarası ve webhook'u o andan itibaren yeni numara için devam eder (aynı
whatsapp_client_id, yeniwhatsapp_phone); eski sohbetler gelen kutusunda geçmiş olarak kalır.
Sorun giderme#
| Mesaj veya sorun | Ne yapmalı |
|---|---|
| Unibox eklentisi gerekli veya "Bunun için Unibox eklentisi gerekir." | Bir Sahip'ten Unibox eklentisini eklemesini isteyin, bkz. Unibox eklentisi olmadan. |
| "Tüm gelen kutusu numaralarınız kullanımda. Önce birini durdurun veya kaldırın ya da Unibox eklentisine daha fazla numara ekleyin." | İhtiyacınız olmayan bir numarayı durdurun veya kaldırın ya da eklentinin adedini artırın. Durdurulmuş numaralar sayılmaz. |
| "Eklenebilecek boşta bağlı WhatsApp numarası yok." | Bağlı her numara zaten gelen kutusunda ya da hiçbiri QR veya eşleştirme koduyla bağlı değil. Bir numara bağlayın'a tıklayın. |
| "Bu numara artık bağlı değil. Yeniden bağlayın veya başka bir numara seçin." | Numarayı WhatsApp numaraları sayfasında yeniden bağlayın, sonra tekrar deneyin. |
| "https:// ile başlayan tam bir adres girin" veya "Webhook URL’si https:// ile başlamalıdır" | Bir https:// adresi kullanın; http:// kabul edilmez. |
| "Adres en fazla 500 karakter olabilir." | Daha kısa bir URL kullanın, örneğin uzun bir sorgu dizesi olmadan. |
| "Webhook URL’si herkese açık bir internet adresini göstermelidir." | Ana makine localhost, özel bir ağ adresi ya da çözümlenemiyor. Herkese açık bir adres veya test sırasında bir tünel kullanın. |
| Kenar çubuğunda Gelen kutusu numaraları yok veya "Bunu yalnızca çalışma alanı sahibi veya bir editör yapabilir." | Analistsiniz. Bir Sahip'ten sizi Editör yapmasını isteyin, bkz. Roller ve izinler. |
| Hiç webhook gelmiyor | Kartta Senkronize ediliyor göründüğünü, URL'nin doğru olduğunu ve Gönderilecek mesajlar altında kutunun işaretli olduğunu kontrol edin. Sunucunuz geçerli bir sertifikayla 8 saniye içinde 2xx yanıtı vermelidir. Gelen kutusu yanıtları gönderilmez. |
| Bazı webhook'lar eksik | Sunucunuz 4xx veya 3xx yanıtı verdi, 3 yeniden denemenin hepsinde başarısız oldu ya da ana makinesi çözümlenemedi. Eksik mesajın zamanındaki sunucu günlüklerine bakın. Numara durdurulmuşken gelen mesajlar gönderilmez: bunları gelen kutusunda okuyun. |
| İmza eşleşmiyor | Yeniden kodlanmış JSON'u değil ham gövdeyi ve geçerli gizli anahtarı kullanın. Numarayı bir Zap kullanırken istekler Zapier'in gizli anahtarıyla Zapier'e gider. |
| Bir medya bağlantısı hata veriyor | Bağlantının süresi dolmuş. Dosyaları webhook geldiğinde indirin. |
İlgili sayfalar#
- Unibox gelen kutusu: gelen kutusu numaralarınızın sohbetlerini okuyun ve yanıtlayın
- Zapier entegrasyonu
- WhatsApp numaranızı bağlayın
- Planlar ve faturalandırma
- Mesaj gönderme API'si:
webhookalanı, gönderdiğiniz bir mesajın gidip gitmediğini bildirir (farklı bir webhook)



