API چت

cURL

curl -X POST https://virtualemployees.nl/api/v1/external/chat \
  -H "Authorization: Bearer $VE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "message": "What are your opening hours?", "sessionId": "visitor-8f3a21", "locale": "en" }'

JavaScript (Node.js)

// Node.js 18+ (server side)
const response = await fetch("https://virtualemployees.nl/api/v1/external/chat", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    message: "What are your opening hours?",
    sessionId: "visitor-8f3a21",
    locale: "en",
  }),
});

if (!response.ok) {
  const problem = await response.json(); // { title: "external_chat.invalid_key", detail: "..." }
  throw new Error(problem.title ?? `HTTP ${response.status}`);
}

const { reply } = await response.json();

Python

import os, requests

response = requests.post(
    "https://virtualemployees.nl/api/v1/external/chat",
    headers={"Authorization": f"Bearer {os.environ['VE_API_KEY']}"},
    json={"message": "What are your opening hours?", "sessionId": "visitor-8f3a21", "locale": "en"},
    timeout=60,
)
response.raise_for_status()
reply = response.json()["reply"]

PHP

<?php
$ch = curl_init("https://virtualemployees.nl/api/v1/external/chat");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("VE_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "message" => "What are your opening hours?",
        "sessionId" => "visitor-8f3a21",
        "locale" => "en",
    ]),
]);
$reply = json_decode(curl_exec($ch), true)["reply"];

C# (.NET)

// .NET 8+ (server side)
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(60) };
http.DefaultRequestHeaders.Authorization =
    new("Bearer", Environment.GetEnvironmentVariable("VE_API_KEY"));

var response = await http.PostAsJsonAsync("https://virtualemployees.nl/api/v1/external/chat",
    new { message = "What are your opening hours?", sessionId = "visitor-8f3a21", locale = "en" });

response.EnsureSuccessStatusCode();
var reply = (await response.Content.ReadFromJsonAsync<ChatReply>())!.Reply;

record ChatReply(string Reply);

خودتان با کارمند گفتگو کنید

یک کد اتصال بسازید و آن را به ربات تلگرام خود کارمند بفرستید (یا لینکی که نشان می‌دهیم را باز کنید). آن چت به استخدام شما وصل می‌شود. می‌توانید چند چت، مثلاً اعضای تیم، را وصل کنید و از پنل یا با فرستادن /unlink به ربات قطعشان کنید. کد یک بار کار می‌کند و بعد از ۱۰ دقیقه منقضی می‌شود.

ربات اختصاصی خودتان برای مشتریانتان

با @BotFather یک ربات بسازید و توکنش را در تنظیمات کارمند بگذارید. هر کسی به ربات شما پیام بدهد با کارمند گفتگو می‌کند، بدون کد. تعداد پیام هر نفر در ساعت محدود است و برای کل ربات هم سقفی هست. توکن رمزنگاری‌شده ذخیره می‌شود. مطمئن شوید برای ربات webhook تنظیم نشده، چون پیام‌های آن را با polling دریافت می‌کنیم.