Messaging Service

The Agglestone Messaging Service is a comprehensive, standards-based messaging platform that provides real-time chat functionality and notification delivery. It provides everything you need to enable instant messaging and notifications in your applications, with complete tenant isolation and flexible integration options.

Quick Overview

The service offers:

• Real-Time Chat functionality with WebSocket-based instant messaging
• Notification Delivery with inbox management and optional email delivery
• SignalR Integration for reliable WebSocket connections with automatic reconnection
• REST APIs for all messaging and notification operations
• Multi-tenant Architecture with complete tenant isolation
• Message Persistence for conversation history and notification inboxes

Documentation

Getting Started

• Overview – Introduction to the service, its capabilities, and who it’s for
• Quick Start Guide – Chat – Get real-time chat functionality working in minutes
• Quick Start Guide – Notifications – Get notification functionality working in minutes

Feature Documentation

• Chat Features – Comprehensive guide to all chat capabilities including real-time messaging, chat channels, message management, and member management
• Notifications Features – Notification capabilities including inbox management, email delivery, scheduling, and notification types

Integration Guides

Chat Integration

• Chat Integration Guides – Complete guide to all chat integration documentation
• Creating Chats and Sending Messages – How to create chat channels and send messages
• Message Events and Retrieving Messages – Real-time message events, retrieving individual messages, and paginated message lists
• Managing Chat Members – Adding and removing members from chat channels

Notifications Integration

• Notifications Integration Guides – Complete guide to all notifications integration documentation
• Creating and Sending Notifications – How to create and send notifications with all available options
• Notification Events and Retrieving Notifications – Real-time notification events, retrieving individual notifications, and paginated inbox lists
• Managing Notifications – Marking notifications as read/unread and deleting notifications

Standards and Protocols

The service is built on industry standards:

• WebSockets (RFC 6455) – Real-time bidirectional communication
• SignalR – Reliable WebSocket connections with automatic reconnection
• REST APIs – Standard HTTP conventions for all messaging operations
• JWT Authentication – Secure, token-based access control

Common Integration Paths

Frontend Applications

1. Start with the Quick Start Guide – Chat or Quick Start Guide – Notifications
2. Review Message Events and Retrieving Messages or Notification Events and Retrieving Notifications for real-time event handling
3. Explore Chat Features or Notifications Features for available capabilities
4. Implement Creating Chats and Sending Messages or Creating and Sending Notifications for sending functionality

Backend Services

1. Review Creating Chats and Sending Messages or Creating and Sending Notifications for API endpoints and request/response formats
2. Check Message Events and Retrieving Messages or Notification Events and Retrieving Notifications to understand message/notification retrieval and pagination
3. Review Managing Chat Members or Managing Notifications for management APIs

Full-Stack Applications

1. Follow the Quick Start Guide – Chat or Quick Start Guide – Notifications for complete integration flow
2. Review Chat Features and Notifications Features for all capabilities
3. Implement Creating Chats and Sending Messages or Creating and Sending Notifications for sending functionality
4. Use Message Events and Retrieving Messages or Notification Events and Retrieving Notifications to handle real-time updates
5. Implement Managing Chat Members or Managing Notifications for management functionality

Resources

• API Documentation: Interactive Swagger UI at https://messaging.agglestone.com/swagger
• Portal: Manage your tenant settings at https://portal.agglestone.com
• Service Base URL: https://messaging.agglestone.com/

—

Ready to get started? Begin with the Overview or jump straight to the Quick Start Guide – Chat or Quick Start Guide – Notifications!