Messaging & Chat

1 Inbox

2 Chat Thread

3 Special States

Inbox

Conversations List Poster

9:41

Messages

Search conversations...

All

Unread

Active Jobs

Martinez Home Services2m ago

We can start the kitchen remodel next Monday...

Kitchen Remodel

Ohio Premier Plumbing1h ago

The bathroom fixtures have been ordered and should...

Bathroom Renovation

Akron Landscape Co3h ago

I've attached the updated layout for your backyard...

Backyard Landscaping

Summit Roofing LLCYesterday

Thanks for the review! Let us know if you need...

Roof Repair

Cuyahoga ElectricFeb 20

The panel upgrade is complete. Please check and...

Electrical Panel

Home

Jobs

Messages 4

Profile

PosterMessages screen. Uses useQuery(api.poster.jobs.getMyJobs) and useQuery(api.messaging.messages.getUnreadCount). Filter tabs, SearchBar, ConversationItem cards with Avatar, unread badges, job tags.

Empty State Poster

9:41

Messages

No Messages Yet

Messages will appear here when you connect with contractors on your jobs.

Home

Jobs

Messages

Profile

EmptyState with IconCircle style C (hero), deepBlue CTA. Shown when jobsWithContractors.length === 0.

Conversations List Contractor

9:41

Search messages...

All

DMs

Q&A

4 conversations · 2 unread

James Wilson5m ago

Hi, I'd like to discuss the timeline for the deck...

Deck ConstructionDM

Sarah Parker20m ago

What type of materials do you use for the siding?

Siding ReplacementQ&A

Rachel Miller2h ago

Perfect, see you tomorrow at 9am for the inspection.

HVAC InstallationDM

Tom KennedyYesterday

Thanks for the great work on the basement finish!

Basement FinishingDM

Job-Scoped ThreadsEvery conversation is linked to a specific job for easy context and tracking.

Home

Jobs

Messages 3

Profile

ContractorMessagesScreen. Uses useQuery(api.contractor.messages.listUnifiedInbox). Terracotta header, DM/Q&A type badges, AI Chat button, filter pills, unread counts.

Chat Thread

Chat Thread Poster

9:41

Martinez Home Services

Kitchen Remodel · Akron, OH

Kitchen Remodel — Full RenovationIn Progress

Today

Hi Sarah! I wanted to let you know the cabinets arrived this morning. We're on track to begin installation tomorrow.

Here's a photo of the cabinets unpacked and ready to go.

That's great news! They look perfect. Will you need me to clear the countertops before you start?

Yes, if you could clear the countertops by tonight, we can start at 8am sharp. The crew will handle everything else.

Contract signed by both parties

Done! Countertops are cleared. See you at 8am.

Type a message...

PosterConversationScreen. Uses useQuery(api.messaging.messages.listForJob), useMutation(api.messaging.messages.send). DeepBlue sent bubbles, Avatar+online dot, job context bar, system pill, read receipts.

Chat Thread Contractor

9:41

James Wilson

Deck Construction · Cuyahoga Falls, OH

Deck Construction — Composite DeckOpen

Yesterday

Hi, I saw your bid and I'm really interested. Can you tell me more about the materials you'd use?

Bid Estimate

$8,450

Composite deck, 400 sq ft, Trex Select, includes railing and stairs

Today

That looks great! When would you be available to come take measurements?

Site Visit Scheduled

I can come by Wednesday, Feb 26 at 10:00 AM to take measurements and finalize the details.

Wednesday works perfectly. See you then!

Quote CardsSend structured bid estimates directly in chat. Homeowners see amount, description, and can accept instantly.

Type a message...

ContractorConversationScreen. Terracotta sent bubbles, quote/bid card, scheduling message with calendar icon, IconCircle style D for attachment.

Attachments & Actions Poster

9:41

Martinez Home Services

Today

Let me know if you need anything else before we start.

Camera

Photo Library

Document

Send Quote

Schedule Visit

Location

