Messaging

import { Amba } from '@layers/amba-web';
 
// Create a 1:1 conversation between the signed-in user and another
// user. For `type: 'direct'` the call is idempotent — calling it
// again with the same other-participant returns the existing row.
const conversation = await Amba.messaging.createConversation({
  participant_ids: [otherUserId],
  type: 'direct',
});
 
// Send a message into that conversation
const message = await Amba.messaging.sendMessage(conversation.id, {
  body: 'hey, want to start a daily streak together?',
});
 
// List the user's conversations (renders an inbox / chat list)
const conversations = await Amba.messaging.getConversations();
for (const c of conversations) {
  console.log(c.id, c.last_message?.body);
}
 
// Page through messages in a conversation (renders the thread view)
const messages = await Amba.messaging.listMessages(conversation.id, {
  limit: 50,
});
 
// Mark the conversation as read once the user has scrolled the thread
await Amba.messaging.markRead(conversation.id);

import { AmbaApiError } from '@layers/amba-web';
 
async function startConversation(otherUserId: string, firstMessage: string) {
  let conv;
  try {
    conv = await Amba.messaging.createConversation({
      participant_ids: [otherUserId],
      type: 'direct',
    });
  } catch (err) {
    if (err instanceof AmbaApiError) {
      if (err.code === 'USER_NOT_FOUND') {
        // One of the participant_ids doesn't exist on this project —
        // show "invite them to Amba" UI.
        return { ok: false, reason: 'recipient_not_on_amba' };
      }
      if (err.code === 'INVALID_PAYLOAD') {
        // participant_ids was empty, malformed, or the type field was bad.
        // err.details.missing lists the missing fields.
        return { ok: false, reason: 'bad_input', details: err.details };
      }
    }
    throw err;
  }
 
  await Amba.messaging.sendMessage(conv.id, { body: firstMessage });
  return { ok: true, conversationId: conv.id };
}

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": {}
}