Introduction

Agoda is one of the OTA channels where you can manage the connection, perform room and rate plan mapping, import data from the OTA, and configure other settings through the following tabs: Information, Username, Mapping, Assignments, and Settings.

Once the integration is fully configured, all reservations from Agoda will appear in the Booking List, allowing you to manage them efficiently in one place.

Accessing Agoda Setting

Here’s how you can access Agoda setting:

1. On the Channelku, navigate to the Channel Manager menu, then click Control Panel.
2. Select Agoda from the channel list, or you can search from the list by type the OTA name.

---

Agoda Information

The Agoda Information tab provides the basic connection procedure between the system and Agoda. Make sure you follow these steps:

Step	Description
1. Who can request connection?	Channel Manager or HOTEL itself
2. Who must be contacted?	Agoda Connectivity Services: BD-Connectivity@agoda.com
3. Which information is required to open connection?	Hotel ID from Agoda
4. Extranet URL	https://ycs.agoda.com

[!NOTE]

Troubleshooting Agoda Information

Cannot initiate connection with Agoda

• Confirm that the request is initiated by the Channel Manager or hotel representative.
• Ensure you have contacted BD-Connectivity@agoda.com as instructed.

Missing required information

• Make sure the Hotel ID is available before making the request.
• Double-check the format of the Hotel ID copied from Agoda extranet.

Invalid or outdated extranet URL

• Use the correct URL: https://ycs.agoda.com. If it does not load, check your internet connection or contact Agoda support.

---

Username

In the Username tab, you can enter or update the credentials required to connect to Agoda.

How to Update Username and Hotel Key

1. Enter your Agoda Hotel ID in the Property ID field.
2. Click the save (✓) button to apply the changes.
3. If you don’t want to save the changes, click cancel (✖).

[!NOTE]

Troubleshooting Credential and Username Update

Failed to Save Hotel ID

• Make sure the Hotel ID is valid and correctly copied from Agoda.
• Check your internet connection and try again.

Changes Not Reflected After Saving

• Refresh the page to confirm if the changes have been applied.
• If not saved, re-enter the Property ID and click the save (✓) button again.

---

Mapping

How to Import Rooms

The Import Rooms feature allows you to retrieve room and rate plan data from the OTA extranet into Channel Manager. This step is required before you can create mappings.

Note: Make sure that active rate plans are available in the OTA extranet before importing.

1. Go to the Mapping tab and click Import Rooms.
2. A pop-up will appear displaying the active room and rate plans from the OTA. Configure how Channel Manager will push updates to the OTA:
   • If Availability Only is checked, only inventory (availability) will be updated.
   • If Availability Only is unchecked, the system will push availability, rates, and restrictions.
3. Click Update Rateplans to import the data into Channel Manager.

[!NOTE]

Troubleshooting Import Rooms

Import Rooms button not working

• Check your internet connection and try again.
• Log out and log in again before attempting the import.

Imported list is empty or incomplete

• Confirm with Agoda that your property is live and room/rate plans are available.
• Re-import after making changes on Agoda’s extranet.

Availability Only checkbox not behaving as expected

• Make sure the checkbox is correctly ticked before clicking Update Rateplans.
• Re-check the setting if both rate and availability are pushed unintentionally.

How to Add Mapping

The Mapping feature is used to link your internal rooms and rate plans with the corresponding rooms and rate plans from Agoda. To create room mapping, please follow the steps in How to Add Mapping.

---

Settings

The Settings tab allows you to manage how the system interacts with Agoda, including enabling the channel, handling updates, and configuring reservation options.

How to Configure Settings

1. Click Import Future Agoda Reservations to import the new reservations.
2. Enable the Enable Channel option to activate the connection between your property and Agoda.
3. Turn on Activate Updates to allow the system to push rate, availability, and restriction updates to Agoda.
4. Enable Activate Reservations if you want to receive bookings from Agoda into the system.
5. Enable Send Reservation Voucher Email if you want the system to email a voucher every time a booking is received.
6. Enable Activate New OBP Model if you want to use Occupancy Based Pricing, where room rates vary based on the number of guests staying.
7. In the Currency (if Different) field, click currency and select the currency code if your Agoda currency is different from your system’s default. If left blank, the system will detect the appropriate currency automatically. Click Update to save all changes.
8. Activate OBP: Activate OBP to reveal additional configuration fields. For detailed instructions, refer to the How to Configure OBP Setting.
9. Manual OTA Update: To synchronizes rates, availability, minimum stay requirements, and "Stop Sell" statuses across all connected channels. Data can be synchronized up to the maximum date range permitted by each individual OTA (typically between 12 and 24 months in advance). Refer to How to Configure Manual OTA to see the setting steps.

How to Configure OBP Setting

If the property utilizes Occupancy-Based Pricing (OBP) on Agoda, you can activate the OBP option. Once you have enabled it, the specific configuration settings will become available for you to adjust.

1. Click the Settings button next to OBP.
2. You will be taken to the OBP configuration screen where you can define detailed pricing adjustments based on occupancy.
   • Choose the adjustment type: either Percent (%) or Amount (number).
   • For each bedroom type listed, you will see the Default Pax column, the Increase/Decrease selector, and a Value field.
   • You can click the down arrow next to each bedroom to expand a list of pax levels (from 1 up to 9 pax).
   • For each pax level, enter the value adjustment to be applied (e.g., increase by 10%, decrease by 50, etc.).
3. After filling in the necessary values, click Save to apply the OBP settings.

How to Configure Manual OTA Update

1. Scroll down to the OTA Update section.
2. Click the OTA Update button to open the pop up window
3. Complete all the form field below:
   • Date Selection : Choose the duration of the OTA update (e.g 1 month, 3 months, etc)
   • Room Type : Select the room type from the list.
   • Rate : Choose one or more rate plans. You can also select all rate plan if needed.
4. Click Sync OTA to save and apply the changes.

[!NOTE]

Troubleshooting Settings and Update History

Enable Channel or Activate Updates not working

• Make sure the checkbox is selected and click the Update button afterward.
• If the changes do not apply, refresh the page and try again.

Not receiving reservations from Agoda

• Confirm that Activate Reservations is turned on.
• Make sure rate plans are mapped and active on both Agoda and the system.

Reservation voucher email not received

• Ensure Send Reservation Voucher Email is enabled.
• Check your spam or junk folder, or confirm your email address in the notification settings.

OBP not applying to rates

• Enable Activate New OBP Model to allow pricing based on guest count.
• Contact Agoda support to verify OBP is enabled for your property.

Import Future Agoda Reservations not working

• Refresh the page and click again.
• If no reservations are imported, check with Agoda if new bookings exist and are confirmed.

Currency field not saving properly

• Click to clear, then re-select the currency code.
• If left empty, the system will auto-detect the correct currency at the time of booking.

OTA Update not sending changes

• Select at least one room or choose All Room Types before clicking OTA Update.
• Wait a few minutes and review the Last 10 Updates section to confirm if it was logged.

No updates shown in Last 10 Updates

• Refresh the page after a few minutes.
• Ensure OTA Update was triggered and mapping is valid.

Update marked as failed

• Hover over the failed update entry to view the error message.
• Confirm that the rate plan and room are still active in Agoda’s extranet.
• Retry sending the update using the OTA Update button.