Skip to content

💡 External Conversation Import

Capture guest conversations from web chat and phone systems into LIKE MAGIC

The Idea

Import conversations from external communication platforms—website live chat, phone call bots or IVR systems—into the LIKE MAGIC unified messaging system. Once imported, LIKE MAGIC automatically links conversations to guest profiles when they make a reservation, giving your team full visibility across every touchpoint.

How It Works

The Flow:

  1. Guest contacts your property via website chat widget or automated phone system
  2. Your system captures the conversation with the guest's phone number or email
  3. Push messages to LIKE MAGIC via API, specifying the guest identifier and message content
  4. LIKE MAGIC creates a conversation and stores all messages with timestamps
  5. Guest makes a reservation — LIKE MAGIC automatically links the conversation to their profile
  6. Your team sees the full conversation history alongside the reservation
sequenceDiagram
    participant Guest
    participant Your System
    participant "LIKE MAGIC"
    participant Staff

    Guest->>Your System: 1: Chats via website / phone bot
    Your System->>"LIKE MAGIC": 2: Push messages (phone or email identifier)
    "LIKE MAGIC"->>"LIKE MAGIC": 3: Create conversation & store messages
    Guest->>"LIKE MAGIC": 4: Makes a reservation (same phone/email)
    "LIKE MAGIC"->>"LIKE MAGIC": 5: Auto-link conversation to guest profile
    Staff->>"LIKE MAGIC": 6: View full conversation history

What You Get

A unified view of all guest communication regardless of origin:

  • Automatic guest matching by phone number or email address
  • Full conversation history visible to property staff before guest arrival
  • Support for both website chat and phone call transcripts
  • Chronological message ordering with original timestamps preserved
  • Conversation retrieval by guest profile for complete communication history

Perfect For

  • Hotels with website live chat widgets
  • Properties using automated phone call systems or IVR
  • Contact centers handling pre-booking inquiries
  • Integration partners building omni-channel communication tools

Technical Details

Push Messages Endpoint

POST /api/unified-messaging-service/guest-conversations/messages

Required scope: guest.conversation.write

Send up to 100 messages per request. Each message includes:

  • Guest identifier — phone number or email address to match the guest
  • Platform — PHONE_CALL or WEBSITE_CHAT
  • Direction — SENT (from property) or RECEIVED (from guest)
  • Content — text or email format
  • Timestamp — when the message was originally created

Messages are grouped by guest identifier. LIKE MAGIC creates or retrieves a conversation per guest and inserts messages in chronological order.

Read Endpoints

Endpoint Description Required Scope
GET /guest-conversations/{conversationId} Get a conversation by ID guest.conversation.read
GET /guest-conversations/{conversationId}/messages Paginated messages for a conversation guest.conversation.read
GET /guest-conversations/messages/{messageId} Get a single message guest.conversation.read
GET /guest-conversations/by-user-profile-id/{userProfileId} Conversations for a guest profile guest.conversation.read

Guest Identifier Types

Type Format Example
PHONENUMBER E.164 format +41791234567
EMAILADDRESS Standard email guest@example.com

Supported Platforms

Platform Use Case
WEBSITE_CHAT Website live chat widgets, chatbot conversations
PHONE_CALL Phone call transcripts, IVR interactions, voice bot conversations

Key APIs

Ready to build? See the Push Conversations guide for a step-by-step integration walkthrough, or explore the Unified Messaging API Live Docs for the full API reference.