Skip to main content
The Inbox (nav route /messages) is a unified conversation surface: every email, SMS, and WhatsApp message you send, plus every reply or inbound message that lands in 1Club, shows up here in one chronological list. Open a conversation to read the full thread, draft a reply, or generate one with AI. A message is human-authored correspondence between a club and a member, addressed and replyable. That is what distinguishes it from a notification (“your booking is confirmed”), which is system-generated, one-directional, and not replyable. The Inbox holds only messages. System events live in the notifications surface.

​
Overview

  • Read outbound and inbound messages as threaded conversations in one list.
  • Compose to a single contact, a hand-picked group, or everyone matching a contact-type and tag filter.
  • Send over three channels: email, SMS, and WhatsApp.
  • Reply inside a thread, with an optional Generate with AI draft grounded in your organization’s data.
  • Save drafts, attach files to emails, and reuse custom message templates.
  • Scope access by role: organization-wide for admins and managers, club-scoped for instructors.

​
Channels

Every message carries a type that fixes its channel. The Inbox lists all three side by side.
  • Email - The default for new manual sends. Uses a block editor (subject plus body), supports templates, variables, and file attachments. Delivered through SendGrid.
  • SMS - Plain text, no subject, no formatting. Delivered through Twilio. This is a paid-plan channel because it carries a direct carrier cost.
  • WhatsApp - Sent through a per-organization WhatsApp Business connection (WhatsApp Cloud API). Requires a connected WhatsApp number and a paid plan. A + badge in the conversation row marks contacts whose WhatsApp number is verified.
A new manual message goes out as email. SMS and WhatsApp appear in the Inbox as inbound conversations and as replies: when you reply inside an SMS or WhatsApp thread, the reply stays on that same channel. Automations can also send on any of the three channels. App notifications, which cover the notification center and alerts on a member’s devices, exist in the platform too, but they are emitted by transactional triggers (booking confirmed, waitlist promotion), not composed from the Inbox.

​
How a message becomes a conversation

Sending creates one message record per outbound action and one recipient record per recipient. The Inbox lists only top-level messages: replies (anything with a replyToMessageId) roll up into the thread of their original. A message’s content is canonical and channel-neutral: it is stored as structured blocks (paragraph, heading, button, image), not as rendered HTML. Each channel renders its own projection of that content. The Inbox renders the blocks natively; email renders them through the transactional layout. So the delivered email is a projection of the message, not the message itself. Inbound messages, including replies to your outbound sends, arrive as new top-level messages tagged direction: inbound. Selecting a draft opens the compose pane; selecting any other conversation opens the thread view with an inline reply box.

​
Display sender, display recipient, and send on behalf of

The raw record only shows the staff senderId and the resolved recipient contacts, which is not always who a message should appear to be from or to. Three concepts fix that:
  • Display sender - Who an outbound message appears to be from to the member. By default there is none, so member surfaces fall back to the club and admin surfaces fall back to the sending staff user. When a message is sent on behalf of a specific person, that person’s name and avatar are persisted as the display sender and drive both the member inbox and the delivered email’s from name. Today the one send-on-behalf-of path is the “send from the instructor” option on the review-request automation. senderId is unchanged: it stays the accountable staff user for audit and billing.
  • Message target - Who a member-composed message is addressed to, as the member chose it: the club (the default) or a specific instructor they have a real relationship with. A member never addresses arbitrary contacts.
  • Display recipient - The mirror of display sender for member-initiated threads. It fixes who the conversation appears to be with (the club’s name and logo, or the instructor’s name and avatar), so a club-targeted message never leaks which staff member happened to receive it.

​
AI-assisted replies

Inside a thread, the reply composer has a Generate with AI action. It calls POST /v1/ai-messages/{messageId}/suggest, which uses LangChain plus pgvector retrieval over your organization’s data to draft a response. The model grounds the reply in organization and club details, the member’s recent bookings and memberships, relevant FAQ/policy content, and the conversation history so far. The suggestion lands in the editor as paragraph blocks (and a subject for email), and you can edit anything before sending. The action is only available on replies, because it grounds the response in the original message. New sends do not expose it. Generating a suggestion requires the AI assistant to be enabled for your organization.

​
Permissions and access

The Inbox respects two scopes:
  • Admins and managers see the organization-wide inbox, compose new messages, use audience filters, and pick from custom templates.
  • Instructors see a club-scoped view: only conversations involving members at their club, with no audience filters and no template picker.
The governing permissions are messages.read.own / messages.read.club for viewing and messages.create.own / messages.create.club for composing. A holder of only the .own scope can message specific contacts they select, but cannot broadcast to an audience segment and can only reply to messages they can already read.

​
Plan limits

Each channel is gated differently at send time:
  • Email requires a verified sending domain during trial, and counts against your plan’s email quota. Hitting the quota returns PLAN_LIMIT_EXCEEDED with the daily and monthly figures, surfaced as a dialog rather than a generic toast.
  • SMS is available on paid plans only. On a trial or locked plan the send returns PLAN_FEATURE_LOCKED with an upgrade prompt.
  • WhatsApp is also paid-only and additionally requires a connected WhatsApp Business number. A missing connection returns WHATSAPP_NOT_CONNECTED; a carrier delivery failure returns WHATSAPP_DELIVERY_FAILED.

​
Worked examples

Racket sports - court-closure blast. A padel club needs to warn members that Court 3 is resurfaced this weekend. Compose an email to the member contact type, filtered to the “Padel league” tag, write the notice in the block editor, attach the revised weekend schedule as a PDF, and send. Replies from members land back in the Inbox as inbound messages threaded under nothing new, ready for a one-tap reply. Martial arts - belt-test reminder over WhatsApp. A jiu-jitsu gym with a connected WhatsApp number gets an inbound question from a student about the upcoming grading. Open the thread, tap Generate with AI to draft a grounded reply (it pulls the student’s recent attendance and the club’s grading policy), tweak the date, and send. The reply goes out on WhatsApp because the conversation is a WhatsApp thread. Pilates/Yoga - lapsed-client win-back. A reformer studio filters to the lapsed contact type and sends a warm email offering a return class. Because the audience is a segment, this requires organization-level compose access, not an instructor’s club-scoped inbox. Gym/Fitness - event promotion. From a HIIT open-day event, the Promote button opens the composer prefilled with the event cover image, title, date and location, and a “view event” button, addressed to all members. Pick or adjust the audience and send.

​
Tips & best practices

  • Reserve SMS and WhatsApp for time-sensitive, high-value messages. They cost more and read as more urgent than email.
  • Let AI draft the first pass on routine replies (hours, pricing, policies), then edit for tone. It is grounded in your club’s data, but you are accountable for what sends.
  • Segment with tags rather than blasting your whole contact list. Filtered sends keep engagement high and unsubscribes low.
  • Use the “send from the instructor” path for relationship messages so members see a familiar name, not a generic club sender.

​
Troubleshooting

  • Compose a message - The send flow, recipient filters, channels, and template usage.
  • Message list - The Inbox view, conversation rows, and thread management.
  • Templates - Reusable manual-send message templates and the variable picker.
  • Automations - Trigger-based and scheduled sends that run automatically, instead of manual messaging.
  • Contacts - Tag and segment the contacts you message.