بدانید چه کسی گفتگو میکند
وقتی مشتری وارد میشود ()identify را صدا بزنید تا کارشناس نام، ایمیل و شمارهاش را ببیند.
یک اسکریپت برای نصب، یک API کوچک جاوااسکریپت برای ارسال اطلاعات، وبهوکهای امضاشده برای رویدادها و REST API برای بقیه کارها.
<script src="https://nivachat.co/widget.js"
data-site-id="YOUR-SITE-ID" async></script>// When a customer signs in
await window.ChatWidget.identify({ name: "Sara Mohammadi", email: "sara@example.com" });
// Anything the agent should see beside the chat
await window.ChatWidget.setCustomData({ plan: "Business", cart: "2 items" });
// Single-page apps: after each route change
window.ChatWidget.pageChanged();
window.ChatWidget.open();POST https://your-app.example/hooks/nivachat
X-Chat-Event: message.created
X-Chat-Signature: sha256=<HMAC-SHA256(body, secret)>
{
"event": "message.created",
"occurred_at": "2026-11-16T10:24:00Z",
"data": { … }
}# List conversations
curl https://nivachat.co/api/public/v1/conversations \
-H "Authorization: Bearer csk_…"
# Reply to one
curl -X POST https://nivachat.co/api/public/v1/conversations/{uuid}/messages \
-H "Authorization: Bearer csk_…" \
-H "Content-Type: application/json" \
-d '{"body": "Hi! How can we help?"}'conversation.createdبازدیدکننده گفتگوی تازهای شروع میکند.message.createdپیامی ارسال میشود؛ از بازدیدکننده یا کارشناس.conversation.resolvedگفتگو حلشده علامت میخورد.وقتی مشتری وارد میشود ()identify را صدا بزنید تا کارشناس نام، ایمیل و شمارهاش را ببیند.
()setCustomData پلن، شناسه حساب یا مبلغ سبد خرید را کنار گفتگو میگذارد.
()pageChanged مسیر بازدیدکننده را وقتی اپ شما بدون بارگذاری مجدد جابهجا میشود دقیق نگه میدارد.
conversation.created و message.created و conversation.resolved به آدرس شما ارسال میشوند.
با کلید API گفتگوها را فهرست کنید، پیامها را بخوانید و از ابزار خودتان پاسخ دهید.
وبهوکهای ناموفق با فاصله دوباره ارسال میشوند: پس از ۱ دقیقه، ۵ دقیقه، ۳۰ دقیقه و ۲ ساعت.
اطلاعات خود را بگذارید تا کارشناسان ما برای راهاندازی و معرفی Nivachat، رایگان با شما تماس بگیرند.