Bottom sheet overlay triggered by attachment button. Uses IconCircle styles C, I, A, H, J, K for each action type. Camera and Photo Library use expo-image-picker.

Special States

AI Assistant Poster

9:41

Kitchen Remodel

Martinez Home Services

Kitchen Remodel · In Progress

3Bids AI Assistant is available to help

3Bids Assistant

Hi Sarah! I'm the 3Bids AI assistant. I can help you with scheduling, project FAQs, and communication with your contractor. What can I help you with?

This is an automated response

When is my contractor scheduled to arrive today?

3Bids Assistant

Based on your project schedule, Martinez Home Services is scheduled to arrive at 8:00 AM today for cabinet installation. They typically work until 4:00 PM. Would you like me to send them a reminder?

This is an automated response

Yes, send a reminder

What's the project timeline?

Message my contractor

Ask the AI assistant...

AI messages use MessageBubble with distinct ai style (lightInfo bg), IconCircle style K (robot icon). Quick reply chips below AI messages. Uses api.ai.chat endpoint.

Typing & Notifications Contractor

9:41

3Bids

Rachel Miller

Just sent you a photo of the furnace. Can you take a look?

now

James Wilson

Deck Construction

Today

I'll bring the composite samples so you can see the color options in person.

Read 8:47 AM

Also, did you want to add lighting to the deck? I can include it in the final quote.

Delivered

Message Status Icons

Delivered

Delivered (double check)

Read

Real-Time UpdatesMessages update instantly via Convex. Typing indicators, read receipts, and new messages appear live.

Type a message...

TypingIndicator component (3 animated dots). Push notification preview overlay. Read receipt states: single check (delivered), double check gray (delivered), double check blue (read). Uses Convex real-time subscriptions.

Poster Inbox + Live Conversation

9:41

Messages

Search conversations...

AllUnreadActive Jobs

Martinez Home Services2m ago

We can start the kitchen remodel next Monday...

Kitchen Remodel

Ohio Premier Plumbing1h ago

The bathroom fixtures have been ordered...

Bathroom Renovation

Summit Roofing LLCYesterday

Thanks for the review! Let us know if you need...

Roof Repair

Job-Scoped ThreadsEvery conversation is linked to a job for context and tracking.

Martinez Home Services

Kitchen Remodel · Akron, OH

Kitchen Remodel — Full RenovationIn Progress

Today

Hi Sarah! The cabinets arrived this morning.

9:12 AM

They look perfect. Will you need me to clear the countertops?

9:18 AM

Type a message...

Quote Card, AI Assistant & Read Receipts

9:41

James Wilson

Deck Construction — Composite DeckOpen

Can you tell me more about the materials you'd use?

3:45 PM

Bid Estimate

$8,450

Composite deck, 400 sq ft, Trex Select

I use Trex Select for durability. Includes labor, materials, and cleanup.

3:52 PM

Read 9:20 AM

Quote CardsSend structured bid estimates directly in chat with accept action.

3Bids AI Assistant

Contextual help for this conversation

Suggestion: James may need an updated timeline. Draft a response?

Attachments

deck-samples.jpg

2.4 MB · Feb 24

estimate-v2.pdf

340 KB · Feb 23

Contractor Inbox

9:41

Messages

Search messages...

AllDMsQ&A

4 conversations · 2 unread

James Wilson5m ago

Hi, I'd like to discuss the timeline...

Deck Construction

Rachel Miller2h ago

Perfect, see you tomorrow at 9am...

HVAC Install

Unified InboxDMs and Q&A messages combined in one view with type badges.

James Wilson

Deck Construction · Open

Can you tell me more about the materials?

3:45 PM

I use Trex Select composite. 25-year warranty, low maintenance.

3:52 PM

Contractor Thread & Quote

9:41

James Wilson

Deck Construction — Composite DeckOpen

Yesterday

Can you tell me more about the materials you'd use?

3:45 PM

Bid Estimate

$8,450

