Release Notes for v5.27 - August 05, 2021

Capture critical customer data: How did you hear about us?

The 'How did you hear about us?' question is one of the most fundamental feedback tools you can use to learn more about your customer base. Knowing how guests discover your brand will help you focus your marketing efforts on channels and audiences that will increase bookings.

In our upcoming release, we have enhanced our Web API to capture this data, which will be displayed in the GXM and the Preference Statistics Report. This enhancement will be deployed on August 09, 2021.

Read on for more information about v5.27. 

Customize Referral Sources

You'll find a new Pickgroup called "How Did You Hear About Us (+HDY)" in the Web Admin. Here, you can customize your referral sources such as Hotel Website, Search Engine or Hotel Booking Agency.

API Call Updates

The NewsletterSubscription call has been updated to allow the passing of the new +HDY Pickgroup and Pickgroup Item.

The MemberSetUpGet call has been updated to return the new +HDY Pickgroup and all the possible values for the Pickgroup Items.

Click here to jump to the updated API codes.

Preference Statistics Report Updates

If the +HDY Pickgroup is enabled for your properties, you'll be able to include it in the parameters of your Preference Statistics Report.

When the +HDY Pickgroup is included in the report, the report will show how guests' referral source selections fluctuate over time.

Guest Experience Manager

Coming soon! The GXM will be enhanced in the 5.28 release to display guests' HDY responses at time of subscription sign-up. Stay tuned for details.

API Call Updates

NewsletterSubscription

Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:api="http://api.serenata.com/">

   <soap:Header/>

   <soap:Body>

      <api:NewsletterSubscription>

         <api:UserID> </api:UserID>

         <api:UserPassword></api:UserPassword>

          <api:Email>tesnxgqa_July30_R78@cendyn.com</api:Email>

            <api:Lastname>NXG QA last2</api:Lastname>

            <api:Firstname>NXG QA fname1</api:Firstname>

         <api:NewsletterCodes>+HDY~WEB</api:NewsletterCodes>

              <api:AuthenticationToken></api:AuthenticationToken>

      </api:NewsletterSubscription>

   </soap:Body>

</soap:Envelope>

Response

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

   <soap:Body>

      <NewsletterSubscriptionResponse xmlns="http://api.serenata.com/">

         <NewsletterSubscriptionResult>200-Success (new profile '104127' created )</NewsletterSubscriptionResult>

      </NewsletterSubscriptionResponse>

   </soap:Body>

</soap:Envelope>

MemberSetupGet

Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:api="http://api.serenata.com/">

   <soap:Header/>

   <soap:Body>

       <api:MemberSetupGet>

         <api:RequestXML>

<CMAccess xmlns="http://tempuri.org/CMAccess.xsd">

  <Request>

    <UserID> </UserID>

    <UserPassword></UserPassword>

        <SetupGroup></SetupGroup>

    <CodeGroup></CodeGroup>

    <OriginatingIP></OriginatingIP>

    <OriginatingUserAgent></OriginatingUserAgent>

    <AuthenticationToken></AuthenticationToken>

  </Request>

</CMAccess>

         </api:RequestXML>

      </api:MemberSetupGet>

   </soap:Body>

</soap:Envelope>

Response

<soap:Body>

      <MemberSetupGetResponse xmlns="http://api.serenata.com/">

         <MemberSetupGetResult>

            <CMAccess xmlns="http://tempuri.org/CMAccess.xsd">

               <Request>

                  <UserID> </UserID>

                  <UserPassword></UserPassword>

                  <SetupGroup>NWL</SetupGroup>

                  <CodeGroup/>

                  <OriginatingIP/>

                  <OriginatingUserAgent/>

                  <AuthenticationToken/>

               </Request>

               <Response>

                  <ResultCode>200</ResultCode>

                  <ResultText>Success</ResultText>

                  <ReturnedRows>7</ReturnedRows>

               </Response>

               <Setup>

                  <SetupGroup>NWL</SetupGroup>

                  <Code>NLC</Code>

                  <CodeGroup>NLC</CodeGroup>

                  <Description>餐厅</Description>

                  <LongDescription/>

               </Setup>

                <Setup>

                  <SetupGroup>+HDY</SetupGroup>

                  <Code>WEB</Code>

                  <Description>Hotel Website</Description>

                  <LongDescription/>

               </Setup>

               <Setup>

                  <SetupGroup>+HDY</SetupGroup>

                  <Code>SRC</Code>

                  <Description>search engine</Description>

                  <LongDescription/>

               </Setup>

               <Setup>

                  <SetupGroup>+HDY</SetupGroup>

                  <Code>HAA</Code>

                  <Description>Hotel Booking Agency</Description>

                  <LongDescription/>

               </Setup>

               <Setup>

            </CMAccess>

         </MemberSetupGetResult>

      </MemberSetupGetResponse>

   </soap:Body>

</soap:Envelope>

NextGuest CRM Web Services API Specifications

Click the link below to download the technical documentation for all NextGuest CRM APIs.