Core concepts

Keep conversations tied to the right person and channel

Alloy uses contacts, channels, and conversations to connect customer messages, internal chats, AI teammate chats, and webchat sessions.

The basic model

A contact is the stable person record. A contact channel is that person's identity in a specific channel, such as webchat, API, skill chat, or AI teammate chat.

Conversations attach to contact channels. This lets Alloy keep conversations connected to the right person and the right communication path.

Customer conversations

Public webchat can identify a visitor through a webchat token, a provided external ID, or a generated ID.

When the same external ID is sent again, Alloy reuses the same webchat contact channel. If profile fields such as name, phone, or email are supplied, the existing channel can be updated instead of creating a duplicate identity.

Internal chat

Internal chat currently supports AI teammate chat and Ally chat. The shared Chats surface lets users start conversations, open history, rename or delete threads, send attachments, stop generation, and use voice when enabled.

Users can use `Enter` to send, `Shift+Enter` or `Alt+Enter` for a newline, and `Alt+C` to toggle Chats.

Mentions, files, and attachments

Internal chat can support `@` teammate mentions and `#` shared-file mentions when sources are available.

File mentions are scoped to the current AI teammate's readable shared folders, not the organization's entire Storage tree.

Webchat widget

The webchat widget can be embedded into a website and initialized with an API key, optional API and websocket URLs, event ID, contact data, language, positioning, and open state.

The widget supports public-session persistence, messages, attachments, iframe resizing, voice setup, and websocket updates for matching conversations.

Frequently asked questions

What is the difference between a contact and a conversation?+

A contact represents the person. A conversation is a thread attached to that person's identity in a specific channel.

Does internal chat mix Ally and AI teammate history?+

The shared Chats history uses teammate-only filtering and does not mix in Ally conversations.

Can webchat reuse the same customer identity?+

Yes. Reusing the same webchat token or external ID lets Alloy resolve the same webchat contact channel.

Start building your AI team