İçeriğe geç
WbizTool

Ü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.

Tarayıcı penceresinde Gelen kutusu numaraları sayfası, kenar çubuğunda Gelen kutusu numaraları seçili: 2 / 3 gelen kutusu numarası kullanımda, Webhook rehberi bağlantısı, Gelen kutusuna numara ekle düğmesi ve biri kendi webhook'una, diğeri bir Zapier Zap'ine gönderen iki numara kartı

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 (localhost veya özel bir ağda değil), en fazla 500 karakterlik, JSON gövdeli POST isteklerini kabul eden ve 8 saniye içinde 2xx ile yanıt veren bir https:// adresi.

Gelen kutusuna numara ekleyin#

  1. Pencereyi açın

    Sayfanın sağ üstündeki Gelen kutusuna numara ekle'ye tıklayın.

  2. Numarayı seçin

    WhatsApp numarası altından seçin. Liste, henüz gelen kutusunda olmayan bağlı numaralarınızı gösterir.

  3. Webhook ekleyin (isteğe bağlı)

    Adresinizi Webhook URL’si (isteğe bağlı) altına yazın. Ardından Gönderilecek mesajlar görünür: Alınan mesajlar, Gönderilen mesajlar veya ikisi birden işaretli kalsın. Webhook'u daha sonra ekleyebilir veya değiştirebilirsiniz.

    Gelen kutusuna numara ekle penceresi: 2 / 3 gelen kutusu numarası kullanımda, WhatsApp numarası altında seçili Toptan satış numarası (2), yazılmış bir webhook URL'si (3), işaretli Alınan mesajlar ve Gönderilen mesajlar, çerçeveli Numara ekle düğmesi (4)
  4. 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:

RozetAnlamı
Senkronize ediliyorYaklaşı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.
DurdurulduSizin 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#

  1. Webhook ayarlarını açın

    Numaranın kartında Webhook ayarları'na tıklayın.

  2. 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.

  3. Kaydedin

    Kaydet'e tıklayın. "Webhook ayarları kaydedildi." mesajını görürsünüz.

    Webhook – Mağaza siparişleri penceresi: webhook URL'si (2), Alınan mesajlar işaretli ve Gönderilen mesajlar işaretsiz Gönderilecek mesajlar, Göster ve Yeniden oluştur ile gizlenmiş Webhook gizli anahtarı, çerçeveli Kaydet düğmesi (3)
  • 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üğmeNe olur
DurdurOnayladıktan sonra sohbetlerinin senkronizasyonu durur ve hiçbir şey gönderilmez. Artık gelen kutusu numaralarınızdan birini kullanmaz; ayarları korunur.
BaşlatYeniden 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çin message_sent. Unibox gelen kutusundan gönderilen yanıtlar genellikle gönderilmez: gelen kutusunda zaten vardır.
  • Başarı: 8 saniye içinde herhangi bir 2xx durumu. Yönlendirmeler izlenmez: 3xx başarısız sayılır.
  • Yeniden denemeler: zaman aşımı, bağlantı hatası, 429 veya 5xx 30 saniye, 1 dakika ve 2 dakika sonra olmak üzere 3 kez yeniden denenir. 400 veya 404 gibi 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_timestamp değerine göre sıralayın ve aynı whatsapp_client_id için işlediğiniz bir message.id değ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 replayed değeri true olur. 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ıkDeğer
Content-Typeapplication/json
X-Wbiztool-Eventmessage_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-IdNumaranın gelen kutusu kimliği. Gövdedeki webhook_id ile aynıdır.
X-Wbiztool-Signaturesha256= 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);

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)#

Örnek webhook gövdeleri
{
  "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"
  }
}

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#

AlanTürAçıklama
eventstringmessage_received veya message_sent.
timestampstringİsteğin yapıldığı zaman (ISO 8601, UTC).
replayedbooleanMesaj, 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_idintegerNumaranın gelen kutusu kimliği.
whatsapp_client_idstringWhatsApp numaranızın kimliği; WhatsApp numaraları sayfasında ve API'de olduğu gibi.
whatsapp_phonestringWhatsApp numaranız, yalnızca rakamlar.
platformstringwhatsapp veya bir Telegram hesabının sohbetleri için telegram.
messageobjectMesaj, aşağıya bakın.
contactobjectSohbetin yapıldığı kişi veya grup, aşağıya bakın.
organisationobjectÇalışma alanınız: id (string) ve name.
groupobjectYalnızca grup sohbetleri için: name, grubun adı.

message alanları#

AlanTürAçıklama
idstringWhatsApp'ın mesaj kimliği. Tekrarları atlamak için kullanın.
typestringMetin 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).
contentstringBir 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.
fromstringHer iki yönde de her zaman kişinin numarası (veya grubun kimliği). WhatsApp numarayı gizlediğinde boştur.
from_namestringKişinin veya grubun adı. Boş olabilir.
tostringHer iki yönde de her zaman sizin WhatsApp numaranız.
timestampstringMesajın WhatsApp'ta gönderildiği zaman (ISO 8601, UTC).
whatsapp_timestampintegerAynı zaman, Unix saniyesi olarak.
directionstringincoming veya outgoing. Yön için from ve to yerine bunu kullanın.
statusstringHer zaman pending: bir teslim veya okundu durumu değildir.
is_forwardedbooleanMesajın iletilip iletilmediği.
forwarding_scoreintegerŞu anda her zaman 0.
mediaobjectFotoğ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.urlstring3½ 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.
senderobjectYalnızca grup sohbetleri: mesajı kimin yazdığı – name, phone (WhatsApp numarasını gizlediğinde boş) ve phone_hidden (gizlediğinde true).

contact alanları#

AlanTürAçıklama
whatsapp_idstringSohbetin WhatsApp kimliği: bir kişi için …@c.us, bir grup için …@g.us veya 62337239240946@lid gibi bir gizlilik kimliği.
phonestring+ olmadan numara veya grubun kimliği. WhatsApp numarayı gizlediğinde boştur.
lidstring or nullWhatsApp kullanıyorsa kişinin WhatsApp gizlilik kimliği, aksi halde null.
phone_hiddenbooleanWhatsApp kişinin numarasını paylaşmadığında true. WhatsApp numarayı kullanılabilir hale getirdiğinde WbizTool onu doldurur.
namestringKişinin adı veya grubun adı. Boş olabilir.
is_groupbooleanGrup sohbetleri için true.
is_businessbooleanBiliniyorsa 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.

Eklentisiz Gelen kutusu numaraları sayfası: Unibox eklentisi yok, Eklentileri gör düğmesi çerçeveli Unibox eklentisi bu çalışma alanında aktif değil sarı uyarısı ve Gelen kutusunda henüz numara yok

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 replayed değeri true olur.
  • 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, yeni whatsapp_phone); eski sohbetler gelen kutusunda geçmiş olarak kalır.

Sorun giderme#

Mesaj veya sorunNe 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 gelmiyorKartta 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 eksikSunucunuz 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şmiyorYeniden 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 veriyorBağlantının süresi dolmuş. Dosyaları webhook geldiğinde indirin.

İlgili sayfalar#