How It Works
Multi-Channel Messaging
Sparky communicates with customers and electricians through whatever channel suits them best: in-app chat for real-time conversation, SMS via Twilio for quick texts, email via Postmark for detailed information, and push notifications for instant alerts.
AI-Powered Voice Calls
Sparky can make real phone calls using ElevenLabs conversational AI. When contacting electricians about a new job, the AI calls them, explains the work needed, and handles the conversation naturally.
Intelligent In-App Chat
The in-app chat isn't just messaging — it's backed by Sparky's AI with deep knowledge of UK electrical regulations. Customers can ask questions about their job, what certificates they need, or whether work requires Part P notification.
Automated Notifications
Every significant event triggers automatic notifications: job matches, quote received, payment held, work scheduled, job completed, review period started. Customers and electricians are always in the loop.
Unified Communication Thread
All communication about a job — regardless of channel — is unified in one thread. Whether a message came via SMS, email, or in-app, you can see the complete conversation history in the app.
Benefits for Electricians
- Get contacted about new jobs via phone call, SMS, or email — whichever you respond to fastest.
- All customer communication is managed by Sparky, reducing time spent on phone calls, texts, and emails.
- Never miss a job opportunity. Sparky reaches you across multiple channels until you respond.
- Professional communication on your behalf. Sparky presents job details clearly and handles customer questions.
- Focus on the work while Sparky handles the customer-facing communication and updates.
Benefits for Customers
- Chat with Sparky's AI any time to ask questions about your job, electrical regulations, or what to expect.
- Receive updates through your preferred channel — push notifications, SMS, email, or all three.
- Never left waiting. The AI responds to questions instantly, 24/7, with knowledgeable answers.
- Unified conversation history means you can always find past messages about any job in one place.
- Real voice calls from Sparky's AI keep you informed about important updates, not just text notifications.
Under the Hood
Sparky's communication system spans five channels, all orchestrated by the AI agent running on Convex. In-app chat uses Convex real-time subscriptions for instant message delivery, with the AI (Gemini 3 Flash via OpenRouter) responding to customer queries in the chat thread. SMS is handled bidirectionally through Twilio — the same phone number used for voice calls, so customers and electricians see a consistent contact. Email runs through Postmark with the `sammy@book-sparky.com` sender address. Voice calls use ElevenLabs conversational AI for both outbound calls (contacting electricians) and inbound calls (receiving callbacks), with a natural-sounding AI voice that can explain jobs, answer questions, and confirm details. Push notifications are delivered via Expo's push notification service for mobile users. All channels route through Convex serverless functions, and the AI agent uses `ctx.scheduler.runAfter(0, ...)` to trigger asynchronous communication actions without blocking the main conversation flow.

