Interactions Behaviour Notes and FAQ
This page answers common questions about how the Interactions module behaves and what to expect when sending or receiving messages.
Reply latency
Why does it take a moment for the reply to arrive?
Raytio acknowledges messages immediately. When your message lands, you will see a typing indicator in the chat app within seconds — this confirms the message was received and is being processed.
The substantive reply follows once the assigned worker has finished composing it. Workers are automated agents that may need to read context, reason through the request, and draft a response. This typically takes up to a minute, though it can be faster or slower depending on the complexity of the request.
The flow is: message received → typing indicator sent (near-instant) → worker reads context and composes reply → reply delivered.
What if no reply arrives?
If no reply arrives after several minutes and no typing indicator was shown, the message may not have been received. Check the Conversations list in the UI to confirm the message appears in the history. If it does not appear, the channel endpoint may need attention — contact your administrator.
Attachments
What happens to files I send in chat?
Files sent as attachments in a chat thread are downloaded and stored as documents on the conversation record. You can find them in the Documents section of the conversation view in the UI.
Attachments become part of the conversation context and are available to workers when they compose a reply.
Can I send a file as a reply from Raytio?
Yes. When replying from the UI, you can reference an existing document on the conversation or any document you have access to in Raytio. The system delivers the file to the chat thread on your behalf.
Messages in the General topic (Telegram supergroups)
What happens when someone sends a message in the General topic of the Telegram group?
The Interactions module uses a Telegram supergroup with topics enabled. Each bound conversation corresponds to one topic in that group.
The General topic (the default, untopicked channel in a supergroup) acts as an unbound intake channel. Messages sent there are not tied to any specific work item. They land in the triage queue configured on the channel endpoint, where an administrator can review them and decide how to route them.
This makes the General topic a convenient quick-capture inbox: send a message there and it will appear in the queue ready to be triaged.
Conversation visibility
Who can see a conversation?
Conversations are subject to the same role-based access control as the rest of Raytio. Users with the Interaction viewer role or higher can see conversations they have access to. Conversations bound to a work item inherit the visibility rules of that work item.