Pre-requisites
- Front connected and webhook active — see Connect Front.
- Chat or messaging channel configured in Front — your Front workspace must be receiving chat messages through Front Chat, Smooch, or a custom integration.
How conversations land in Front
Setting up
Confirm chat messages route to Front
Open your website or app where Front Chat (or a connected messaging platform) is installed and send a test message. The conversation should appear in your Front inbox.
Confirm the AI processes the message
The AI should reply within a few seconds. Check that the reply appears as a message from the AI teammate.
Trigger a test handoff
Send a message like “I want to talk to a human” in the chat. The AI should hand off — you’ll see an internal handoff comment and the conversation unassigned.
What the rep sees
- The conversation appears in their Front inbox like any other chat thread.
- The full AI-to-customer transcript is already in the thread — no separate tool to check.
- An internal handoff comment with summary and sentiment.
- Replies typed in the Front inbox land back in the customer’s chat window.
Channel-specific details
Messaging platform mapping
Messaging platform mapping
Front receives messages from various sources and labels them by type. OpenCX maps these to internal channel types:
The AI responds the same way regardless of the underlying messaging platform.
| Front message type | OpenCX channel |
|---|---|
custom (Front Chat) | Web |
smooch (third-party messaging) | Web |
intercom | Web |
| Unknown types | Web (default) |
Real-time responses
Real-time responses
Chat conversations are processed immediately on webhook delivery. The AI typically replies within a few seconds of receiving a customer message.
Inline images and attachments
Inline images and attachments
Images customers send in chat are downloaded from Front’s API and uploaded to OpenCX storage. The AI can reference them in its reasoning. Other attachment types retain their original filename and content type.
Custom channel identifiers
Custom channel identifiers
If your Front workspace uses custom channels, the customer’s handle (the identifier used to reach them) is extracted from the webhook payload. This is typically a username, user ID, or external reference depending on how your custom channel is configured.
Related Documentation
Email channel
Email conversation specifics.
Connect Front
API token, webhook, and teammate selection.
Front overview
What else the Front integration covers.
Troubleshooting
AI not replying, webhook errors, handoff not firing.