Composite deck, 400 sq ft, Trex Select

I use Trex Select for durability. Includes labor, materials, and cleanup.

3:52 PM

Today

That looks great! When can you come take measurements?

8:30 AM

Site Visit Scheduled

Wednesday, Feb 26 at 10:00 AM

9:15 AM

Read 9:20 AM

Type a message...

Quote Details

$8,450

Composite deck, 400 sq ft, Trex Select, includes railing and stairs

Accept QuoteNegotiate

Read Receipts

Read by James at 9:20 AM

Delivered at 9:15 AM

Read ReceiptsSee exactly when homeowners read your messages and quotes.

1 Poster Messages

2 Contractor Messages

3 AI & Templates

Poster Messages

https://app.3bids.io/messages

Messages

47 Active4 Unread

Conversations

Martinez Home Services

Kitchen Remodel

Ohio Premier Plumbing

Bathroom Reno

Summit Roofing

Roof Repair

Martinez Home Services

Kitchen Remodel · In Progress

The cabinets arrived this morning. We're on track for tomorrow.

They look perfect! Will you need me to clear the countertops?

Job Details

Project

Kitchen Remodel

Status

In Progress

Location

Akron, OH

Real-Time SyncMessages sync instantly across all devices via Convex subscriptions.

Contractor Messages

https://app.3bids.io/contractor/messages

Contractor Messages

3 unread

All Conversations

James Wilson

Deck Construction

Sarah Parker

Siding Replacement

Rachel Miller

HVAC Installation

James Wilson

Deck Construction · Open

Can you tell me more about the materials?

I use Trex Select composite. 25-year warranty and low maintenance.

Response TimeRespond within 2 hours to maintain your response rate score and win more bids.

AI & Templates

https://app.3bids.io/contractor/messages/templates

AI Assistant & Templates

AI Assistant

AI Chat Assistant

Draft responses, suggest follow-ups, and answer homeowner questions based on your service history.

Suggestion: James may need an updated timeline. Draft a response?

Use SuggestionDismiss

Message Templates

Bid Follow-Up

Thanks for considering our bid...

Use

Appointment Reminder

Just a reminder about your scheduled...

Use

Job Complete

The work has been completed...

Use

Review Request

Thank you for choosing us!

Use

Custom TemplatesCreate your own templates for common responses to save time on every conversation.

Data Architecture

Schema, queries, mutations, and source files powering Messaging & Chat.

Source Files

app/(poster)/messages/index.tsx

Poster inbox — conversation list with job tags and unread badges

screen

app/(poster)/messages/[id].tsx

Poster chat thread — message bubbles, read receipts, input bar

screen

app/(contractor)/(tabs)/messages/index.tsx

Contractor unified inbox — DM + Q&A with type badges

screen

app/(contractor)/(tabs)/messages/[id].tsx

Contractor chat thread — quote cards, scheduling, read receipts

screen

Convex Queries

poster.jobs.getMyJobs

Poster inbox — jobs with contractor conversations

query

messaging.messages.getUnreadCount

Unread badge count for nav and header

query

messaging.messages.listForJob

Chat thread — messages for a job with real-time subscription

query

contractor.messages.listUnifiedInbox

Contractor DM + Q&A threads with type badges

query

Convex Mutations

messaging.messages.send

Send text, photo, quote, or system message

mutation

messaging.messages.markRead

Mark conversation messages as read

mutation

features.storage.generateUploadUrl

Signed URL for photo/document uploads

mutation

Message Status Flow

unread→read→replied→archived

Key Design Decisions

Dual-Role Views

Poster and contractor see the same thread with role-appropriate colors and actions

Real-Time via Convex

Reactive queries — instant delivery, typing indicators, read receipts

Job-Scoped Threads

Every conversation linked to a job with context bar showing status

AI Assistant

Gemini-powered drafts, follow-ups, and homeowner Q&A support

Quote Cards

Structured bid estimates as special message type with accept action

↑ Back to Top