Troubleshooting: An automated message was sent without a keycode

In Guesty, you can choose between several third-party providers that generate keycodes for your guests, such as Lynx and Aurmur.

Most partners sync the keycode into the "keycode" field in Guesty, but some may use the "notes guest" field. The keycode usually takes up to one hour after confirmation to generate and appear in Guesty.

Check the keycode in Guesty

If an automated message is sent after confirmation without the keycode, confirm the keycode exists in Guesty. The keycode field only appears when a keycode exists.

The keycode field can be found in two locations:

  • The Guesty inbox - You can view the keycode under the "Guest" widget.
  • The Reservation page - The keycode appears under the "Guest" section in the relevant reservation page.

If you do not see the keycode

Check the reservation confirmation time.

  • If the reservation was confirmed less than one hour ago:  Your third-party provider may still be generating the keycode. Change the message sending time to two to three hours after confirmation to allow the keycode enough time to appear in Guesty.
  • If the reservation was confirmed more than one hour ago: Follow the steps below:
    • Check the partner's integration page to confirm the listing is connected correctly.
    • Contact the partner’s support team for assistance.
    • If the issue persists, contact us.

If you do see the keycode

Check if it was added to the message correctly. If the variable was manually typed, it might be incorrect.

Add the correct keycode variable to the message:

  1. In the relevant message, click +Add variable
  2. Check the partner connection guidelines to see which variable the partner updates. Then, compare the newly added variable to the one already in your message.
    • If the variables are not identical, the keycode variable was added incorrectly. Remove the existing variable and replace it with the new one.
    • If the variables are identical, the keycode variable was added correctly, and you should contact us.

Locate details for contacting support 

If you confirm the configuration is correct and the issue persists, contact us to begin troubleshooting.

To help us triage the issue quickly and accurately, provide the following details along with a screenshot showing any error messages:

Reservation code

The reservation code is a unique identifier assigned to each booking. The code's format depends on the booking channel.

Code formats

  • Airbnb: Starts with "H" (e.g., HMEXF9BKQ4).
  • Booking.com: Starts with "BC" (e.g., BC-1000gAmP).
  • Vrbo: Starts with "HA" (e.g., HA-8XTV36).
  • Manual/Direct Bookings: Have their own specific format.

Location

  • On the Reservation Page: Select the relevant reservation. The reservation code displays in the banner at the top of the page.

  • On the Multi-Calendar: Click a reservation in the Multi-Calendar to access its details. The reservation code displays in the side panel.

  • In the Guesty Inbox: The reservation code displays in the Inbox Reservation widget of the relevant conversation thread.

Back to the top

Automated message name

The label you assign to identify a specific message in your message automation workflow. The name is only for user identification and is not visible to guests.

Location

  • In the messaging automation page: In the top navigation bar, click Automations and select Messages. Click the relevant automation. The automated message name displays in the automations list.

  • In the Guesty Inbox (for scheduled or sent messages): Select the relevant conversation thread. In the right side panel, click Automated messages. The automated message name for sent or scheduled messages displays in the History tab.

Tip:

Use a consistent naming convention (e.g., channel + purpose + trigger) so automations are easy to find with partial searches.

Back to the top

Message automation name

A message automation, sometimes referred to as a workflow, is the visual framework you use to set up automated guest communication based on the reservation lifecycle. The automation name is for internal use only and is not visible to guests.

Location

  • In the messaging automation page: In the top navigation bar, click Automations and select Messages. Click the relevant automation. The message automation name displays in the automations list. To search for a specific automation, use the search bar at the top of the page: Type the full or partial name to quickly find it.

  • In the Guesty Inbox (for scheduled or sent messages): Select the relevant conversation thread. In the right-side panel, click Automated messages. Select the Scheduled or History tab. Under the relevant automation, click See more. The message automation name displays in the pop-up.

Back to the top

Was this article helpful?
0 out of 1 found this helpful