Skip to main content

​
Overview

Deploying the Receptionist kiosk is straightforward — open a URL on any device with a web browser. No app installation or embed code required.

​
Getting the Kiosk URL

  1. Navigate to your Receptionist agent’s Playground page
  2. Find the Deploy Kiosk section
  3. Copy the kiosk URL:
https://your-domain.com/a/[publicKey]
The public key is an 8-character identifier unique to your agent (e.g., /a/6bbfebeb).
Click the copy button to copy the URL to your clipboard, or click “Open Kiosk in New Tab” to preview it in your browser.

​
Setting Up the Device

​
Basic Setup

1

Open the URL

Navigate to the kiosk URL in the device’s web browser.
2

Enter full-screen mode

Use the browser’s full-screen mode (usually F11 on desktop, or the kiosk/guided access mode on tablets).
3

Test the flow

Tap through the visitor flow to verify language selection, contact search, and calling work correctly.
4

Lock the device

Use your device’s kiosk mode or guided access to prevent visitors from navigating away.

​
iPad / iOS

  1. Open Safari and navigate to the kiosk URL
  2. Go to Settings → Accessibility → Guided Access
  3. Enable Guided Access
  4. Return to Safari and triple-click the side button to start Guided Access
  5. This locks the device to the kiosk screen

​
Android Tablets

  1. Open Chrome and navigate to the kiosk URL
  2. Use your device’s Kiosk Mode or a kiosk lockdown app (e.g., SureLock, KioWare)
  3. Alternatively, use Screen Pinning from Settings → Security

​
Desktop / Wall Display

  1. Open Chrome or any modern browser
  2. Navigate to the kiosk URL
  3. Press F11 for full-screen mode
  4. Consider using Chrome’s --kiosk flag for a locked-down experience:
chrome --kiosk https://your-domain.com/a/[publicKey]

​
Orientation

The kiosk automatically adapts to the screen orientation:
OrientationLayoutBest For
PortraitVertical layout with stacked elementsTablet stands, wall-mounted displays
LandscapeHorizontal layout with side-by-side elementsDesk screens, reception counters
Orientation is determined by the device screen, not a saved setting. The same URL works on any orientation. You can preview both orientations in the Playground.

​
Testing

Before going live, verify:
CheckHow to Test
Attract screenLeave the kiosk idle — it should show your branding and avatar
Language selectionTap to start and verify available languages
Contact searchSearch for a contact by name, phone, or email
Calling flowSelect a contact and verify the call/notification flow
Return to idleAfter the goodbye screen, the kiosk should return to the attract screen
Theme and colorsVerify your brand colors, logo, and theme look correct

​
Troubleshooting

Possible causes:
  • Invalid or expired public key
  • Network connectivity issues
  • Browser blocking JavaScript
Solutions:
  • Verify the URL matches what’s shown in the Playground
  • Check the device has internet access
  • Try a different browser
Possible causes:
  • No contacts have been added
  • Search term doesn’t match any contacts
Solutions:
  • Add contacts from the Contacts page in the dashboard
  • Verify contacts have been saved successfully
Possible causes:
  • The visitor flow may be waiting for input
  • Browser may have cached a state
Solutions:
  • Refresh the page to reset to the attract screen
  • The kiosk auto-returns after the goodbye screen with a timeout
Possible causes:
  • Device orientation lock is enabled
Solutions:
  • Disable orientation lock on the device
  • Rotate the device to the desired orientation
  • The kiosk adapts automatically

​
Next Steps

Manage Contacts

Add or update the employee directory for your kiosk.

Customize Styling

Adjust the kiosk theme, colors, and avatar.

View Analytics

Monitor kiosk usage and visitor interactions.

Agent Overview

Learn about agent types and core concepts.