omega
  1. messages
omega
  • health
    • Get Health
      GET
    • Check Db Connection
      GET
  • sms
    • Queue SMS for sending and database recording
      POST
    • Record SMS message in database without sending
      POST
    • Update SMS delivery status
      POST
  • email
    • Queue email for sending and database recording
      POST
    • Record email message in database without sending
      POST
    • Update email delivery status
      POST
    • Handle external email provider webhooks
      POST
  • businesses
    • Get paginated list of client conversations for a business
      GET
    • Add internal note to a client conversation
      POST
    • Get list of business locations
      GET
    • Create or retrieve client conversation
      POST
    • Get available conversation filters
      GET
    • Get paginated conversation messages with filters
      GET
    • Assign a client conversation to a staff member
      POST
    • Update client conversation status
      POST
    • Update read status of messages using filters
      POST
  • business-clients
    • Get detailed client profile and conversation information
    • Get paginated list of clients for a business
  • business-staffs
    • Get detailed profile of a specific staff member
    • Get paginated list of staff members for a business
  • voice-calls
    • Get Token
    • Handle Twiml Call
  • messages
    • Retry Processing of Failed Messages
      POST
    • Retry Processing of Failed Messages
      POST
    • Get messages by request ID
      GET
    • Get messages by request ID
      GET
    • Search messages within a specific conversation
      GET
    • Search messages within a specific conversation
      GET
    • Process and record messages from any supported channel
      POST
  • twilio
    • Process incoming SMS replies via Twilio webhook
    • Process SMS delivery status updates from Twilio
    • Update voice call status in DB
  • session
    • Expire Session
  • authentication
    • Generate Auth Token
  • business
    • Onboard a business
    • Get business onboarding status
  1. messages

Process and record messages from any supported channel

POST
/projects/{project_id}/messages/record
Handles incoming messages from all supported communication channels (web_voice, telephony, webchat).
Channel Processing:
Validates and processes messages from any supported channel type
Maintains channel-specific message formatting and metadata
Supports both synchronous and asynchronous message handling
Client Management:
Identifies or creates clients based on channel user ID
Matches clients across channels using phone/email
Handles client merging and archival when duplicates are found
Conversation Handling:
Creates or retrieves existing conversations
Manages conversation status and metadata
Supports message threading and session tracking
Message Processing:
Records both user and system messages
Maintains message history and threading
Handles message status and delivery tracking
The endpoint ensures proper message routing, client identification, and conversation management
while maintaining data integrity across all supported channels.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://dev.isaac.wellnessliving.com/omega/projects//messages/record' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY;' \
--data-raw '{
    "user_message": "Hello! I'\''m your virtual assistant. How can I help you today?",
    "user_id": "12345",
    "channel": "sms",
    "bot_message": "Hello! I'\''m your virtual assistant. How can I help you today?",
    "ripples_session_id": "67890",
    "user_details": {
        "user_profile": {
            "email": "john.doe@example.com",
            "first_name": "John",
            "full_name": "John Doe",
            "last_name": "Doe",
            "parent_universal_user_id": "12345",
            "phone_number": "+1234567890",
            "universal_user_id": "12345",
            "user_id_alias": "12345",
            "user_id_hash": "12345"
        }
    }
}'
Response Response Example
200 - Example 1
{}

Request

Authorization
API Key
Add parameter in header
X-API-KEY
Example:
X-API-KEY: ********************
or
API Key
Add parameter in header
cookie
Example:
cookie: ********************
or
Path Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
Returns a confirmation message indicating the message was successfully:
Validated against the request schema
Added to the processing queue
The response includes a success message with the queue status.
Body

🟠422Parameter Error
Modified at 2025-07-07 07:04:14
Previous
Search messages within a specific conversation
Next
Process incoming SMS replies via Twilio webhook
Built with