Panduan produk
Nombor peti masuk dan webhook mesej masuk
Di halaman Nombor peti masuk anda memilih nombor WhatsApp yang mana disegerakkan ke dalam peti masuk Unibox, tempat pasukan anda membaca dan menjawab sembangnya. Berikan sesuatu nombor URL webhook, dan WbizTool juga menghantar setiap mesej baharu yang diterima atau dihantar oleh nombor itu ke pelayan anda sebagai JSON bertandatangan: rekod perbualan dalam CRM, maklumkan pasukan anda atau jalankan balasan automatik.
Sedang membina penerimanya? Pergi ke Cara webhook dihantar, Sahkan tandatangan dan Payload.
Siapa yang boleh melakukannya: Pemilik dan Editor boleh menambah nombor, mengubah webhook dan melihat rahsia webhook. Penganalisis tidak melihat Nombor peti masuk dalam bar sisi. Ia memerlukan tambahan Unibox: $20 sebulan atau $200 setahun pada harga senarai AS bagi setiap nombor dalam peti masuk (harga anda ditunjukkan di Bil & pelan), yang ditambah pada pelan berbayar atau seumur hidup oleh Pemilik di Bil & pelan (lihat Tambahan). Kuantitinya ialah bilangan nombor yang boleh berada dalam peti masuk pada satu masa.
Buka Nombor peti masuk di bawah Peti masuk dalam bar sisi, atau pergi ke /unibox/listeners/.
Sebelum anda bermula#
- Tambahan Unibox dengan nombor peti masuk yang masih kosong: baris di bawah tajuk halaman menyatakan, contohnya, "2 daripada 3 nombor peti masuk digunakan (tambahan Unibox)", atau "Tiada tambahan Unibox" (lihat Tanpa tambahan Unibox).
- Nombor WhatsApp yang disambungkan dengan kod QR atau kod pautan, yang menunjukkan Disambungkan di Nombor WhatsApp. Nombor yang disambungkan melalui sambungan pelayar tidak boleh ditambah. Akaun Telegram yang disambungkan boleh ditambah seperti nombor.
- Untuk webhook: alamat
https://paling banyak 500 aksara di internet awam (bukanlocalhostatau rangkaian peribadi) yang menerima permintaanPOSTdengan badan JSON dan menjawab2xxdalam masa 8 saat.
Tambah nombor ke peti masuk#
Buka dialog
Klik Tambah nombor ke peti masuk di bahagian atas kanan halaman.
Pilih nombor
Pilih nombor di bawah Nombor WhatsApp. Senarai menunjukkan nombor anda yang disambungkan dan belum berada dalam peti masuk.
Tambah webhook (pilihan)
Tambahkannya
Klik Tambah nombor. Anda akan melihat "Nombor ditambah – sembangnya mula disegerakkan dalam beberapa minit." Jika anda memasukkan URL webhook, Rahsia webhook anda dibuka: klik Salin dan simpan rahsia itu di tempat yang boleh dibaca oleh pelayan anda. Anda boleh menunjukkannya semula kemudian dalam Tetapan webhook.
- Mesej baharu sahaja. Nombor disegerakkan dari saat anda menambahnya: mesej lama tidak diimport atau dihantar.
- Semua nombor sedang digunakan? Dialog menyatakan "Semua nombor peti masuk anda sedang digunakan. Hentikan atau alih keluar satu, atau tambah lagi pada tambahan Unibox." Hentikan atau alih keluar sesuatu nombor, atau minta Pemilik menaikkan kuantiti tambahan (Lihat tambahan).
- Menambah semula nombor yang dialih keluar mengembalikan peti masuknya ("Nombor ditambah semula – sembangnya disegerakkan semula mulai sekarang."); mesej dari tempoh ia dialih keluar tidak diambil. Dengan URL webhook, ia mengekalkan rahsia terdahulunya jika ada (gunakan Tunjukkan dalam Tetapan webhook); jika tidak, Rahsia webhook anda dibuka dengan rahsia baharu.
Apa yang ditunjukkan oleh kad nombor#
Setiap kad menunjukkan nombor itu, bila WbizTool terakhir menyemaknya untuk mesej ("Terakhir disemak 1 min lalu", atau Tidak pernah disemak), Mesej dan Kenalan disegerakkan (setiap sembang yang disegerakkan daripadanya, termasuk yang tiada mesej dalam peti masuk), Mesej terakhir, dan Webhook: URL dan apa yang dihantarnya, seperti "Menghantar setiap mesej yang diterima dan dihantar · ditandatangani dengan rahsia", atau "Tiada – mesej hanya ditunjukkan dalam peti masuk." Lencana Zapier bermakna sebuah Zap menerima mesejnya (lihat Zapier dan nombor peti masuk).
Lencana di bahagian atas kanan menyatakan apa yang sedang dilakukan oleh nombor itu:
| Lencana | Maksud |
|---|---|
| Sedang menyegerak | Disemak kira-kira sekali seminit; mesej baharu sampai ke peti masuk dan webhook anda. |
| Tidak disemak baru-baru ini | "Tidak disemak dalam 15 minit terakhir – contohnya semasa nombor sedang menghantar kempen, yang menjeda semakan peti masuk. Jika berterusan, hubungi sokongan." Mesej diambil selepas penghantaran selesai. |
| Nombor terputus | "Nombor WhatsApp terputus, jadi tiada apa-apa yang baharu tiba." Klik Sambungkannya semula. |
| Dihentikan | Dihentikan oleh anda, atau oleh WbizTool apabila tambahan tamat atau meliputi lebih sedikit nombor (lihat Apabila tambahan tamat). Tiada apa-apa yang disegerakkan atau dihantar. |
| Belum dimulakan | "Ditambah (cth. oleh Zapier) semasa nombor di luar talian. Ia tidak disegerakkan sehingga ia dimulakan." Sambung semula nombor itu jika perlu, kemudian klik Mulakan. |
Tukar URL webhook atau mesej yang dihantar#
Buka tetapan webhook
Klik Tetapan webhook pada kad nombor itu.
Ubah tetapan
Edit URL webhook (pilihan) dan tanda di bawah Mesej untuk dihantar. Untuk mematikan webhook, kosongkan URL.
Simpan
- Menukar URL mengekalkan rahsia. Mengosongkan URL memadamnya; URL yang ditambah kemudian mendapat rahsia baharu, ditunjukkan sekali dalam Rahsia webhook anda.
- Jika tiada kotak ditandakan, kad menyatakan "Tiada acara dipilih – tiada apa-apa yang dihantar".
Tunjukkan atau jana semula rahsia#
Rahsia terdiri daripada 32 huruf dan digit. Dalam Tetapan webhook, di bawah Rahsia webhook, Tunjukkan memaparkannya dengan Salin di sebelahnya. Jana semula bertanya "Jana rahsia baharu? Rahsia semasa berhenti berfungsi serta-merta – kemas kininya di mana-mana tempat anda menyemak tandatangan." Klik Jana rahsia baharu: ia disimpan serta-merta ("Rahsia baharu dijana."), tanpa Simpan, dan setiap permintaan sejak itu ditandatangani dengannya, termasuk cubaan semula bagi mesej terdahulu.
Hentikan, mulakan atau alih keluar nombor#
| Butang | Apa yang berlaku |
|---|---|
| Hentikan | Selepas anda mengesahkan, sembangnya berhenti disegerakkan dan tiada apa-apa yang dihantar. Ia tidak lagi menggunakan salah satu nombor peti masuk anda; tetapannya disimpan. |
| Mulakan | Ia disegerakkan dan menghantar semula, menggunakan salah satu nombor peti masuk anda. Mesej yang tiba semasa ia dihentikan ditambah ke dalam peti masuk, sehingga 30 hari ke belakang, tetapi tidak dihantar: webhook anda hanya menerima mesej dari saat anda mengklik Mulakan. Selepas hentian kurang daripada sejam, mesej itu turut dihantar. Mulakan dikelabukan tanpa tambahan ("Memerlukan tambahan Unibox") atau tanpa nombor peti masuk yang kosong ("Semua nombor peti masuk anda sedang digunakan – hentikan atau alih keluar nombor lain dahulu"). |
| Alih keluar | Bertanya "Alih keluar … daripada peti masuk?" Sembangnya berhenti disegerakkan dan webhooknya dimatikan; perbualan yang sudah disegerakkan kekal dalam peti masuk. Tambahkannya semula untuk mengembalikannya. |
Webhook yang menunggu untuk dicuba semula dibuang apabila anda menghentikan atau mengalih keluar nombor itu atau menukar URLnya.
Cara webhook dihantar#
- Bila: setiap nombor peti masuk disemak kira-kira sekali seminit semasa ia disambungkan; semakan dijeda semasa ia menghantar mesej, seperti kempen. Mesej dihantar selepas semakan yang menemuinya, biasanya dalam masa satu atau dua minit. Tiada butang ujian: hantar mesej kepada nombor itu daripada telefon lain.
- Satu permintaan bagi setiap mesej:
message_receiveduntuk Mesej diterima;message_sentuntuk Mesej dihantar, yang dihantar daripada telefon, WhatsApp Web atau oleh WbizTool (kempen, API, peringatan). Balasan yang dihantar dari peti masuk Unibox biasanya tidak dihantar ke webhook: peti masuk sudah memilikinya. - Berjaya: sebarang status
2xxdalam masa 8 saat. Ubah hala tidak diikuti:3xxdikira sebagai kegagalan. - Cubaan semula: tamat masa, ralat sambungan,
429atau5xxdicuba semula 3 kali, selepas 30 saat, 1 minit dan 2 minit. Jawapan lain, seperti400atau404, dan sijil TLS yang tidak sah tidak dicuba semula. 410 Gone: WbizTool mematikan webhook nombor itu (URL dan rahsia dibuang; untuk cangkuk Zapier, webhook anda sendiri yang terdahulu kembali). Nombor itu terus disegerakkan ke dalam peti masuk.- Susunan dan ulangan: permintaan boleh tiba tidak mengikut susunan dan, jarang sekali, dua kali. Isih mengikut
message.whatsapp_timestampdan langkaumessage.idyang telah anda kendalikan bagiwhatsapp_client_idyang sama. Dua nombor anda dalam satu kumpulan masing-masing menghantar salinan sendiri. - Mesej lewat: mesej yang diambil lewat, contohnya selepas nombor disambungkan semula atau selepas jeda semakan, tetap dihantar, dengan
replayedbernilaitruejika ia berusia lebih daripada 10 minit. Mesej yang tiba semasa nombor dihentikan tidak dihantar selepas Mulakan (lihat Hentikan, mulakan atau alih keluar nombor). - Semakan alamat: URL disemak semula sebelum setiap permintaan; hos yang kini menghala ke rangkaian peribadi, atau tidak dapat diselesaikan, tidak dihantar, dan mesej itu tidak dicuba semula.
Pengepala#
| Pengepala | Nilai |
|---|---|
Content-Type | application/json |
X-Wbiztool-Event | message_received atau message_sent |
X-Wbiztool-Timestamp | Bila permintaan dibuat, dalam ISO 8601 UTC. Sama seperti timestamp dalam badan. |
X-Wbiztool-Webhook-Id | ID peti masuk nombor itu. Sama seperti webhook_id dalam badan. |
X-Wbiztool-Signature | sha256= diikuti tandatangan (lihat Sahkan tandatangan). |
Sahkan tandatangan#
Setiap permintaan ditandatangani dengan rahsia webhook nombor itu menggunakan HMAC-SHA256 ke atas badan permintaan mentah tepat seperti yang diterima. Ringkasan hex huruf kecil dihantar dalam X-Wbiztool-Signature sebagai sha256=<digest>. Webhook yang ditetapkan di halaman Nombor peti masuk sentiasa mempunyai rahsia, jadi pengepala ini sentiasa ada.
Kira tandatangan daripada bait mentah sebelum anda menghuraikan JSON. Menghuraikan dan mengekod semula badan akan mengubahnya (jarak, aksara yang di-escape), dan tandatangan tidak akan sepadan.
// 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 mesej sebenar tiba, tandatangani sendiri sesuatu badan dan hantarkannya:
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"
Tandatangan meliputi badan, termasuk timestampnya, yang baharu pada setiap cubaan. Untuk menolak permintaan yang dimainkan semula, tolak timestamp yang berusia lebih daripada 5 minit dan langkau message.id yang telah anda kendalikan.
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"
}
}Nombor, ID dan nama di atas ialah contoh. Badan sebenar ialah satu baris JSON padat, dan setiap aksara bukan ASCII (huruf beraksen, tulisan lain, emoji) tiba sebagai escape \uXXXX, seperti \ud83d\udcf8 untuk 📸. Lebih banyak medan mungkin ditambah; abaikan medan yang tidak anda gunakan.
Medan peringkat atas#
| Medan | Jenis | Penerangan |
|---|---|---|
event | string | message_received atau message_sent. |
timestamp | string | Bila permintaan dibuat (ISO 8601, UTC). |
replayed | boolean | true apabila mesej lebih lama daripada permintaan melebihi 10 minit: penghantaran susulan, contohnya selepas nombor disambungkan semula. Jika tidak, false. timestamp kekal sebagai masa permintaan. |
webhook_id | integer | ID peti masuk nombor itu. |
whatsapp_client_id | string | ID nombor WhatsApp anda, seperti di Nombor WhatsApp dan dalam API. |
whatsapp_phone | string | Nombor WhatsApp anda, digit sahaja. |
platform | string | whatsapp, atau telegram untuk sembang akaun Telegram. |
message | object | Mesej itu, lihat di bawah. |
contact | object | Orang atau kumpulan yang bersembang dengan anda, lihat di bawah. |
organisation | object | Ruang kerja anda: id (string) dan name. |
group | object | Hanya untuk sembang kumpulan: name, nama kumpulan. |
Medan message#
| Medan | Jenis | Penerangan |
|---|---|---|
id | string | ID WhatsApp bagi mesej. Gunakannya untuk melangkau ulangan. |
type | string | chat untuk teks. Jika tidak, jenis WhatsApp, seperti image, video, audio, ptt (nota suara), document, sticker, location, vcard (kad kenalan), poll_creation, call_log (panggilan) atau revoked (mesej yang dipadam). |
content | string | Teks mesej chat. Jika tidak, label: 📸 Image, 🎥 Video, 🎵 Audio, 🎤 Voice Message, 😊 Sticker, Document: diikuti teks dokumen (Document jika tiada), atau jenis dalam huruf besar pada awal perkataan, seperti Location atau Call_Log. Kapsyen foto dan video tidak disertakan. |
from | string | Sentiasa nombor kenalan (atau ID kumpulan), dalam kedua-dua arah. Kosong apabila WhatsApp menyembunyikan nombor itu. |
from_name | string | Nama kenalan atau kumpulan. Boleh kosong. |
to | string | Sentiasa nombor WhatsApp anda, dalam kedua-dua arah. |
timestamp | string | Bila mesej dihantar di WhatsApp (ISO 8601, UTC). |
whatsapp_timestamp | integer | Masa yang sama dalam saat Unix. |
direction | string | incoming atau outgoing. Gunakan ini, bukan from dan to, untuk arah mesej. |
status | string | Sentiasa pending: bukan status penghantaran atau dibaca. |
is_forwarded | boolean | Sama ada mesej itu dimajukan. |
forwarding_score | integer | Pada masa ini sentiasa 0. |
media | object | Untuk foto, video, audio, nota suara, dokumen dan pelekat: filename (selalunya kosong untuk foto), mimetype, size dalam bait dan, apabila WbizTool menyimpan salinan, url. |
media.url | string | Pautan muat turun bertandatangan yang tamat tempoh – selepas 3½ hingga 7 hari – jadi muat turun fail apabila webhook tiba. Gunakannya tepat seperti yang dihantar. Tiada apabila fail tidak dapat disimpan, seperti fail melebihi 15 MB. |
sender | object | Sembang kumpulan sahaja: siapa yang menulis mesej – name, phone (kosong apabila WhatsApp menyembunyikan nombor mereka) dan phone_hidden (true apabila ia disembunyikan). |
Medan contact#
| Medan | Jenis | Penerangan |
|---|---|---|
whatsapp_id | string | ID WhatsApp sembang: …@c.us untuk orang, …@g.us untuk kumpulan, atau ID privasi seperti 62337239240946@lid. |
phone | string | Nombor tanpa +, atau ID kumpulan. Kosong apabila WhatsApp menyembunyikan nombor itu. |
lid | string or null | ID privasi WhatsApp bagi kenalan, apabila WhatsApp menggunakannya, jika tidak null. |
phone_hidden | boolean | true apabila WhatsApp tidak berkongsi nombor kenalan. WbizTool mengisi nombor itu apabila WhatsApp menyediakannya. |
name | string | Nama kenalan atau nama kumpulan. Boleh kosong. |
is_group | boolean | true untuk sembang kumpulan. |
is_business | boolean | true untuk akaun WhatsApp Business, apabila diketahui. |
Zapier dan nombor peti masuk#
Pencetus Incoming WhatsApp Message WbizTool dalam Zapier menggunakan webhook ini. Menghidupkan Zap menambah nombor itu ke peti masuk jika perlu (menggunakan salah satu nombor peti masuk anda) dan mengarahkan webhooknya ke Zapier, untuk mesej diterima sahaja, dengan rahsianya sendiri; kad menunjukkan lencana Zapier. URL webhook, rahsia dan tanda anda sendiri kembali apabila Zap dimatikan.
Tetapan webhook kemudian memberi amaran: "Webhook ini dimiliki oleh Zap Zapier. Mengubah atau mengalih keluar URL akan menghentikan Zap daripada menerima mesej." Hentikan dan Alih keluar juga memberi amaran: Zap kekal hidup dalam Zapier tetapi tidak menerima apa-apa, jadi matikannya dalam Zapier sebaliknya. Lihat Cara pencetus berfungsi dengan nombor peti masuk anda.
Tanpa tambahan Unibox#
Halaman menyatakan "Tiada tambahan Unibox" dan "Tambahan Unibox tidak aktif pada ruang kerja ini.", dan Tambah nombor ke peti masuk membuka Tambahan Unibox diperlukan: "Untuk menambah nombor WhatsApp ke peti masuk dikongsi dan menerima mesejnya melalui webhook, langgan tambahan Unibox." Pemilik mengklik Lihat tambahan dan menambah tambahan Nombor Telefon Unibox di Bil & pelan, pada pelan berbayar atau seumur hidup (bukan percubaan percuma).
Apabila tambahan tamat atau nombor terputus#
- Tambahan tamat: setiap nombor peti masuk dihentikan, serta-merta atau dalam masa kira-kira sejam. Kad menunjukkan Dihentikan dengan "Dihentikan kerana tambahan Unibox tidak aktif pada ruang kerja ini." Pemilik dan Editor dimaklumkan peti masuk mana yang berhenti, dalam e-mel bil atau amaran "Sesetengah nombor atau ciri … telah berhenti" (Masalah nombor & penghantaran dalam Pemberitahuan). Perbualan, URL webhook dan rahsia disimpan: sebaik sahaja tambahan aktif semula, klik Mulakan pada setiap nombor. Mesej dari tempoh ia dihentikan kemudian ditambah ke dalam peti masuk, sehingga 30 hari ke belakang, tetapi tidak dihantar ke webhook anda.
- Tambahan meliputi lebih sedikit nombor daripada yang dihidupkan: "Lebih banyak nombor dihidupkan daripada yang dibenarkan oleh tambahan anda. Nombor tambahan yang terbaharu dihentikan secara automatik dalam masa kira-kira sejam."
- Nombor terputus: kad menunjukkan Nombor terputus dan tiada apa-apa yang disegerakkan atau dihantar. Selepas anda menyambungkannya semula, mesej yang tiba sementara itu turut diambil dan dihantar; mesej yang berusia lebih daripada 10 minit mempunyai
replayedbernilaitrue. - Ia disambung semula dengan telefon lain: nombor peti masuk dan webhooknya diteruskan untuk nombor baharu (
whatsapp_client_idyang sama,whatsapp_phonebaharu) dari saat itu; sembang lama kekal dalam peti masuk sebagai sejarah.
Penyelesaian masalah#
| Mesej atau masalah | Apa yang perlu dilakukan |
|---|---|
| Tambahan Unibox diperlukan, atau "Ini memerlukan tambahan Unibox." | Minta Pemilik menambah tambahan Unibox, lihat Tanpa tambahan Unibox. |
| "Semua nombor peti masuk anda sedang digunakan. Hentikan atau alih keluar satu dahulu, atau tambah lagi pada tambahan Unibox." | Hentikan atau alih keluar nombor yang tidak anda perlukan, atau naikkan kuantiti tambahan. Nombor yang dihentikan tidak dikira. |
| "Tiada nombor WhatsApp yang disambungkan dan bebas untuk ditambah." | Setiap nombor yang disambungkan sudah berada dalam peti masuk, atau tiada yang disambungkan dengan kod QR atau kod pautan. Klik Sambung nombor. |
| "Nombor ini tidak lagi disambungkan. Sambungkannya semula, atau pilih nombor lain." | Sambungkannya semula di Nombor WhatsApp, kemudian cuba lagi. |
| "Masukkan alamat penuh yang bermula dengan https://" atau "URL webhook mesti bermula dengan https://" | Gunakan alamat https://; http:// tidak diterima. |
| "Alamat boleh mengandungi paling banyak 500 aksara." | Gunakan URL yang lebih pendek, contohnya tanpa query yang panjang. |
| "URL webhook mesti menghala ke alamat internet awam." | Hosnya ialah localhost, alamat rangkaian peribadi, atau tidak dapat diselesaikan. Gunakan alamat awam, atau terowong semasa menguji. |
| Tiada Nombor peti masuk dalam bar sisi, atau "Hanya pemilik ruang kerja atau editor boleh melakukan ini." | Anda ialah Penganalisis. Minta Pemilik menjadikan anda Editor, lihat Peranan dan kebenaran. |
| Tiada webhook yang tiba | Pastikan kad menunjukkan Sedang menyegerak, URL betul dan kotak ditandakan di bawah Mesej untuk dihantar. Pelayan anda mesti menjawab 2xx dalam masa 8 saat, dengan sijil yang sah. Balasan peti masuk tidak dihantar. |
| Sesetengah webhook hilang | Pelayan anda menjawab 4xx atau 3xx, gagal dalam ketiga-tiga cubaan semula, atau hosnya tidak dapat diselesaikan. Semak lognya pada masa mesej yang hilang. Mesej yang tiba semasa nombor dihentikan tidak dihantar: bacanya dalam peti masuk. |
| Tandatangan tidak sepadan | Gunakan badan mentah, bukan JSON yang dikod semula, dan rahsia semasa. Semasa sebuah Zap menggunakan nombor itu, permintaan pergi ke Zapier dengan rahsia Zapier. |
| Pautan media mengembalikan ralat | Pautan itu telah tamat tempoh. Muat turun fail apabila webhook tiba. |
Berkaitan#
- Peti masuk Unibox: baca dan jawab sembang nombor peti masuk anda
- Integrasi Zapier
- Sambung nombor WhatsApp anda
- Pelan dan bil
- API hantar mesej: medan
webhooknya melaporkan sama ada mesej yang anda hantar telah keluar (webhook yang berbeza)



