curl --request PUT \
--url https://tawked.com/v1/applications/{application}/radeef/settings/{section} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"csat": true,
"etiquette": true,
"idle_minutes": 125,
"orders": true,
"persona_name": "<string>",
"products": true,
"read_receipts": true,
"reply_cap": 22,
"split": true,
"strict": true,
"topics": {
"refunds": true,
"complaints": true
},
"typing": true,
"assign_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"custom_enabled": true,
"custom_topics": [
"<string>"
],
"keywords": [
"<string>"
],
"keywords_enabled": true,
"messages": {
"saudi": {
"inside": "<string>",
"outside": "<string>"
},
"msa": {
"inside": "<string>",
"outside": "<string>"
},
"en": {
"inside": "<string>",
"outside": "<string>"
}
},
"monthly_cap_halalas": 5000050,
"order_status": true,
"persona_name_en": "<string>",
"ramadan": {
"sun": [
"<string>"
],
"mon": [
"<string>"
],
"tue": [
"<string>"
],
"wed": [
"<string>"
],
"thu": [
"<string>"
],
"fri": [
"<string>"
],
"sat": [
"<string>"
]
},
"week": {
"sun": {
"from": "<string>",
"to": "<string>"
},
"mon": {
"from": "<string>",
"to": "<string>"
},
"tue": {
"from": "<string>",
"to": "<string>"
},
"wed": {
"from": "<string>",
"to": "<string>"
},
"thu": {
"from": "<string>",
"to": "<string>"
},
"fri": {
"from": "<string>",
"to": "<string>"
},
"sat": {
"from": "<string>",
"to": "<string>"
}
}
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
csat: true,
etiquette: true,
idle_minutes: 125,
orders: true,
persona_name: '<string>',
products: true,
read_receipts: true,
reply_cap: 22,
split: true,
strict: true,
topics: {refunds: true, complaints: true},
typing: true,
assign_member_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
custom_enabled: true,
custom_topics: ['<string>'],
keywords: ['<string>'],
keywords_enabled: true,
messages: {
saudi: {inside: '<string>', outside: '<string>'},
msa: {inside: '<string>', outside: '<string>'},
en: {inside: '<string>', outside: '<string>'}
},
monthly_cap_halalas: 5000050,
order_status: true,
persona_name_en: '<string>',
ramadan: {
sun: ['<string>'],
mon: ['<string>'],
tue: ['<string>'],
wed: ['<string>'],
thu: ['<string>'],
fri: ['<string>'],
sat: ['<string>']
},
week: {
sun: {from: '<string>', to: '<string>'},
mon: {from: '<string>', to: '<string>'},
tue: {from: '<string>', to: '<string>'},
wed: {from: '<string>', to: '<string>'},
thu: {from: '<string>', to: '<string>'},
fri: {from: '<string>', to: '<string>'},
sat: {from: '<string>', to: '<string>'}
}
})
};
fetch('https://tawked.com/v1/applications/{application}/radeef/settings/{section}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://tawked.com/v1/applications/{application}/radeef/settings/{section}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'csat' => true,
'etiquette' => true,
'idle_minutes' => 125,
'orders' => true,
'persona_name' => '<string>',
'products' => true,
'read_receipts' => true,
'reply_cap' => 22,
'split' => true,
'strict' => true,
'topics' => [
'refunds' => true,
'complaints' => true
],
'typing' => true,
'assign_member_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'custom_enabled' => true,
'custom_topics' => [
'<string>'
],
'keywords' => [
'<string>'
],
'keywords_enabled' => true,
'messages' => [
'saudi' => [
'inside' => '<string>',
'outside' => '<string>'
],
'msa' => [
'inside' => '<string>',
'outside' => '<string>'
],
'en' => [
'inside' => '<string>',
'outside' => '<string>'
]
],
'monthly_cap_halalas' => 5000050,
'order_status' => true,
'persona_name_en' => '<string>',
'ramadan' => [
'sun' => [
'<string>'
],
'mon' => [
'<string>'
],
'tue' => [
'<string>'
],
'wed' => [
'<string>'
],
'thu' => [
'<string>'
],
'fri' => [
'<string>'
],
'sat' => [
'<string>'
]
],
'week' => [
'sun' => [
'from' => '<string>',
'to' => '<string>'
],
'mon' => [
'from' => '<string>',
'to' => '<string>'
],
'tue' => [
'from' => '<string>',
'to' => '<string>'
],
'wed' => [
'from' => '<string>',
'to' => '<string>'
],
'thu' => [
'from' => '<string>',
'to' => '<string>'
],
'fri' => [
'from' => '<string>',
'to' => '<string>'
],
'sat' => [
'from' => '<string>',
'to' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://tawked.com/v1/applications/{application}/radeef/settings/{section}"
payload = {
"csat": True,
"etiquette": True,
"idle_minutes": 125,
"orders": True,
"persona_name": "<string>",
"products": True,
"read_receipts": True,
"reply_cap": 22,
"split": True,
"strict": True,
"topics": {
"refunds": True,
"complaints": True
},
"typing": True,
"assign_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"custom_enabled": True,
"custom_topics": ["<string>"],
"keywords": ["<string>"],
"keywords_enabled": True,
"messages": {
"saudi": {
"inside": "<string>",
"outside": "<string>"
},
"msa": {
"inside": "<string>",
"outside": "<string>"
},
"en": {
"inside": "<string>",
"outside": "<string>"
}
},
"monthly_cap_halalas": 5000050,
"order_status": True,
"persona_name_en": "<string>",
"ramadan": {
"sun": ["<string>"],
"mon": ["<string>"],
"tue": ["<string>"],
"wed": ["<string>"],
"thu": ["<string>"],
"fri": ["<string>"],
"sat": ["<string>"]
},
"week": {
"sun": {
"from": "<string>",
"to": "<string>"
},
"mon": {
"from": "<string>",
"to": "<string>"
},
"tue": {
"from": "<string>",
"to": "<string>"
},
"wed": {
"from": "<string>",
"to": "<string>"
},
"thu": {
"from": "<string>",
"to": "<string>"
},
"fri": {
"from": "<string>",
"to": "<string>"
},
"sat": {
"from": "<string>",
"to": "<string>"
}
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"data": {}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}radeef.settings.update
Each section takes only its own fields (the input lists every section’s together). hours with a week also writes the Tawked Chat inbox’s working hours first: 502 hours_save_failed when Tawked Chat refuses (nothing changed). limits.monthly_cap_halalas caps the month’s spend; past it Radeef pauses.
curl --request PUT \
--url https://tawked.com/v1/applications/{application}/radeef/settings/{section} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"csat": true,
"etiquette": true,
"idle_minutes": 125,
"orders": true,
"persona_name": "<string>",
"products": true,
"read_receipts": true,
"reply_cap": 22,
"split": true,
"strict": true,
"topics": {
"refunds": true,
"complaints": true
},
"typing": true,
"assign_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"custom_enabled": true,
"custom_topics": [
"<string>"
],
"keywords": [
"<string>"
],
"keywords_enabled": true,
"messages": {
"saudi": {
"inside": "<string>",
"outside": "<string>"
},
"msa": {
"inside": "<string>",
"outside": "<string>"
},
"en": {
"inside": "<string>",
"outside": "<string>"
}
},
"monthly_cap_halalas": 5000050,
"order_status": true,
"persona_name_en": "<string>",
"ramadan": {
"sun": [
"<string>"
],
"mon": [
"<string>"
],
"tue": [
"<string>"
],
"wed": [
"<string>"
],
"thu": [
"<string>"
],
"fri": [
"<string>"
],
"sat": [
"<string>"
]
},
"week": {
"sun": {
"from": "<string>",
"to": "<string>"
},
"mon": {
"from": "<string>",
"to": "<string>"
},
"tue": {
"from": "<string>",
"to": "<string>"
},
"wed": {
"from": "<string>",
"to": "<string>"
},
"thu": {
"from": "<string>",
"to": "<string>"
},
"fri": {
"from": "<string>",
"to": "<string>"
},
"sat": {
"from": "<string>",
"to": "<string>"
}
}
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
csat: true,
etiquette: true,
idle_minutes: 125,
orders: true,
persona_name: '<string>',
products: true,
read_receipts: true,
reply_cap: 22,
split: true,
strict: true,
topics: {refunds: true, complaints: true},
typing: true,
assign_member_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
custom_enabled: true,
custom_topics: ['<string>'],
keywords: ['<string>'],
keywords_enabled: true,
messages: {
saudi: {inside: '<string>', outside: '<string>'},
msa: {inside: '<string>', outside: '<string>'},
en: {inside: '<string>', outside: '<string>'}
},
monthly_cap_halalas: 5000050,
order_status: true,
persona_name_en: '<string>',
ramadan: {
sun: ['<string>'],
mon: ['<string>'],
tue: ['<string>'],
wed: ['<string>'],
thu: ['<string>'],
fri: ['<string>'],
sat: ['<string>']
},
week: {
sun: {from: '<string>', to: '<string>'},
mon: {from: '<string>', to: '<string>'},
tue: {from: '<string>', to: '<string>'},
wed: {from: '<string>', to: '<string>'},
thu: {from: '<string>', to: '<string>'},
fri: {from: '<string>', to: '<string>'},
sat: {from: '<string>', to: '<string>'}
}
})
};
fetch('https://tawked.com/v1/applications/{application}/radeef/settings/{section}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://tawked.com/v1/applications/{application}/radeef/settings/{section}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'csat' => true,
'etiquette' => true,
'idle_minutes' => 125,
'orders' => true,
'persona_name' => '<string>',
'products' => true,
'read_receipts' => true,
'reply_cap' => 22,
'split' => true,
'strict' => true,
'topics' => [
'refunds' => true,
'complaints' => true
],
'typing' => true,
'assign_member_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'custom_enabled' => true,
'custom_topics' => [
'<string>'
],
'keywords' => [
'<string>'
],
'keywords_enabled' => true,
'messages' => [
'saudi' => [
'inside' => '<string>',
'outside' => '<string>'
],
'msa' => [
'inside' => '<string>',
'outside' => '<string>'
],
'en' => [
'inside' => '<string>',
'outside' => '<string>'
]
],
'monthly_cap_halalas' => 5000050,
'order_status' => true,
'persona_name_en' => '<string>',
'ramadan' => [
'sun' => [
'<string>'
],
'mon' => [
'<string>'
],
'tue' => [
'<string>'
],
'wed' => [
'<string>'
],
'thu' => [
'<string>'
],
'fri' => [
'<string>'
],
'sat' => [
'<string>'
]
],
'week' => [
'sun' => [
'from' => '<string>',
'to' => '<string>'
],
'mon' => [
'from' => '<string>',
'to' => '<string>'
],
'tue' => [
'from' => '<string>',
'to' => '<string>'
],
'wed' => [
'from' => '<string>',
'to' => '<string>'
],
'thu' => [
'from' => '<string>',
'to' => '<string>'
],
'fri' => [
'from' => '<string>',
'to' => '<string>'
],
'sat' => [
'from' => '<string>',
'to' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://tawked.com/v1/applications/{application}/radeef/settings/{section}"
payload = {
"csat": True,
"etiquette": True,
"idle_minutes": 125,
"orders": True,
"persona_name": "<string>",
"products": True,
"read_receipts": True,
"reply_cap": 22,
"split": True,
"strict": True,
"topics": {
"refunds": True,
"complaints": True
},
"typing": True,
"assign_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"custom_enabled": True,
"custom_topics": ["<string>"],
"keywords": ["<string>"],
"keywords_enabled": True,
"messages": {
"saudi": {
"inside": "<string>",
"outside": "<string>"
},
"msa": {
"inside": "<string>",
"outside": "<string>"
},
"en": {
"inside": "<string>",
"outside": "<string>"
}
},
"monthly_cap_halalas": 5000050,
"order_status": True,
"persona_name_en": "<string>",
"ramadan": {
"sun": ["<string>"],
"mon": ["<string>"],
"tue": ["<string>"],
"wed": ["<string>"],
"thu": ["<string>"],
"fri": ["<string>"],
"sat": ["<string>"]
},
"week": {
"sun": {
"from": "<string>",
"to": "<string>"
},
"mon": {
"from": "<string>",
"to": "<string>"
},
"tue": {
"from": "<string>",
"to": "<string>"
},
"wed": {
"from": "<string>",
"to": "<string>"
},
"thu": {
"from": "<string>",
"to": "<string>"
},
"fri": {
"from": "<string>",
"to": "<string>"
},
"sat": {
"from": "<string>",
"to": "<string>"
}
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"data": {}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": "<string>",
"message": "<string>",
"fields": {},
"needs": "<string>",
"next": "<string>",
"did_you_mean": [
{}
],
"human_action": {
"reason": "connect_whatsapp",
"url": "<string>",
"say": "<string>",
"then": "<string>"
},
"approval": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"operation": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}
}Authorizations
An account token from Settings › Account API in the Tawked console: Authorization: Bearer tk_acct_…
Headers
One per intended change (1 to 128 printable ASCII characters): a retry with the same key and the same request answers the stored 2xx with Idempotent-Replayed: true, for 24 hours. A 428 approval_required is never stored: send the approved request again with the same key or none. An answer that carried a secret shown once is never kept: its replay answers 409 idempotency_secret_not_replayable with the id of what it made.
1 - 128Path Parameters
An application's id (a UUID); list them with applications.applications.list.
^(?:[\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12})$One section of Radeef's settings: persona, pace, handoff, hours, limits or store; list them with radeef.settings.show.
^(?:persona|pace|handoff|hours|limits|store)$Body
auto, member, none none, few 10 <= x <= 240warm, brief always, outside, inside 40^[\p{L}\p{M} ـ]+$/usaudi, msa, mirror 5 <= x <= 40short, standard fast, natural, relaxed Show child attributes
Show child attributes
Required when assign_mode is member.
10120\S3040\SShow child attributes
Show child attributes
100 <= x <= 1000000040^[A-Za-z][A-Za-z '\-]*$Show child attributes
Show child attributes
12, 24, 48 Show child attributes
Show child attributes
Response
Done.