Panduan produk
Nomor kotak masuk dan webhook pesan masuk
Di halaman Nomor kotak masuk, Anda memilih nomor WhatsApp mana yang tersinkron ke kotak masuk Unibox, tempat tim Anda membaca dan membalas chat-nya. Beri sebuah nomor URL webhook, dan WbizTool juga mengirim setiap pesan baru yang diterima atau dikirim nomor tersebut ke server Anda sebagai JSON bertanda tangan: catat percakapan di CRM, beri tahu tim Anda, atau jalankan balasan otomatis.
Sedang membuat penerimanya? Buka Cara webhook dikirim, Memverifikasi tanda tangan, dan Payload.
Siapa yang dapat melakukannya: Pemilik dan Editor dapat menambahkan nomor, mengubah webhook, dan melihat secret webhook. Analis tidak melihat Nomor kotak masuk di sidebar. Fitur ini memerlukan add-on Unibox: $20 per bulan atau $200 per tahun dengan harga daftar AS untuk setiap nomor di kotak masuk (harga Anda tampil di Tagihan & paket), yang ditambahkan ke paket berbayar atau lifetime oleh Pemilik di Tagihan & paket (lihat Add-on). Jumlah add-on menentukan berapa nomor yang dapat berada di kotak masuk sekaligus.
Buka Nomor kotak masuk di bawah Kotak masuk di sidebar, atau buka /unibox/listeners/.
Sebelum memulai#
- Add-on Unibox dengan nomor kotak masuk yang masih tersedia: baris di bawah judul halaman menyebutkan, misalnya, "2 dari 3 nomor kotak masuk digunakan (add-on Unibox)", atau "Tidak ada add-on Unibox" (lihat Tanpa add-on Unibox).
- Nomor WhatsApp yang terhubung dengan kode QR atau kode penautan, yang menampilkan Terhubung di Nomor WhatsApp. Nomor yang terhubung melalui ekstensi browser tidak dapat ditambahkan. Akun Telegram yang terhubung dapat ditambahkan seperti nomor.
- Untuk webhook: alamat
https://maksimal 500 karakter di internet publik (bukanlocalhostatau jaringan privat) yang menerima permintaanPOSTdengan body JSON dan menjawab2xxdalam 8 detik.
Menambahkan nomor ke kotak masuk#
Buka dialog
Klik Tambahkan nomor ke kotak masuk di kanan atas halaman.
Pilih nomor
Pilih di bawah Nomor WhatsApp. Daftar menampilkan nomor Anda yang terhubung dan belum ada di kotak masuk.
Tambahkan webhook (opsional)
Tambahkan
Klik Tambahkan nomor. Anda akan melihat "Nomor ditambahkan – chat-nya mulai tersinkron dalam beberapa menit." Jika Anda memasukkan URL webhook, Secret webhook Anda terbuka: klik Salin dan simpan secret di tempat yang dapat dibaca server Anda. Anda dapat menampilkannya lagi nanti di Pengaturan webhook.
- Hanya pesan baru. Nomor tersinkron sejak Anda menambahkannya: pesan lama tidak diimpor atau dikirim.
- Semua nomor sedang digunakan? Dialog menyebutkan "Semua nomor kotak masuk Anda sedang digunakan. Hentikan atau hapus salah satunya, atau tambah kapasitas add-on Unibox." Hentikan atau hapus sebuah nomor, atau minta Pemilik menaikkan jumlah add-on (Lihat add-on).
- Menambahkan kembali nomor yang dihapus mengembalikan kotak masuknya ("Nomor ditambahkan kembali – chat-nya tersinkron lagi mulai sekarang."); pesan dari masa nomor dihapus tidak diambil. Dengan URL webhook, nomor tetap memakai secret sebelumnya jika ada (gunakan Tampilkan di Pengaturan webhook); jika tidak, Secret webhook Anda terbuka dengan secret baru.
Isi kartu nomor#
Setiap kartu menampilkan nomornya, kapan WbizTool terakhir memeriksanya untuk pesan ("Terakhir diperiksa 1 menit lalu", atau Belum pernah diperiksa), Pesan dan Kontak tersinkron (setiap chat yang tersinkron dari nomor tersebut, termasuk yang tidak memiliki pesan di kotak masuk), Pesan terakhir, dan Webhook: URL dan apa yang dikirimnya, seperti "Mengirim setiap pesan yang diterima dan dikirim · ditandatangani dengan secret", atau "Tidak ada – pesan hanya tampil di kotak masuk." Lencana Zapier berarti sebuah Zap menerima pesan-pesannya (lihat Zapier dan nomor kotak masuk).
Lencana di kanan atas menunjukkan apa yang sedang dilakukan nomor tersebut:
| Lencana | Arti |
|---|---|
| Menyinkronkan | Diperiksa sekitar sekali per menit; pesan baru sampai ke kotak masuk dan webhook Anda. |
| Belum diperiksa akhir-akhir ini | "Tidak diperiksa dalam 15 menit terakhir – misalnya saat nomor sedang mengirim kampanye, yang menjeda pemeriksaan kotak masuk. Jika berlanjut, hubungi dukungan." Pesan diambil setelah pengiriman selesai. |
| Nomor terputus | "Nomor WhatsApp terputus, jadi tidak ada pesan baru yang masuk." Klik Hubungkan kembali. |
| Dihentikan | Dihentikan oleh Anda, atau oleh WbizTool saat add-on berakhir atau mencakup lebih sedikit nomor (lihat Saat add-on berakhir). Tidak ada yang tersinkron atau dikirim. |
| Tertunda | "Ditambahkan (mis. oleh Zapier) saat nomor sedang offline. Nomor tidak tersinkron sampai dimulai." Hubungkan kembali nomor jika perlu, lalu klik Mulai. |
Mengubah URL webhook atau pesan yang dikirim#
Buka pengaturan webhook
Klik Pengaturan webhook di kartu nomor.
Ubah pengaturan
Edit URL webhook (opsional) dan centang di bawah Pesan yang dikirim ke webhook. Untuk menonaktifkan webhook, kosongkan URL.
Simpan
- Mengubah URL tetap mempertahankan secret. Mengosongkan URL menghapusnya; URL yang ditambahkan kemudian mendapat secret baru, yang ditampilkan sekali di Secret webhook Anda.
- Jika tidak ada kotak yang dicentang, kartu bertuliskan "Tidak ada event yang dipilih – tidak ada yang dikirim".
Menampilkan atau membuat ulang secret#
Secret terdiri dari 32 huruf dan angka. Di Pengaturan webhook, di bawah Secret webhook, Tampilkan memperlihatkannya dengan Salin di sebelahnya. Buat ulang menanyakan "Buat secret baru? Secret saat ini langsung berhenti berfungsi – perbarui di mana pun Anda memeriksa tanda tangan." Klik Buat secret baru: secret langsung disimpan ("Secret baru dibuat."), tanpa Simpan, dan setiap permintaan sejak saat itu ditandatangani dengannya, termasuk percobaan ulang pesan sebelumnya.
Menghentikan, memulai, atau menghapus nomor#
| Tombol | Yang terjadi |
|---|---|
| Hentikan | Setelah Anda mengonfirmasi, chat-nya berhenti tersinkron dan tidak ada yang dikirim. Nomor tidak lagi memakai salah satu nomor kotak masuk Anda; pengaturannya disimpan. |
| Mulai | Nomor tersinkron dan mengirim lagi, menggunakan salah satu nomor kotak masuk Anda. Pesan yang masuk selama nomor dihentikan ditambahkan ke kotak masuk, hingga 30 hari ke belakang, tetapi tidak dikirim: webhook Anda hanya menerima pesan sejak Anda mengklik Mulai. Setelah penghentian kurang dari satu jam, pesan-pesan itu juga dikirim. Mulai berwarna abu-abu tanpa add-on ("Memerlukan add-on Unibox") atau tanpa nomor kotak masuk yang tersedia ("Semua nomor kotak masuk Anda sedang digunakan – hentikan atau hapus nomor lain terlebih dahulu"). |
| Hapus | Menanyakan "Hapus … dari kotak masuk?" Chat-nya berhenti tersinkron dan webhook-nya dinonaktifkan; percakapan yang sudah tersinkron tetap ada di kotak masuk. Tambahkan lagi untuk mengembalikannya. |
Webhook yang menunggu percobaan ulang dibuang saat Anda menghentikan atau menghapus nomor atau mengubah URL-nya.
Cara webhook dikirim#
- Kapan: setiap nomor kotak masuk diperiksa sekitar sekali per menit selama terhubung; pemeriksaan dijeda saat nomor mengirim pesan, seperti kampanye. Pesan dikirim setelah pemeriksaan yang menemukannya, biasanya dalam satu atau dua menit. Tidak ada tombol uji: kirim pesan ke nomor tersebut dari ponsel lain.
- Satu permintaan per pesan:
message_receiveduntuk Pesan diterima;message_sentuntuk Pesan dikirim, yang dikirim dari ponsel, WhatsApp Web, atau oleh WbizTool (kampanye, API, pengingat). Balasan yang dikirim dari kotak masuk Unibox biasanya tidak dikirim ke webhook: kotak masuk sudah memilikinya. - Berhasil: status
2xxapa pun dalam 8 detik. Pengalihan tidak diikuti:3xxdihitung sebagai kegagalan. - Percobaan ulang: timeout, kesalahan koneksi,
429, atau5xxdicoba ulang 3 kali, setelah 30 detik, 1 menit, dan 2 menit. Jawaban lain, seperti400atau404, dan sertifikat TLS yang tidak valid tidak dicoba ulang. 410 Gone: WbizTool menonaktifkan webhook nomor tersebut (URL dan secret dihapus; untuk hook Zapier, webhook Anda sendiri sebelumnya kembali). Nomor tetap tersinkron ke kotak masuk.- Urutan dan duplikat: permintaan dapat tiba tidak berurutan dan, meski jarang, dua kali. Urutkan berdasarkan
message.whatsapp_timestampdan lewatimessage.idyang sudah Anda tangani untukwhatsapp_client_idyang sama. Jika dua nomor Anda ada di satu grup, masing-masing mengirim salinannya sendiri. - Pesan terlambat: pesan yang terambil terlambat, misalnya setelah nomor terhubung kembali atau setelah jeda pemeriksaan, tetap dikirim, dengan
replayedbernilaitruejika usianya lebih dari 10 menit. Pesan yang masuk selama nomor dihentikan tidak dikirim setelah Mulai (lihat Menghentikan, memulai, atau menghapus nomor). - Pemeriksaan alamat: URL diperiksa lagi sebelum setiap permintaan; host yang kini mengarah ke jaringan privat, atau tidak dapat di-resolve, tidak dikirimi, dan pesan itu tidak dicoba ulang.
Header#
| Header | Nilai |
|---|---|
Content-Type | application/json |
X-Wbiztool-Event | message_received atau message_sent |
X-Wbiztool-Timestamp | Kapan permintaan dibuat, dalam ISO 8601 UTC. Sama dengan timestamp di body. |
X-Wbiztool-Webhook-Id | ID kotak masuk nomor tersebut. Sama dengan webhook_id di body. |
X-Wbiztool-Signature | sha256= diikuti tanda tangan (lihat Memverifikasi tanda tangan). |
Memverifikasi tanda tangan#
Setiap permintaan ditandatangani dengan secret webhook nomor tersebut menggunakan HMAC-SHA256 atas body permintaan mentah persis seperti yang diterima. Digest hex huruf kecil dikirim di X-Wbiztool-Signature sebagai sha256=<digest>. Webhook yang diatur di halaman Nomor kotak masuk selalu memiliki secret, jadi header ini selalu ada.
Hitung tanda tangan dari byte mentah sebelum Anda mem-parsing JSON. Mem-parsing lalu meng-encode ulang body akan mengubahnya (spasi, karakter yang di-escape), dan tanda tangan tidak akan cocok.
// 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);Untuk menguji penerima Anda sebelum pesan sungguhan tiba, tandatangani sendiri sebuah body lalu kirimkan:
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"
Tanda tangan mencakup body, termasuk timestamp-nya, yang baru di setiap percobaan. Untuk menolak permintaan yang diputar ulang, tolak timestamp yang berumur lebih dari 5 menit dan lewati message.id yang sudah Anda tangani.
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"
}
}Nomor, ID, dan nama di atas hanyalah contoh. Body yang sebenarnya berupa satu baris JSON ringkas, dan setiap karakter non-ASCII (huruf beraksen, aksara lain, emoji) tiba sebagai escape \uXXXX, seperti \ud83d\udcf8 untuk 📸. Field lain dapat ditambahkan; abaikan field yang tidak Anda gunakan.
Field tingkat atas#
| Field | Tipe | Deskripsi |
|---|---|---|
event | string | message_received atau message_sent. |
timestamp | string | Kapan permintaan dibuat (ISO 8601, UTC). |
replayed | boolean | true jika pesan lebih dari 10 menit lebih lama daripada permintaan: pengiriman susulan, misalnya setelah nomor terhubung kembali. Jika tidak, false. timestamp tetap waktu permintaan. |
webhook_id | integer | ID kotak masuk nomor tersebut. |
whatsapp_client_id | string | ID nomor WhatsApp Anda, seperti di Nomor WhatsApp dan di API. |
whatsapp_phone | string | Nomor WhatsApp Anda, hanya digit. |
platform | string | whatsapp, atau telegram untuk chat akun Telegram. |
message | object | Pesan, lihat di bawah. |
contact | object | Orang atau grup lawan chat, lihat di bawah. |
organisation | object | Workspace Anda: id (string) dan name. |
group | object | Hanya untuk chat grup: name, nama grup. |
Field message#
| Field | Tipe | Deskripsi |
|---|---|---|
id | string | ID WhatsApp untuk pesan. Gunakan untuk melewati duplikat. |
type | string | chat untuk teks. Selain itu, tipe dari WhatsApp, seperti image, video, audio, ptt (pesan suara), document, sticker, location, vcard (kartu kontak), poll_creation, call_log (panggilan), atau revoked (pesan yang dihapus). |
content | string | Teks pesan chat. Selain itu, sebuah label: 📸 Image, 🎥 Video, 🎵 Audio, 🎤 Voice Message, 😊 Sticker, Document: diikuti teks dokumen (Document jika tidak ada), atau nama tipe dengan huruf kapital di awal kata, seperti Location atau Call_Log. Keterangan foto dan video tidak disertakan. |
from | string | Selalu nomor kontak (atau ID grup), di kedua arah. Kosong jika WhatsApp menyembunyikan nomornya. |
from_name | string | Nama kontak atau grup. Bisa kosong. |
to | string | Selalu nomor WhatsApp Anda, di kedua arah. |
timestamp | string | Kapan pesan dikirim di WhatsApp (ISO 8601, UTC). |
whatsapp_timestamp | integer | Waktu yang sama dalam detik Unix. |
direction | string | incoming atau outgoing. Gunakan field ini, bukan from dan to, untuk mengetahui arah pesan. |
status | string | Selalu pending: bukan status terkirim atau dibaca. |
is_forwarded | boolean | Apakah pesan diteruskan. |
forwarding_score | integer | Saat ini selalu 0. |
media | object | Untuk foto, video, audio, pesan suara, dokumen, dan stiker: filename (sering kosong untuk foto), mimetype, size dalam byte, dan, jika WbizTool menyimpan salinannya, url. |
media.url | string | Tautan unduhan bertanda tangan yang kedaluwarsa – setelah 3½ hingga 7 hari – jadi unduh file saat webhook tiba. Gunakan persis seperti yang dikirim. Tidak ada jika file tidak dapat disimpan, seperti file di atas 15 MB. |
sender | object | Hanya chat grup: siapa yang menulis pesan – name, phone (kosong jika WhatsApp menyembunyikan nomornya), dan phone_hidden (true jika nomornya disembunyikan). |
Field contact#
| Field | Tipe | Deskripsi |
|---|---|---|
whatsapp_id | string | ID WhatsApp chat: …@c.us untuk orang, …@g.us untuk grup, atau ID privasi seperti 62337239240946@lid. |
phone | string | Nomor tanpa +, atau ID grup. Kosong jika WhatsApp menyembunyikan nomornya. |
lid | string or null | ID privasi WhatsApp untuk kontak, jika WhatsApp menggunakannya, jika tidak null. |
phone_hidden | boolean | true jika WhatsApp tidak membagikan nomor kontak. WbizTool mengisi nomornya saat WhatsApp menyediakannya. |
name | string | Nama kontak atau nama grup. Bisa kosong. |
is_group | boolean | true untuk chat grup. |
is_business | boolean | true untuk akun WhatsApp Business, jika diketahui. |
Zapier dan nomor kotak masuk#
Pemicu Incoming WhatsApp Message WbizTool di Zapier menggunakan webhook ini. Mengaktifkan Zap menambahkan nomor ke kotak masuk jika perlu (menggunakan salah satu nomor kotak masuk Anda) dan mengarahkan webhook-nya ke Zapier, hanya untuk pesan yang diterima, dengan secret-nya sendiri; kartu menampilkan lencana Zapier. URL webhook, secret, dan centang Anda sendiri kembali saat Zap dinonaktifkan.
Pengaturan webhook kemudian memperingatkan: "Webhook ini milik sebuah Zap Zapier. Mengubah atau menghapus URL membuat Zap berhenti menerima pesan." Hentikan dan Hapus juga memperingatkan: Zap tetap aktif di Zapier tetapi tidak menerima apa pun, jadi nonaktifkan Zap di Zapier saja. Lihat Cara pemicu bekerja dengan nomor kotak masuk Anda.
Tanpa add-on Unibox#
Halaman menampilkan "Tidak ada add-on Unibox" dan "Add-on Unibox tidak aktif di workspace ini.", dan Tambahkan nomor ke kotak masuk membuka Add-on Unibox diperlukan: "Untuk menambahkan nomor WhatsApp ke kotak masuk bersama dan menerima pesannya lewat webhook, berlangganan add-on Unibox." Pemilik mengklik Lihat add-on dan menambahkan add-on Nomor Telepon Unibox di Tagihan & paket, pada paket berbayar atau lifetime (bukan uji coba gratis).
Saat add-on berakhir atau nomor terputus#
- Add-on berakhir: setiap nomor kotak masuk dihentikan, langsung atau dalam sekitar satu jam. Kartu menampilkan Dihentikan dengan "Dihentikan karena add-on Unibox tidak aktif di workspace ini." Pemilik dan Editor diberi tahu kotak masuk mana yang berhenti, di email tagihan atau di peringatan "Beberapa nomor atau fitur … berhenti" (Masalah nomor & pengiriman di Notifikasi). Percakapan, URL webhook, dan secret disimpan: setelah add-on aktif kembali, klik Mulai pada setiap nomor. Pesan dari masa nomor dihentikan lalu ditambahkan ke kotak masuk, hingga 30 hari ke belakang, tetapi tidak dikirim ke webhook Anda.
- Add-on mencakup lebih sedikit nomor daripada yang aktif: "Nomor yang aktif melebihi batas add-on Anda. Nomor tambahan terbaru dihentikan otomatis dalam sekitar satu jam."
- Nomor terputus: kartu menampilkan Nomor terputus dan tidak ada yang tersinkron atau dikirim. Setelah Anda menghubungkannya kembali, pesan yang masuk selama itu juga diambil dan dikirim; pesan yang berusia lebih dari 10 menit memiliki
replayedbernilaitrue. - Nomor dihubungkan kembali dengan ponsel lain: nomor kotak masuk dan webhook-nya berlanjut untuk nomor baru (
whatsapp_client_idsama,whatsapp_phonebaru) sejak saat itu; chat lama tetap ada di kotak masuk sebagai riwayat.
Pemecahan masalah#
| Pesan atau masalah | Yang harus dilakukan |
|---|---|
| Add-on Unibox diperlukan, atau "Ini memerlukan add-on Unibox." | Minta Pemilik menambahkan add-on Unibox, lihat Tanpa add-on Unibox. |
| "Semua nomor kotak masuk Anda sedang digunakan. Hentikan atau hapus salah satunya terlebih dahulu, atau tambah kapasitas add-on Unibox." | Hentikan atau hapus nomor yang tidak Anda perlukan, atau naikkan jumlah add-on. Nomor yang dihentikan tidak dihitung. |
| "Tidak ada nomor WhatsApp terhubung yang dapat ditambahkan." | Setiap nomor yang terhubung sudah ada di kotak masuk, atau tidak ada yang terhubung dengan kode QR atau kode penautan. Klik Hubungkan nomor. |
| "Nomor ini sudah tidak terhubung. Hubungkan kembali, atau pilih nomor lain." | Hubungkan kembali di Nomor WhatsApp, lalu coba lagi. |
| "Masukkan alamat lengkap yang diawali https://" atau "URL webhook harus diawali https://" | Gunakan alamat https://; http:// tidak diterima. |
| "Alamat maksimal 500 karakter." | Gunakan URL yang lebih pendek, misalnya tanpa query yang panjang. |
| "URL webhook harus mengarah ke alamat internet publik." | Host-nya localhost, alamat jaringan privat, atau tidak dapat di-resolve. Gunakan alamat publik, atau tunnel saat menguji. |
| Tidak ada Nomor kotak masuk di sidebar, atau "Hanya pemilik workspace atau editor yang dapat melakukan ini." | Anda adalah Analis. Minta Pemilik menjadikan Anda Editor, lihat Peran dan izin. |
| Tidak ada webhook yang tiba | Pastikan kartu menampilkan Menyinkronkan, URL-nya benar, dan kotaknya dicentang di bawah Pesan yang dikirim ke webhook. Server Anda harus menjawab 2xx dalam 8 detik, dengan sertifikat yang valid. Balasan dari kotak masuk tidak dikirim ke webhook. |
| Beberapa webhook hilang | Server Anda menjawab 4xx atau 3xx, gagal di ketiga percobaan ulang, atau host-nya tidak dapat di-resolve. Periksa log server pada waktu pesan yang hilang. Pesan yang masuk selama nomor dihentikan tidak dikirim: baca pesan tersebut di kotak masuk. |
| Tanda tangan tidak cocok | Gunakan body mentah, bukan JSON yang di-encode ulang, dan secret saat ini. Selama sebuah Zap menggunakan nomor tersebut, permintaan dikirim ke Zapier dengan secret Zapier. |
| Tautan media mengembalikan error | Tautannya sudah kedaluwarsa. Unduh file saat webhook tiba. |
Terkait#
- Kotak masuk Unibox: baca dan balas chat dari nomor kotak masuk Anda
- Integrasi Zapier
- Hubungkan nomor WhatsApp Anda
- Paket dan tagihan
- API Kirim Pesan: field
webhook-nya melaporkan apakah pesan yang Anda kirim sudah terkirim (webhook yang berbeda)



