Creating Your Chat Link

Getting started with inHotel Mobile Chat is quick and easy — there's nothing to install.

This page walks you through the link structure, the parameters you'll need, and ready-to-copy examples.

No installation required

Mobile Chat is fully hosted at mobile-chat.inhotel.io — just generate a link and share it. Here's a working example you can open right now:

https://mobile-chat.inhotel.io/chat?agent_card_url=https://bd0c3189-6499-4f99-880a-6983f6f9de58.agents.inhotel.io/.well-known/agent-card.json&skill_name=guest-directory&source_channel=room-705

Try it →

Link format

Every link follows the same shape — a fixed base URL plus three query parameters:

https://mobile-chat.inhotel.io/chat
  ?agent_card_url=<YOUR_URL>      ← which assistant to load
  &skill_name=<SKILL>             ← which skill it should use
  &source_channel=<CHANNEL>       ← where the request is coming from

Parameters

Parameter	Required	What it does
agent_card_url	Yes	Points to your organization's agent card JSON, which identifies the assistant to load.
skill_name	Yes	The skill the assistant should use, e.g. guest-directory.
source_channel	Recommended	A free-form tag identifying where the request came from, e.g. room-705, table-12, lobby.

Where to find your agent_card_url

Find it in the Agent Card section of your assistant's page in the inHotel Portal:

https://<your-id>.agents.inhotel.io/.well-known/agent-card.json

Choosing a skill_name

Your available skills are listed in the Skills section of the portal.

Using source_channel

A free-form tag identifying where the request came from — a room number, table, or area.

source_channel=room-705

Example links

Guest Relations Assistant — guest-directory skill for room 705

https://mobile-chat.inhotel.io/chat?agent_card_url=https://bd0c3189-6499-4f99-880a-6983f6f9de58.agents.inhotel.io/.well-known/agent-card.json&skill_name=guest-directory&source_channel=room-705

What if something goes wrong

Issue	What happens
Missing or wrong agent_card_url	Customer sees a default assistant with an error message
Wrong skill_name	Customer sees your branding but the message "I am afraid I don't have this skill."
Missing source_channel	Everything works, but you won't know where the request came from