Trang này chưa được dịch, nên bạn đang đọc bản tiếng Anh.
Negotiation
The hotel's limits for private offers, the list of negotiations with the WhatsApp status, and offers made at the desk for a caller. Ana trades rather than discounts, never under the hotel's floor.
A hotel that bargains lets Ana make private offers inside limits the owner sets. She trades rather than discounts: each kind of offer unlocks part of the allowance.
Offer kind | Label | Unlocks |
|---|---|---|
base | Your dates | base_pct, for nothing in return |
pay_now | Pay now | + pay_now_pct: the whole stay paid when booking |
longer | One more night | + longer_pct, off the whole, longer stay |
dates | A quieter date | + dates_pct, when the guest's dates can move |
A guest who stayed before gets + returning_pct. All of it is capped at max_discount_pct, and scaled by how full the hotel is that night: nothing off when nearly full, the whole allowance when quiet. A night is never priced under RevBot's floor for its room type. Opening offers keep some of the allowance back; counter-offers can reach it all, within max_rounds.
Offers are private prices for one stay, with an expiry. They are never shown as a public rate.
Guests negotiate on the booking page, on WhatsApp, at the reception kiosk, on a phone call with Ana, at the desk, through travellers' AI assistants (Negotiation for AI assistants), and through partner apps on the API (Negotiation, the channel PARTNER, off until the hotel turns it on). Each is a channel the hotel can turn off.
Get the settings
/api/v1/negotiation/settingsrates.view{
"enabled": true,
"max_discount_pct": 15,
"base_pct": 5,
"pay_now_pct": 5,
"longer_pct": 8,
"dates_pct": 5,
"returning_pct": 3,
"max_rounds": 3,
"expiry_minutes": 30,
"nightly_cap": 0,
"room_type_ids": [],
"channels": {
"BOOKING_PAGE": true,
"WHATSAPP": true,
"RECEPTION": true,
"DESK": true,
"PHONE": true,
"AGENT": false
}
}The values above are the defaults. enabled is false until the owner turns it on.
Change the settings
/api/v1/negotiation/settingsrates.manageproperty_id is a query parameter. Send only what changes; the answer is the whole settings, as for GET.
0: no limit.BOOKING_PAGE, WHATSAPP, RECEPTION, DESK, PHONE, AGENT, each true or false. Channels left out keep their value.curl -X PUT "https://app.chatbeds.app/api/v1/negotiation/settings?property_id=6f1c3b2e-8a0d-4f5e-9b7a-2c3d4e5f6a7b" \
-H "Authorization: Bearer $FIREBASE_ID_TOKEN" \
-H "Content-Type: application/json" \
-d '{"enabled": true, "max_discount_pct": 12, "channels": {"AGENT": true}}'List negotiations
/api/v1/negotiationrates.viewThe negotiations of the last days (at most 300, newest first), a summary, the settings, and whether WhatsApp guests get offers.
30.{
"negotiations": [
{
"id": "0b6f3d1a-6c2e-4b8f-9a71-5d2c8e4f1a90",
"channel": "WHATSAPP",
"status": "BOOKED",
"name": "Sara Brown",
"phone": "+447700900123",
"email": null,
"arrival": "2026-11-12",
"departure": "2026-11-14",
"nights": 2,
"adults": 2,
"children": 0,
"room_type": "Deluxe",
"budget": 160.0,
"currency": "USD",
"public_total": 180.0,
"agreed_total": 165.0,
"offers": [],
"rounds": [
{ "at": "2026-10-21T09:12:40+00:00", "by": "guest", "said": "Asked for an offer: 12 Nov to 14 Nov, 2 adults, about 160.00.", "amount": 160.0, "offers": null },
{ "at": "2026-10-21T09:12:41+00:00", "by": "ana", "said": "Here's what I can do. …", "amount": null, "offers": ["a1b2c3d4", "e5f6a7b8"] }
],
"counters": 1,
"reservation_id": "a589df05-30ad-4ee5-9832-16ff6c2c1d0e",
"created_at": "2026-10-21T09:12:40+00:00",
"expires_at": "2026-10-21T09:52:10+00:00",
"created_by": null
}
],
"summary": {
"total": 14,
"open": 2,
"booked": 5,
"conversion": 36,
"booked_value": 812.0,
"public_value": 900.0,
"average_off": 9.8,
"currency": "USD"
},
"settings": { "enabled": true, "max_discount_pct": 15 },
"whatsapp": {
"connected": true,
"connected_elsewhere": [],
"guest_services": true,
"ana": true,
"channel_on": true,
"taking_offers": true
}
}| Field | Meaning |
|---|---|
negotiations[].channel | BOOKING_PAGE, WHATSAPP, RECEPTION, DESK, PHONE or AGENT |
negotiations[].status | OPEN, BOOKED, DECLINED or EXPIRED |
negotiations[].offers[] | The offers standing now, each with id, kind, label, room_type_id, room_type, rate_plan_id, arrival, departure, nights, currency, total (with tax), public_total, room_total, public_room_total, saving, lowest (the hotel's lowest room price for it: staff only, never shown to guests), pay_now, final |
negotiations[].rounds[] | What each side said, in order: at, by (guest or ana), said, amount (the guest's price, else null) and offers (the IDs of the offers made then, else null) |
negotiations[].created_by | The person who started it at the desk, else null |
summary.conversion | Booked, as a percent of all |
summary.booked_value, public_value | Room totals of booked negotiations, at the agreed and at the public price |
summary.average_off | Percent off the public price, over booked negotiations |
settings | The whole settings, as for GET /settings (trimmed above) |
whatsapp | Whether a guest asking for a better price on WhatsApp gets offers from this hotel, and why not. See below |
The whatsapp status
| Field | Meaning |
|---|---|
connected | The hotel's own WhatsApp number is connected |
connected_elsewhere | When not: the names of the owner's other hotels whose number is connected. Guests writing there get offers by that hotel's settings |
guest_services | Guest services is on, so Ana answers guests |
ana | Ana's AI is available on the server |
channel_on | Negotiation is on and its WHATSAPP channel is on |
taking_offers | channel_on, connected and guest_services together: WhatsApp guests get offers here |
Get one negotiation
/api/v1/negotiation/{negotiation_id}rates.viewOne negotiation, in the same shape as in the list. room_type is null here. 404 Negotiation not found. for one of another account.
Make offers at the desk
/api/v1/negotiation/deskreservations.manageOffers for someone on the phone or at the desk, inside the same limits. Needs the DESK channel on. property_id is a query parameter. The answer is the negotiation.
1.0.budget given is a counter-offer) and doesn't count again.curl -X POST "https://app.chatbeds.app/api/v1/negotiation/desk?property_id=6f1c3b2e-8a0d-4f5e-9b7a-2c3d4e5f6a7b" \
-H "Authorization: Bearer $FIREBASE_ID_TOKEN" \
-H "Content-Type: application/json" \
-d '{"arrival": "2026-11-12", "departure": "2026-11-14", "adults": 2, "budget": 160, "phone": "+447700900123"}'When nothing is free, the negotiation comes back DECLINED with no offers.
Counter
/api/v1/negotiation/{negotiation_id}/counterreservations.manageAna accepts (one final offer at the guest's price), or moves every offer towards it. On the last round she gives her lowest, marked final. The answer is the negotiation, its expiry renewed.
Book an offer
/api/v1/negotiation/{negotiation_id}/bookreservations.manageBooks the room at the agreed price for the guest.
pay_now offer needs the whole total.CASH (default), CARD or BANK_TRANSFER, for paid_amount. With no paid_amount, the booking is paid at the hotel.The answer is the negotiation, now BOOKED, with reservation_id.
Close
/api/v1/negotiation/{negotiation_id}/closereservations.manageEnds an open negotiation: it becomes DECLINED. A negotiation already ended is returned as it is.
Errors
| Status | detail | When |
|---|---|---|
400 | Each percentage must be between 0% and 50%. and similar | A setting out of range |
400 | The departure must be after the arrival., Offers are for stays of up to 30 nights., The arrival date has passed. | Desk offers |
400 | This price is for paying now: take USD 186.00 first. | Booking a pay_now offer without the whole paid_amount |
409 | This hotel isn't taking offers here. The prices shown are the best ones. | Negotiation off, or the DESK channel off |
409 | This offer has ended. Ask for a new one. / These offers have expired. Ask for a new one. | Countering or booking a negotiation that isn't OPEN |
409 | That offer has changed. Please choose again. | offer_id isn't one of the offers standing now |
409 | This booking can't be made. Please check with a manager. | The guest matches the hotel's blocked list |
429 | You've asked for several offers today. Please contact the hotel. | Offers for 8 different stays from this phone or email today |
Bạn đang xây dựng gì đó?
Payments in WhatsApp and phone bookings
Choose what a guest pays when Ana books a room on WhatsApp or a phone call, an advance with a Pay now button or pay at the hotel, and how the 2-hour hold, the reminder and the release work.
Night mode and phone lines
Night mode hands the front desk to Ana by hours and wakes a person only for real problems. Phone lines let Ana answer calls on WhatsApp, a Twilio or Telnyx number, or a SIP line. The settings, the ID check, lines, calls and the carrier webhooks.