93 lines
3.2 KiB
Python
93 lines
3.2 KiB
Python
"""
|
|
Copyright 2024-2026 ChatterMate
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
"""
|
|
|
|
import uuid
|
|
|
|
from sqlalchemy import Column, String, DateTime, ForeignKey, JSON, UniqueConstraint
|
|
from sqlalchemy.orm import relationship
|
|
from sqlalchemy.sql import func
|
|
from sqlalchemy.dialects.postgresql import UUID
|
|
|
|
from app.database import Base
|
|
|
|
|
|
class ChannelConversation(Base):
|
|
"""Maps an external channel conversation to a ChatterMate session.
|
|
|
|
The generic analog of SlackConversation: one row per
|
|
(connected account, platform conversation, session). A new session for
|
|
the same platform conversation (e.g. after the previous one closes)
|
|
gets a new row.
|
|
"""
|
|
__tablename__ = "channel_conversations"
|
|
|
|
__table_args__ = (
|
|
UniqueConstraint(
|
|
'channel_account_id', 'external_conversation_id', 'session_id',
|
|
name='uq_channel_conversation_session'
|
|
),
|
|
)
|
|
|
|
id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
|
|
channel_account_id = Column(
|
|
UUID(as_uuid=True),
|
|
ForeignKey("channel_accounts.id", ondelete="CASCADE"),
|
|
nullable=False,
|
|
index=True
|
|
)
|
|
channel_type = Column(String, nullable=False)
|
|
# Platform conversation id: Telegram chat_id, WhatsApp wa_id,
|
|
# Messenger PSID, Instagram IGSID, Slack thread key, email thread id, ...
|
|
external_conversation_id = Column(String, nullable=False, index=True)
|
|
# Platform user id of the customer (often equals the conversation id)
|
|
external_user_id = Column(String, nullable=False)
|
|
|
|
session_id = Column(
|
|
UUID(as_uuid=True),
|
|
ForeignKey("session_to_agents.session_id", ondelete="CASCADE"),
|
|
nullable=False,
|
|
index=True
|
|
)
|
|
|
|
# Denormalized for faster webhook-path lookups
|
|
organization_id = Column(
|
|
UUID(as_uuid=True),
|
|
ForeignKey("organizations.id", ondelete="CASCADE"),
|
|
nullable=False
|
|
)
|
|
agent_id = Column(
|
|
UUID(as_uuid=True),
|
|
ForeignKey("agents.id", ondelete="SET NULL"),
|
|
nullable=True
|
|
)
|
|
customer_id = Column(
|
|
UUID(as_uuid=True),
|
|
ForeignKey("customers.id", ondelete="SET NULL"),
|
|
nullable=True
|
|
)
|
|
|
|
# Timestamp of the customer's latest inbound message; drives the
|
|
# 24h (Meta) delivery-window checks.
|
|
last_inbound_at = Column(DateTime(timezone=True), nullable=True)
|
|
# Channel-specific extras (message thread ids, profile snapshots, ...)
|
|
extra = Column(JSON, default=dict)
|
|
|
|
created_at = Column(DateTime(timezone=True), server_default=func.now())
|
|
updated_at = Column(DateTime(timezone=True), server_default=func.now(), onupdate=func.now())
|
|
|
|
account = relationship("ChannelAccount")
|
|
session = relationship("SessionToAgent")
|