Black Friday Black Friday: the new LetsBot bundles save up to 60% — until 30 November only. See the bundles See the bundles
LetsBot Menu
Get Started English Language

Verified Meta Tech Provider UK Registered Company

Language

Live Chat · API endpoint

POST /api/v1/live_chat/transfer-to-team New

Transfer conversation to team

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 t…

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.

Form fields

FieldExample
phone{{phone}}
team_id1

Example request

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())

Ready when you are

Try this endpoint on your own number

The API works during the free trial. Create an account, connect your WhatsApp number and copy your key from API → Authentication Data.