The live chat's transfer to department: every team member currently on the conversation is taken off it, then it is placed in the team — a member of the team gets it now when one is available (on shift, under capacity), otherwise it waits in the team's queue and the team is notified. Recorded in the assignment history with actor api. Never creates a contact; nothing is sent to the customer.
Required: phone (or contact_id), team_id (an id from list teams).
Answers {"message": "success", "data": {"contact_id", "phone", "outcome": "assigned"|"queued", "department": {...}, "removed_moderators": [ids], "moderators": [{"id", "name"}]}}.
Errors ({"message": "error", "code", "data"}): 404 contact_not_found, 409 departments_not_enabled (Routing is off in the workspace — nothing changed), 422 team_not_found or a validation error.
Field formulir
| Field | Contoh |
|---|---|
phone | {{phone}} |
team_id | 1 |
Contoh permintaan
curl -X POST "https://letsbot.net/api/v1/live_chat/transfer-to-team" \
-H "Authorization: Bearer YOUR_LB_API_KEY" \
-H "Accept: application/json" \
-F "phone=9665xxxxxxxx" \
-F "team_id=1"
const response = await fetch("https://letsbot.net/api/v1/live_chat/transfer-to-team", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_LB_API_KEY",
"Accept": "application/json",
},
body: new URLSearchParams({
"phone": "9665xxxxxxxx",
"team_id": "1",
}),
});
const data = await response.json();
console.log(data);
<?php
$ch = curl_init('https://letsbot.net/api/v1/live_chat/transfer-to-team');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_LB_API_KEY',
'Accept: application/json',
],
CURLOPT_POSTFIELDS => http_build_query([
'phone' => '9665xxxxxxxx',
'team_id' => '1',
]),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($data);
import requests
response = requests.request(
"POST",
"https://letsbot.net/api/v1/live_chat/transfer-to-team",
headers={
"Authorization": "Bearer YOUR_LB_API_KEY",
"Accept": "application/json",
},
data={
"phone": "9665xxxxxxxx",
"team_id": "1",
},
)
print(response.json())