homeserver = "https://matrix.example.com" username = "@botname:example.com" password = "your-bot-password" # List one or more rooms to listen in. Use a single-element list for one room. room_ids = ["!roomid:example.com"] # Optional: the deprecated single-room key is still accepted for backwards compat. # room_id = "!roomid:example.com" allowed_users = ["@youruser:example.com"] enabled = false # Maximum conversation turns to remember per room (default: 20). # history_size = 20 # Rooms where the bot responds to all messages (not just addressed ones). # This list is updated automatically when users toggle ambient mode at runtime. # ambient_rooms = ["!roomid:example.com"] # ── WhatsApp Business API ────────────────────────────────────────────── # Set transport = "whatsapp" to use WhatsApp instead of Matrix. # The webhook endpoint will be available at /webhook/whatsapp. # You must configure this URL in the Meta Developer Dashboard. # # transport = "whatsapp" # whatsapp_phone_number_id = "123456789012345" # whatsapp_access_token = "EAAx..." # whatsapp_verify_token = "my-secret-verify-token" # # ── 24-hour messaging window & notification templates ───────────────── # WhatsApp only allows free-form text messages within 24 hours of the last # inbound message from a user. For proactive pipeline notifications sent # after the window expires, an approved Meta message template is used. # # Register the template in the Meta Business Manager: # 1. Go to Business Settings → WhatsApp → Message Templates → Create. # 2. Category: UTILITY # 3. Template name: pipeline_notification (or your chosen name below) # 4. Language: English (en_US) # 5. Body text (example): # Story *{{1}}* has moved to *{{2}}*. # Where {{1}} = story name, {{2}} = pipeline stage. # 6. Submit for review. Meta typically approves utility templates within # minutes; transactional categories may take longer. # # Once approved, set the name below (default: "pipeline_notification"): # whatsapp_notification_template = "pipeline_notification" # ── Slack Bot API ───────────────────────────────────────────────────── # Set transport = "slack" to use Slack instead of Matrix. # The webhook endpoint will be available at /webhook/slack. # Configure this URL in the Slack App → Event Subscriptions → Request URL. # # Required Slack App scopes: chat:write, chat:update # Subscribe to bot events: message.channels, message.groups, message.im # # transport = "slack" # slack_bot_token = "xoxb-..." # slack_signing_secret = "your-signing-secret" # slack_channel_ids = ["C01ABCDEF"]