Connect iTicket
Summary
Section titled “Summary”The iTicket tool connects your KonversAI assistant to your iTicket account.
Adding the tool: you add it on the Assistant tools screen in the KonversAI console. Select Settings in the left sidebar, then select AI tools.
Order lookup: the assistant always finds a visitor’s ticket order from the order reference. It sends the visitor their ticket links again, and tells them the cancellation deadline. Order lookup needs a verified email address from the visitor.
With Enable ticket, price and departure tools turned on, the assistant also:
- describes your tickets;
- quotes prices for each age group;
- checks which departures have free seats;
- gives a link to buy.
What the assistant never does: sell a ticket, take a payment, cancel or refund an order. For cancellations, the assistant points the visitor to the contact you set in Contact for cancellations and changes.
Who can do this
Section titled “Who can do this”In the KonversAI console:
- A team member with the View tools permission opens the Assistant tools screen.
- A team member with the Modify tools permission adds, edits, validates and deletes the tool.
- A Tenant Admin always holds both permissions.
- Without View tools, the item AI tools does not appear under Settings in the left sidebar. Ask a Tenant Admin to grant Modify tools on the User permissions screen.
With iTicket: you need a contact at your organisation who can ask Visit Group or iTicket support for an API key.
Before you start
Section titled “Before you start”iTicket is in the Tool type list for every workspace. You do not need to ask KonversAI to turn it on.
Get an API key: ask Visit Group or iTicket support for an iTicket API key for the sales channel your shop uses. The assistant describes the products of that sales channel.
Decide where the assistant sends visitors to buy:
- A product page: if your shop has a page for each ticket, find the address
pattern. For example
https://shop.example.com/tickets/RASPRO00032uses the product code at the end. - The shop’s front page: if your shop has no page for each ticket, note the address of the front page instead.
If you also use Citybreak: when your shop runs on a Citybreak booking site, see Connect Citybreak. Keep Enable ticket, price and departure tools off in iTicket when Citybreak’s product tools are on. Otherwise the assistant sees the same products twice.
Email verification: order lookup needs a verified email address from the visitor. KonversAI includes the Email Verification tool in every workspace, so you do not add it.
Get an API key from iTicket
Section titled “Get an API key from iTicket”- In iTicket: Ask Visit Group or iTicket support for an API key for the sales channel your shop uses.
Add the iTicket tool in KonversAI
Section titled “Add the iTicket tool in KonversAI”- In KonversAI: Select Settings in the left sidebar, then select AI tools. Select + Add tool.
- In KonversAI: Select iTicket in Tool type. You cannot change the type later.
- In KonversAI: Type a label in Display name, for example
iTicket. KonversAI fills Slug while you type. - In KonversAI: Type your instruction in Usage guidance for the AI assistant. For example: Use this for questions about tickets, prices, departures and ticket orders.
- In KonversAI: Keep the Enabled checkbox selected.
- In KonversAI: In the Connection card, select Add secret on iTicket API key. Paste the key, then select Apply.
- In KonversAI: Select Test connection. KonversAI saves the tool, opens it with the heading Edit tool, and shows the result in a banner. A success banner starts with Connected. It names your sales channel, the number of products, and up to three product names.
- In KonversAI: Fill in the Configuration card. The card opens after
a successful connection test.
- iTicket content languages (e.g. en,nb): the language codes to fetch ticket texts in, separated by commas. The first code is used when the visitor’s language is not in the list.
- Product page URL template: the address of one ticket’s page, with
{product_code}where the product code goes. For examplehttps://shop.example.com/tickets/{product_code}. The address must start withhttps://. - Shop URL: the address of your shop’s front page. The assistant uses it when it cannot build a product page link.
- Label for a product: the word the assistant uses for what you sell,
for example
ticketortrip. - Enable ticket, price and departure tools: turn this on to let the assistant answer questions about tickets, prices and departures.
- Contact for cancellations and changes: where a visitor turns to cancel
or change an order, for example
booking@example.com.
- In KonversAI: Select Save changes. KonversAI saves the tool, checks the connection again, and shows the result in a banner.
What can the assistant do once iTicket is connected?
Section titled “What can the assistant do once iTicket is connected?”The iTicket tool always lets the assistant find a visitor’s ticket order from the order reference, after the visitor verifies their email address.
- The assistant sends the visitor their ticket links again.
- It tells them the date and time of each booked departure, where the order has one.
- It tells them the cancellation deadline.
With Enable ticket, price and departure tools on, the assistant also describes your tickets, quotes prices for each age group, checks departures with free seats, and gives a link to buy.
You add the tool under Settings → AI tools in the KonversAI console.
A visitor did not get their tickets. Can the assistant help?
Section titled “A visitor did not get their tickets. Can the assistant help?”Yes. Two steps:
- The visitor gives the assistant the order reference from their confirmation email.
- The visitor verifies their email address with a code.
The iTicket tool then finds the order and the assistant sends the ticket links again. The tool only shows an order when the verified email address matches the email address on the order.
Email verification: KonversAI includes the Email Verification tool in every workspace, so you do not add it.
Why does the assistant say no order was found?
Section titled “Why does the assistant say no order was found?”The iTicket tool gives the same answer in each of these cases, so the assistant never reveals whether someone else’s order exists:
- the order reference does not exist;
- the order reference was mistyped;
- the verified email address does not match the email address on the order.
What to ask the visitor: check the order reference in their confirmation email, and verify with the email address they used to buy.
If the visitor tries many references in one conversation: the assistant pauses lookups for a while. It asks the visitor to try again later.
Can the assistant cancel an order or promise a refund?
Section titled “Can the assistant cancel an order or promise a refund?”No. The iTicket tool only reads from iTicket.
- Cancelling: the assistant tells the visitor the cancellation deadline. It points them to the contact in Contact for cancellations and changes.
- Refunds: the assistant does not promise a refund amount.
Set the contact in the Configuration card of the tool under Settings → AI tools.
How does the assistant quote prices?
Section titled “How does the assistant quote prices?”The iTicket tool quotes the lowest price for each age group, such as adult, child and infant, in your shop’s currency.
- With a date: the assistant quotes the price for that date.
- Without a date: the assistant looks at the coming months and says from which date each price applies.
- When every date in that period is sold out: the assistant says so, and suggests other dates.
- Tickets with no date or time: for example a flexible ticket that is valid for a period. The assistant tells the visitor that no date or time needs to be chosen.
Turn on Enable ticket, price and departure tools under Settings → AI tools.
What do the visitor’s links point to?
Section titled “What do the visitor’s links point to?”The iTicket tool builds links in this order:
- Product page URL template, with the ticket’s product code in place of
{product_code}; - Shop URL, when no product page link can be built.
When neither is set, the assistant tells the visitor to buy on your website.
Both addresses must start with https://. Set them in the Configuration
card of the tool under Settings → AI tools.
The banner says iTicket rejected the API key. What now?
Section titled “The banner says iTicket rejected the API key. What now?”The banner reads iTicket rejected the API key. Check that it was copied whole and is still active.
- Open the iTicket tool under Settings → AI tools in the KonversAI console.
- In the Connection card, select Update on iTicket API key. Paste the key from Visit Group or iTicket support, then select Apply.
- Select Test connection again.
If the banner says iTicket found no inventory for this API key’s channel: the key belongs to a sales channel without products. Ask iTicket support for a key for the sales channel your shop uses.
Saving shows a warning that the assistant would see the same products twice. What do I do?
Section titled “Saving shows a warning that the assistant would see the same products twice. What do I do?”The warning appears when your workspace also has a Citybreak tool with Enable product and availability tools on.
- Clear Enable ticket, price and departure tools in the iTicket tool.
- Select Save changes.
Order lookup keeps working. Turn the iTicket product tools on only when Citybreak cannot show the availability of your iTicket products. See Connect Citybreak.
Last reviewed . Tell us when a step no longer matches the product.