Messaging

Amba provides in-app messaging for direct and group conversations between users.

Client API reference

Method	Path	Description
`POST`	`/client/messaging/conversations`	Create a conversation
`GET`	`/client/messaging/conversations`	List user's conversations
`POST`	`/client/messaging/conversations/:id/messages`	Send a message
`GET`	`/client/messaging/conversations/:id/messages`	Get messages (paginated)
`POST`	`/client/messaging/conversations/:id/read`	Mark conversation as read

POST /client/messaging/conversations
{
  "participant_ids": ["user_xxx", "user_yyy"],
  "type": "direct"
}

POST /client/messaging/conversations/:id/messages
{
  "body": "Hey, want to do a workout challenge together?",
  "metadata": {}
}

Tool	Description
`amba_get_messaging_stats`	Get messaging statistics (total conversations, messages, active count)

Table	Purpose
`conversations`	Conversation records with type (direct, group)
`conversation_participants`	Participant records linking users to conversations
`messages`	Individual messages with body, sender, and metadata