Connect by JBRH Open Connect

Connect by JBRH documentation

Every public page about Connect: what each capability does today, the end-to-end workflows, the technology behind them, and what to do when something fails. Each page states its status and the date it was last checked against the running system.

Status
Available What this means
Audience
both
Last verified
Product version
6.3.2

Docs#

PageWhat it covers
Phone and voice in ConnectHow Connect answers and places calls: the two voice engines, what a line owns, and where every phone topic in this manual sits.
Email in ConnectThe email channel end to end: the providers you can connect, what a mailbox owns, how a provider message becomes canonical, and where every other email page sits.
Prospecting in ConnectThe prospecting section: the stages from a discovery brief to a first reply, the evidence rule underneath them, and where each page sits.
Relationships in ConnectThe section map: Person, Identity and Company, the console that answers one relationship for both audiences, and where every other page here sits.
Sales in ConnectOpportunities, the pipeline and demos — and the line between a question Connect can answer from Knowledge and a commercial decision it must escalate.
Follow-ups in ConnectThe section map: what a dated commitment is, the six channels one can sit on, which of them a drain executes, and where every other page here lives.
Support in ConnectThe section map: what a support case is, how onboarding works, why the relationship carries on after the sale, and where website enquiries actually live.
WhatsApp in ConnectWhatsApp as a Connect channel: the two ways a number is connected to Meta, what Meta decides, and where every WhatsApp topic in this manual sits.
SMS in ConnectSMS in Connect is a foundation: inbound, dedupe, STOP and suppression work; outbound depends entirely on the provider, and the live carrier carries no SMS.
Connect AssistantWhat the Connect Assistant is, the 66 tools behind it, how every write reaches a record, and the authority it deliberately does not have.
Memory in ConnectWhat Connect remembers about a business and its people: four tiers resolved narrowest-first, how each is written, and how a person reads or forgets any of it.
Knowledge in ConnectWhere a grounded answer comes from: the sources a workspace supplies, the authority each one carries, and how a few passages reach a reply.
What Connect may doThe controls deciding what Connect may send, call or do on its own: four modes, four scopes, the approval queue, and the decision log.
Files and data in ConnectThe two halves of Files and data: one file service shared by both audiences, and a grid over 13 record sheets that never writes to a table directly.
Account and accessHow you get into Connect, what a session is, which workspace you land in, who may change what, and the switches an individual person owns.
Security and isolationHow one workspace is kept from another, what is recorded and reviewable, and what this section deliberately does not publish.
Connect by JBRHWhat Connect by JBRH is, the five channels it works across, the records it keeps, and the controls that decide what it may do without asking.
Getting started with ConnectThe shortest route from an empty workspace to Connect handling real work: the order to do things in, what each step proves, and where setups stall.
How-to guidesTask-shaped instructions for Connect: each guide is one job from first action to proof it worked, with the recovery when it did not.
Business use casesThe shapes of work Connect is put to, what each one needs configured first, and the limits that decide whether a given shape is possible at all.
Technology referenceHow to read the technology reference: the ten questions every page answers, the five status words, and the rule that Connect's own use is always stated.
Protocol referenceThe wire protocols and description formats Connect speaks, the exact version of each, and which ones Connect only explains rather than runs.
End-to-end workflowsHow every end-to-end flow in this manual is documented: the twelve stages, what each promises, how to read the failure column, and the index of every flow.
GlossaryOne canonical definition per term in Connect, and the rule that every other page links here instead of defining a word a second time.
Comparisons and conceptsThe index of Connect's comparison pages: how it sits beside a CRM, a helpdesk or a call centre, and the internal distinctions people confuse.
TroubleshootingThe index of documented failures, plus how to read a page here: what each one promises, the three questions to answer first, and what is never printed.

Phone#

PageWhat it covers
Your business number in ConnectWhat a phone number becomes once a workspace claims it: a channel_routes line that carries the provider, the permissions, the hours and the routing.
Configuring a phone lineThe ten facts that make up a phone line, what each one refuses when it is set wrongly, and the order to decide them in.
How a call reaches your workspaceHow a dialled number becomes a workspace, why every handler enters that workspace before reading a setting, and what an unclaimed number does.
Carrier callback verificationWhy every carrier callback is signature-checked inside the owning workspace, what a replayed webhook looks like, and the index that stops one.
Answering inbound callsFrom ring to greeting to first reply: the gates a caller passes, what they hear at each refusal, and what is written down while they talk.
Placing outbound callsThe five gates an outbound call passes before a number is dialled, what each refusal means, and how a call-back gets placed at all.
Business hours and the closed lineHow opening hours are set on a line, what a caller hears outside them, and why the closed-line message never speaks the hours aloud.
Switching the line offWhat switching a phone line off does to a caller, to the call record and to work already scheduled on that line — and why it is not silence.
The call recordEvery field on a call: ring and answer times, provider status, cost, participants, quality, and why outcome and disposition are separate columns.
Call transcriptsHow a call transcript is assembled turn by turn, what the latency beside a reply actually measures, and the three things a transcript is not.
Call summariesWhen a call summary is written, the two conditions under which Connect refuses to write one, and what a summary is allowed to contain.
Call outcomes and dispositionsThe engine's outcome and a person's disposition are two columns answering two questions. What each one says, and how to use them together.
Who ended the callThe six values of hangup_by, why every non-caller ending once read as 'agent', and how to tell an ended call from a dropped one.
Calls that were never a conversationno_answer, not_reached and silent failure are three different nothings. What each one means, how to tell them apart, and why none creates a lead.
The realtime voice engineThe speech-to-speech calling path: how a workspace turns it on, what the worker is given for each call, and what it is never allowed to know.
The carrier turn-based engineThe carrier webhook path — gather, reply, redirect — when it is the right engine for a line, and the three things it cannot do.
The voice workerThe process that holds a realtime call: how it starts, what it heartbeats, how a deploy drains it, and what a caller gets when none is running.
Capacity and admission controlHow admission decides a call can be taken: load per core, the 0.85 threshold, why a silent worker reads as free, and what saturation does to a caller.
The greetingHow the first sentence of a call is chosen, why it is synthesised while the phone is still ringing, and what happens when it cannot be spoken.
Greeting warm-upHow Connect has the first sentence of a call already synthesised before the phone is picked up, and the quota refusal that once cost every restart its warm greeting.
Barge-inSpeaking over the voice on a live call: what stops it, the two-second rule that decides an interruption was ignored, and why the greeting is protected.
Turn detection and end of speechDeciding that the caller has finished speaking: the model's own detection, the host semantic path with dynamic endpointing, and how to choose between them.
Silence and check-insWhat Connect does when nobody is speaking: how presence is tracked, why nothing is said over a caller, and what a silent stretch leaves on the record.
Abandoned callsCalls the caller walked away from: how the hang-up watcher recognises real abandonment, what it records, and why no closing line is spoken.
Reply latency on a callHow long a caller waits for a reply: what the clock measures, where the floor comes from, and how to tell a slow reply from a slow model.
The response watchdogThe timer that asks a stalled model to answer: why its default is 5.5 seconds, what disarms it, and how a nudge can cancel the very reply it was waiting for.
Multilingual callingCalls held in more than one language: how the opening choice is made, what may change part-way through, and what a mixed sentence does.
Detecting the caller's languageWhat counts as proof a caller has changed language: four tiers with four different bars, the transcript artefacts that never count, and what pinning overrides.
Remembering a caller's languageA caller's remembered speaking preference: where it is held, why Connect speaks it from the first reply, what overrides it, and what it costs in the brief.
Regional speaking styleThe regional speaking-style layer: the prompt directions it adds, the things it cannot touch, and why a rendered cadence rule was removed rather than kept.
Light code-mixing and slangHinglish and light slang on a call: when a mixed sentence counts as evidence and when it does not, and what asking a model for a register achieves.
Identifying the callerTurning the number that rang into a person: the phone key, the rule when two records share a number, and what happens when nobody gives a name.
Names heard on a callWhat happens to a name spoken on a call: the protected markers, why a form of address never becomes one, and every door it must pass on the way in and out.
A returning callerThe second time somebody rings: what Connect has already, how little of it reaches the conversation, and why continuity is not the same as recital.
The call briefEverything assembled before a call starts: persona, purpose, contact facts, knowledge, rules and guidance — each with a character budget, and why the budgets exist.
Voice profilesNamed bundles of voice settings: where one can be attached, the six-step resolution order that decides which wins, and what is recorded on the call.
Human voice profilesOne choice that yields a whole person: 86 parameters across identity, speech, imperfections and psychology, and the ones marked unsupported rather than faked.
The Voice LabThe screen where a line's voice is tuned: engine settings that take effect exactly, steering text the model interprets, drafts and test calls.
Call quality reviewWhat a finished call is scored on: deterministic findings with the setting each one points at, the model's opinion kept separate, and limits that do not lower the score.
What a setting cannot changeFindings the call review counts but does not score, why they come with no control to turn, and the two behaviours proven unreachable by prompting.
Connect's own voiceWhy the words a caller hears are synthesised by Connect rather than the carrier, how a sentence becomes a cached MP3, and the rule that forbids silence.
Telling the voice how to speakThe style block and the behaviour block: which settings become session parameters, which become instructions a model may only approximate, and which are neither.
Steering a live callThe panel a colleague uses to steer a call in progress: why guidance never reaches the caller, and why pause, take over and release are read back out of the log.
Transfer and escalationWhat an escalation phrase queues on a live call, why the transfer capability is asked of the provider rather than assumed, and what the live carrier does not carry.
Calling from the browserThe browser line: a per-person SIP endpoint, why every state the dialler shows comes from a SIP event, and how a browser call actually makes a phone ring.
Follow-ups from a callHow a spoken commitment on a call becomes a dated follow-up: the words that parse into a time, the channel it lands on, and the default when nothing parses.
Promises made on a callThe rule that refuses a follow-up time the caller never said, what counts as agreeing to one, when a read-back is asked, and the finding for an empty promise.
Executing phone follow-upsThe drain that places a due call-back, the gates each one passes, the retry when no voice worker is ready, and the point at which a late follow-up is abandoned.
Facts learned on a callWhat a phone call leaves behind in Memory, which extracted facts are refused outright, and how something heard on a call reaches a conversation on another channel.
Leads captured from a callWhen a phone call creates a Person and a lead, the two call endings that deliberately create nothing, and the key the record carries from the very first ring.
Phone line healthThe four things line health reports about a phone line, what each one means for somebody ringing the number, and why none of them has to be cleared by hand.
What a call costsWhy a voice call is metered by modality rather than by a total token count, the reporting field that never existed, and what a call reporting no tokens is charged.
The budget that stops a callThe budget question asked before an outbound call and before answering an inbound one, what a refused caller hears, and how the quota breaker differs from it.
Stuck calls and the sweepCall rows left active by a worker that died or a browser call with no worker behind it, the sweep that closes them against the provider cap, and what it charges.
Consent on callsWhere consent for a phone call is decided, the single outbound path every call passes through, and why a block recorded elsewhere already applies to the phone.
Session limits and long callsThe model's session cap, the context window, the provider cap and the product's own thirty-minute ceiling — which one ends a long call, and what a caller notices.
Phone for the Owner and for a customerWhat the phone channel does identically for the operator and for a customer workspace, what a plan changes, and the small set of things that stay operator-only.

Workflows#

PageWhat it covers
Inbound phone call, end to endA call arriving on a Connect number, stage by stage: what the caller hears, what is written, which provider acts, and what fails where.
Outbound phone call, end to endPlacing a call: the reason it exists, the gates it passes, the dial itself, and what is written whether or not anybody answers.
A promised call-back, end to endA call-back promised out loud becomes a dated commitment and then a ring: how the time is read, when it is refused, and when it is too late to place.
Connecting a phone line, end to endConnecting a number to Connect: the line record, the carrier link, and the four verifications that separate a configured line from an answering one.
Turning on the realtime engine, end to endSwitching a workspace to the speech-to-speech engine: the trunk, the dispatch rule, the worker and the console steps that have no API at all.
From a call to a customer relationshipWhat survives a phone call: the person, the company, the timeline entry and the next action, and the rules that stop each of them being invented.
Escalating a call to a personWhen a caller asks for a person: what is queued, what the caller hears, what a colleague can do on the live call, and what a completed transfer still depends on.
Making a call from the browserA person dialling from the browser: the SIP registration, the invite that does not dial the number in it, the bridge, and what is recorded as human-owned.
Tuning the voice, end to endChanging how the voice sounds and behaves, then proving the change: the two kinds of control, the test call, the review, and the findings no setting can fix.
Recovering a failed callEvery way a call can fail on this path and the recovery for each, in the order the failures are detected — from admission control to a late provider webhook.
Inbound email, end to endEvery stage between a message landing at the provider and Connect acting on it: fetch, bridge, thread, triage, and where mail can be lost.
Drafting and approving a reply, end to endFrom an arriving message to a sent reply, with the autonomy gate in the middle: what is drafted, what is held, who releases it, what proves it went.
Connecting Gmail, end to endConnecting a Google mailbox from the consent screen to the first synced thread, with the evidence that proves each step actually happened.
Connecting an IMAP mailbox, end to endConnecting a plain IMAP and SMTP mailbox: what you supply, the two separate proofs that must pass, and what a half-working connection looks like.
Repairing a broken mailbox, end to endDetecting that a mailbox has stopped working, finding which half broke, reconnecting without creating a second row, and proving the repair held.
An email follow-up, end to endA dated commitment becoming a sent email: where the follow-up came from, which gates it passes, and why a retry cannot send it twice.
An outreach sequence, end to endCold outreach from first contact to the reply that stops it, with every compliance gate named and the point where a stranger becomes a conversation.
An unsubscribe request, end to endWhat happens between somebody asking to be left alone and the record that proves it: the suppression, its scope, and the one entry nobody clears casually.
Hitting the daily allowance, end to endWhat Connect does when the day's allowance is spent: what is held, what is refused, why the read cursor stays where it is, and how work resumes.
From an email to an opportunityThe reply that turns into a deal: which records change, in what order, and what keeps the pipeline honest about where the evidence came from.
Discovering prospects, end to endOne discovery run followed from the brief to a qualified list: every stage, every gate that can stop it, and what exists afterwards.
Researching one prospect, end to endOne candidate followed through research: what is read, how a claim earns its place on the record, and what happens when nothing can be proved.
First outreach to a prospect, end to endThe first message to a prospect, followed from readiness through the compliance check, the draft, approval and the send that only counts with provider evidence.
Handling a prospect's reply, end to endWhat happens between a prospect's reply landing and the record it changes: classification, the stop rules, and when a relationship is created.
Importing a prospect list, end to endAn import followed from the file to usable prospects: what each stage does to a row, what is merged, what is refused, and what the summary is for.
From first contact to a person recordA stranger writes or rings on any channel and becomes a canonical person: every stage, what changes, what can fail, and what happens on the second channel.
Merging duplicate people, end to endFrom a duplicate proposal to one merged record: every stage, the human decision in the middle, and how to verify the result afterwards.
From prospect to client, end to endOne relationship followed from a discovered name to a paying client, naming every record that is created, changed or left behind on the way.
From client to support, end to endWhat carries over when a deal is won: onboarding, the first support case, and the continuity that depends on one person record rather than two.
Continuing one conversation on another channelWhat happens when someone who emailed last week rings instead: how the same person is recognised, and exactly which context follows them.
Creating an opportunity, end to endFrom a sentence in a conversation to a deal on the board with its first commitment: every stage, what changes, and what can fail on the way.
Moving a deal from stage to stage, end to endEvery stage change on an opportunity: what is checked before it, what is written after it, and the side effects a move sets off downstream.
Answering a commercial question, end to endA customer asks what it costs: the grounded answer, the refusal, the escalation, the human decision, and how the same question stops recurring.
Closing a deal, end to endWhat changes when an opportunity is marked won or lost: the stage rules, the stored value, the follow-ups that stop, and what picks the person up next.
Creating a follow-up, end to endFrom a promise made out loud to a scheduled row: the guard on the time, the channel decision, the duplicate test, and what each stage records.
Executing a follow-up, end to endFrom due to placed, held or refused: the drain's rate, every gate in order, the outcome written back, and the lateness rule that ends it.
Approving a follow-up, end to endHow a follow-up Connect may not execute on its own reaches a person, what the approver is allowed to change, and what runs after the yes.
A support case, end to endA customer problem from the message that raises it to the resolution and the memory it leaves: every stage, what changes, and what can fail at each.
Onboarding, end to endOnboarding from the won deal to steady state: the stages, who does what between them, and the failures that leave a new customer waiting.
A website enquiry, end to endA public-site enquiry from the submitted form to an answered person, and the stage where having no workspace decides everything that follows.
An inbound WhatsApp message, end to endOne inbound WhatsApp message followed the whole way: Meta's signed webhook, the stored record, the draft, the autonomy decision and the timeline entry.
A WhatsApp follow-up, end to endA scheduled WhatsApp follow-up from due to sent: the composition, the autonomy and consent checks, the window, and the template fallback when Meta refuses.
Connecting WhatsApp, end to endConnecting WhatsApp from a Meta credential set to a first verified inbound message, the QR alternative, and the checkpoint that proves each half of the chain.
A WhatsApp opt-out, end to endA WhatsApp opt-out followed end to end: the STOP word, the three records it writes, what changes for every pending message, and the START that reverses it.
An inbound SMS, end to endAn inbound text message followed from the provider webhook to the person it belongs to and the decision about answering it, with what can fail at each stage.
An SMS STOP, end to endA stop request followed from the word in the message to the suppression, the audit entry and the confirmation, including what is deliberately skipped.
Preparing for DLT, end to endPreparing for DLT in India: what a business gathers, in what order the three registrations must be obtained, and what Connect stores once they are granted.
Asking the Assistant a question, end to endA question typed into the Assistant, followed all the way to a grounded answer: what runs at each stage, what it costs, and where an answer loses its citations.
Asking the Assistant to do something, end to endFrom an instruction to an audited change: how a writing tool becomes a proposal, what the confirmation buys you, and where autonomy re-enters the path.
Working on a file with the Assistant, end to endAttaching a file to the Assistant and working on it: validation, extraction, the answer, the new version, and where the file ends up linked.
Correcting Connect from a conversation, end to endFrom a wrong answer to changed behaviour: how a correction typed in conversation becomes a memory at a tier, and what proves it actually took effect.
Undoing an action, end to endUndoing an Assistant action: the three outcomes — reversed, compensated, or recorded only — and how to tell which one your action will get.
Correcting what Connect knows, end to endFrom a reply that was wrong to a corrected memory to changed behaviour: every stage, what changes at each, and the three places a correction fails to stick.
A fact learned on a call, end to endFollowing one spoken fact from the moment it is said, through the checks that decide whether to believe it, to the email where it is used a week later.
Blocking a contact, end to endOne tag on one memory row, and what it stops across email, WhatsApp, SMS and voice — including the browser line a colleague dials from.
Reviewing everything Connect knows about a personThe audit anyone can run on one person's record: the four tiers, the tags, the identities behind them, and the decisions that follow from what you find.
Adding a Knowledge source, end to endFrom choosing a file to a passage that answers a question: every stage of adding a Knowledge source, with the status the record carries at each.
Producing a grounded answer, end to endA customer question turned into a defensible reply: scopes, retrieval, the sufficiency gate, drafting under labelled context, and the citations kept.
Resolving conflicting Knowledge, end to endFrom a contradiction being detected to a source that answers again: what is compared, what is refused, and the decision only a person can take.
Auditing what an answer was based onTaking one sentence in a sent reply and following it back to the passage, the authority and the person who allowed it to be said.
Approving a held action, end to endA held action from the moment it reaches the queue to the provider's acknowledgement: who may decide, what an edit changes, and what the log keeps.
Changing what Connect may do, end to endChanging an autonomy rule end to end: what takes effect at once, what the change cannot reach backwards, and where the change itself is recorded.
Working the Needs You queue, end to endOne full pass through Needs You: how the list is ordered, what each kind of item wants from you, and what an empty queue does and does not prove.
Escalating to a person, end to endWhat happens when Connect decides it should not answer: how the refusal becomes a person's decision, and how that decision gets into future work.
Stopping Connect, end to endThe runtime switch end to end: what stops the moment you use it, what was already handed to a provider, and what is waiting when you switch back on.
Uploading a file and answering from it, end to endThe whole path from dropping a file into Connect to reading an answer grounded in it: validation, safe parsing, extraction, grounding and the citation.
Creating a document, end to endFrom asking for a document to a produced file sitting on the right record: what is resolved, what is proposed, what is written, and what is deliberately left blank.
Changing a document, end to endChanging a stored document from end to end: which version is read, what the proposal shows, what the new version records, and what the old one keeps.
Editing many records at once, end to endSelecting many rows in the Data grid and changing them together: how a selection becomes one service call per record, and what a partial result means.
Importing records, end to endBringing records in from a spreadsheet: how a file becomes validated rows, how duplicates are matched, and what happens to rows that do not qualify.
Signing in for the first time, end to endFrom the Google consent screen to the first working screen: what a session is, how one workspace is resolved, and what a first sign-in does not do.
Setting up a workspace, end to endTaking a workspace from empty to working: the business profile, the channels, what Connect is allowed to say, and what it may do unsupervised.
Adding a colleague, end to endHow a second person gets into a workspace: membership, their own Google sign-in, the role that gates configuration, and what is recorded per person.
Changing plan, end to endWhat a plan change alters the moment it lands, what it deliberately leaves alone, and why a lowered ceiling never removes anything you already have.
A lapsed plan and its recovery, end to endThe whole arc of a lapse: what stopped, what queued rather than failed, and the order in which work resumes once the workspace is live again.
Proving a workspace is isolated, end to endA layer-by-layer check that one workspace cannot reach another's records, what each of the three layers catches, and what each of them cannot see.
Rotating a provider credential, end to endReplacing a provider credential in a workspace: what happens on save, how to verify a value you can never read back, and what becomes of work in flight.
Responding to a suspected access problem, end to endWhat to do when access to a workspace looks wrong: contain first, establish scope from evidence, then rotate — in that order, with what each step proves.
Google sign-in, end to endFrom the Google consent screen to a working session: what Google proves, what Connect binds it to, and the mismatch it refuses rather than resolves.
Establishing a session, end to endWhat a session actually is in Connect: what the server keeps, what the browser holds, what it resolves to, and what can be ended from which side.
Binding a Google identity to a person, end to endHow a Google account becomes a person in Connect: binding on the first non-empty subject, adopting a row that predates them, and refusing a later mismatch.
Resolving which workspace a request belongs toHow a request is tied to exactly one workspace before any handler runs, and the three independent places that resolution is enforced afterwards.
Routing a request for the Owner or a customerOne implementation, two doors: how a request is rewritten for a customer, checked against an allowlist, and refused in the two ways that both fail closed.
Granting a permission, end to endGranting or removing a permission in a workspace: who may do it, when the change takes effect, what it does not widen, and the record it leaves.
Turning Connect on or off at runtimeWhat the runtime switch actually stops, what finishes anyway, what happens to work that was scheduled, and what the people on the other end experience.
Entitlement and runtime choice, end to endTwo separate gates decide whether Connect acts: what the plan permits, and what a person has switched on. Both must agree, and they fail differently.
A plan lapsing, end to endWhat a lapsed plan actually stops: which work is refused, which is held, why the mail cursor stays where it is, and what returns on settlement.
Signing out and replacing a sessionThe two ways a session ends on one browser — signing out, and signing in as somebody else — and why neither of them touches your other devices.
Reviewing account security, end to endA working review of one workspace's access: the sessions, the provider grants, the stored credentials and the audit trail, with the question to ask of each.
Assigning a mailbox role, end to endGiving a mailbox a role, from the click to the first message it re-routes: what is stored, what routing changes, and which conversations are deliberately untouched.
Repairing a workspace with no primary mailboxA workspace whose primary mailbox is missing: how the gap shows itself, the two repairs, and why one of them cannot run from a browser request at all.
Catching up after a Gmail history gapWhen Gmail can no longer serve the history a mailbox was reading from: what a gap is, what Connect re-fetches instead, and why order and duplicates are handled first.
Advancing an IMAP cursor safelyThe rule that decides when an IMAP read position may move: what must be recorded first, what refusal holds it, and how advancing early loses mail for good.
Ingesting a burst of mail, end to endHundreds of messages arriving at once: how they are taken in, the order they are processed, what the allowance holds back, and why no wave of replies follows.
Creating a conversation thread, end to endFrom one arriving message to a conversation with a person and a company attached: what is matched, what is created, and what is decided once and kept.
Assigning priority to a thread, end to endHow a conversation gets its priority, what happens when a person overrides it, and why that correction changes what Connect works on rather than how a list is sorted.
Regenerating a draft, end to endAsking Connect to write a reply again: what is thrown away, what survives untouched, what the second attempt is given that the first was not, and when to stop.
Sending with provider evidence, end to endEvery state a message passes through between the decision to send and the provider's acknowledgement, including the third state that is neither sent nor failed.
What Connect changes in your Gmail after a replyThe step that reaches back into Gmail after a reply: what it writes, why it runs last, why its failure is allowed to pass, and which state flows which way.
Applying a suppression, end to endWhat happens when an address or a person is suppressed: where the entry is recorded, which gate reads it, what refuses afterwards, and who is allowed to clear it.
Handling a spam complaint, end to endA spam complaint from the moment it arrives: how the recipient is identified, what is suppressed, and what it should change about the way a workspace sends.
Handling a bounce, end to endA bounced message from the notification to the record: how permanent and temporary failures are told apart, what changes on the address, and what is never retried.
Capturing evidence for a prospect, end to endHow one fact about a business travels from a public source to a stored piece of evidence to the claim it supports — and what stops it on the way.
Qualifying a prospect, end to endHow evidence gathered about an organisation becomes a score, how the score becomes a decision, and what happens when a person disagrees with it.
Finding a contact address, end to endHow Connect finds an address to write to, what it records about where the address came from, and why it will not construct one from a naming pattern.
Keeping a good prospect you cannot emailAn organisation fits your criteria and publishes no address. What stays on the record, what Connect proposes instead, and the four ways it can become reachable later.
Running deep research, end to endWhen a second, deeper research pass is run on one prospect, what decides that it is worth paying for, what it produces, and where the output is attached.
The readiness check before outreachEvery gate an outreach message passes before it leaves, in the order they are evaluated, and what a refusal at each one looks like from the screen.
Classifying a prospect's reply, end to endWhat Connect does with an answer to cold outreach: the classes it sorts replies into, what each one stops or starts, and which ones a person must confirm.
Deciding whether two records are one personFrom the signals that suggest two records are one person to the human decision and the merge itself, with what survives on both sides.
Moving a relationship through its lifecycleEvery lifecycle stage change: what triggers one, how the requested word is normalised, what the move records, and the things it deliberately leaves alone.
Assembling a Customer 360, end to endEvery store a Customer 360 reads to build one person's whole history, and why the cost of assembling it is counted in database statements.
Building the timeline, end to endHow a person's timeline is put together from the records that own each event, why it is ordered by when things happened, and what it leaves out on purpose.
A commercial decision reaching a personWhat happens when a customer asks a price, a warranty or a deadline that Knowledge does not support: the refusal, the escalation, the human decision and the reply.
Handling a demo request, end to endFrom a customer asking to see the product to a dated commitment somebody will actually keep: the record, the confirmation, the reminder and the outcome.
Handing a won deal to onboardingWhat happens when an opportunity is won: which records carry over untouched, what is newly created, and the two mistakes that split a customer in half.
Configuring a channel, end to endThe shape every channel setup shares in Connect — identity, credentials, routing, rules, verification — and the specific places email, WhatsApp, phone and SMS differ.
Verifying a channel actually worksThe one test that proves each channel is really working, what each test does not prove, and why a saved setting and a green screen are not evidence.
Continuing on a different channelContinuing a conversation on a different channel: what history carries over, what has to be re-established, and the identity check that decides both.
A channel provider going downWhat happens when a channel's provider stops answering: how the failure is detected, what stops attempting, what carries on regardless, and how recovery works.
A do-not-contact reaching every channelOne do-not-contact directive that reaches email, WhatsApp, SMS, phone and prospect outreach: where it is stored, why it holds, and what the audit trail shows.
Checking the Assistant's screen contextThe Assistant is told which screen and record you are on. That claim is checked against the database before it is trusted, and dropped when it does not hold.
Executing one Assistant tool call, end to endOne Assistant tool call from argument to audit entry: what validates the arguments, which service does the work, the gates it passes, and what is recorded.
Writing a memory, end to endHow something worth remembering becomes a stored memory: the trigger, the tier it lands on, what the row carries, and the first reply that changes because of it.
Superseding a memory, end to endReplacing something Connect believes without losing the record of what it used to believe: the new version, the kept history, and how each option reads later.
Ingesting a Knowledge source, end to endWhat happens between adding a document and an answer being grounded in it: reading the file, refusing dangerous ones, extraction, and when it becomes usable.
Retrieving Knowledge for one replyHow much of your Knowledge actually reaches one answer: how the question is formed, what the budget allows, how material is chosen, and how to see the choice.
Producing a new version of a fileChanging a file produces a new version rather than overwriting one: what each version carries, how it links back to a record, and what the chain proves later.
Editing a record in the grid, end to endOne cell, changed: what the grid sends, which service decides, what comes back into the row, and the audit entry that survives the browser tab.
Metering usage, end to endHow Connect counts what a workspace uses: which dimensions exist, when each is reserved or merely tracked, and what the daily ledger is actually for.
Enforcing an allowance, end to endThe moment a daily allowance runs out: how the approach is checked, what the refusal says, what is held rather than lost, and how the work resumes.
The AI budget guard, end to endThe AI budget guard on the voice path: when it is asked, what it refuses, what a caller hears instead of silence, and how a call gets through again.
A provider quota breaker opening and closingWhat a provider breaker does when a model account starts refusing: which work is skipped, which is still attempted anyway, and how the breaker closes.
Verifying a customer payment, end to endHow a customer payment is verified and a plan activated: deterministic evidence, a fail-closed match, and why this flow sits outside every workspace.
Creating a customer workspace, end to endFrom a first Google sign-in to a workspace that can actually receive mail: what is created, what is not, and the three things still missing afterwards.
Removing a workspace, end to endWhat removing a workspace actually does: how access ends, which records stay outside it by design, and which parts of it can never be undone.
An AI client calling a Connect MCP toolHow an AI client discovers a Connect workspace tool, authenticates with an integration key, and has the call scoped, gated and recorded like any other action.
An AI client searching the public documentationThe unauthenticated MCP path: which documentation tools any AI client may call without a key, what they return, and the limits that make them safe to publish.
An agent discovering ConnectHow another agent finds Connect: fetching the Agent Card from its well-known URL, reading the published skills, and sending a message to one of them.
A developer calling the public APIA developer calling Connect over HTTP: how a key is issued and scoped, what one request looks like, how errors are shaped, and what a rate limit means.
Delivering an outbound webhookThe outbound webhook interface Connect publishes: the signed envelope, at-least-once delivery, the retry and pause rules — and why nothing is being delivered yet.
Publishing a documentation changeHow a documentation change reaches the public site: one source, the gate, generated HTML and Markdown, the manifests, the sitemaps, and IndexNow last of all.
Verifying published documentationEvery check run before and after a documentation change ships: the gate, the link graph, structured data, the built tree, and the fetch-as-a-crawler probe.
A search crawler fetching a pageWhat a search crawler receives from this site, what it does not, how policy differs for search, user fetches and training, and how a bot proves who it claims to be.
An AI search engine citing a pageThe chain from crawl to citation to referral: what has to be true at each step, which steps can actually be measured from this side, and which cannot.
Submitting changed URLs to IndexNowSubmitting changed URLs to IndexNow: how the changed set is derived, the three rules the tool enforces, the response codes, and why submission runs last.
First response to a new contactHow Connect decides whether to answer a new contact immediately, draft and wait, or refuse — and what the person on the other end experiences while that is decided.
Handling a request Connect cannot fulfilWhat happens when somebody asks for something Connect must not answer: how it is recognised, how it is refused, who it reaches, and what the customer is told.
Escalating a complaint, end to endHow a complaint is recognised on any channel, who it reaches, what Connect commits to on the business's behalf, and what it deliberately refuses to promise.
Communicating during an interruptionWhat Connect says to customers during an interruption, what it keeps internal, who is told first, and why a cause and a restoration time are held back.
Answering a customer's data requestWhat Connect can produce when somebody asks for their data: which records, in what format, from where — and the limits, including what sits outside a workspace by design.
Proving a change did not break anythingProving a change did not break anything: the verification ladder, which rung proves what, and the two audiences every screen change has to be checked as.
Reviewing calls as a routineA weekly pass over the call record: which fields to read first, what each pattern points at, and which findings a setting can fix rather than the model deciding.
Reviewing mailbox health as a routineA routine check of every mailbox: why connected is not health, the states worth watching, the pattern that hides a mailbox entirely, and the action for each.
Changing what the agent is toldChanging the words Connect is given: the six layers a prompt lives in, what extra characters cost on a live call, how to measure it and how to undo it.
Changing the model, end to endMoving Connect to a different model: what to check first, what changes on the wire during the switch, and which numbers prove afterwards that it was worth doing.
Changing a provider, end to endSwapping the carrier, the mail provider or the messaging provider underneath Connect: which layer changes, what has to be re-proved, and what may never be assumed.
Handling more volume, end to endWhat binds first when volume rises — worker capacity, plan allowance, model quota, query cost — and the order in which to change them without guessing.
Reviewing an incident, end to endAfter something goes wrong: which records to open and in what order, the questions that decide whether it is fixed, and what belongs in the write-up.

Troubleshooting#

PageWhat it covers
No voice worker is availableCalls are refused or reach nothing because no voice worker has checked in: what the caller meets, why a screen once said ready anyway, and the two ways it clears.
The call connected and nobody spokeThe call connected and nothing was said: the greeting failure that used to read as caller abandonment, how it is recorded now, and what to check.
The carrier callback was refusedThe carrier's callback was refused before the call was answered: what a refusal before pickup looks like on both logs, and the workspace-scope trap that causes most of them.
The call never rangAn outbound call recorded as never reached: how it differs from nobody answering, which of the dial, the dispatch or the worker failed, and what to do about each.
The voice model refused the sessionThe voice model would not start or dropped the session: the three close codes in plain language, the settings that cause each, and the retry and fallback.
Every line is busyCalls are refused because every voice worker is over its load threshold: what the caller meets, how capacity is actually computed, and what to change.
A caller reached the closed-line messageA caller heard the closed-line message instead of the voice: why that is the line working, what the message says and does not say, and how to change it.
The call ended earlyThe call ended before the conversation did: how to tell a product ceiling, a session limit, a silence watcher and a carrier hang-up apart from each other.
The voice answered in the wrong languageThe voice answered in a language the caller did not use: which language a call opens in, what counts as evidence for a switch, and the transcript that looks wrong and is not.
The voice talked over the callerThe voice kept talking over the caller, or stopped when nobody interrupted: the interruption thresholds, false-interruption resume, and why the host path leaves it off.
The greeting took seconds to arriveWhy a caller hears a pause before the first sentence: a cold worker process, a refused warm-up, or greeting wording that no longer matches the cache.
The call promised a call-back that never happenedA caller was promised a call-back and no follow-up exists: the time-mismatch refusal, the unbooked-promise finding, and where the evidence is.
The same call-back was booked twiceTwo follow-ups for one promise: how a repeated commitment, a second call or a split person record each produce a double booking, and how to clear one.
A call cost more than expectedWhy a voice minute costs more than a text minute: audio token rates, context re-billed every turn, restarts, swept calls and calls that report no tokens.
Nobody can reach the numberNobody can reach your business number: the checklist in order — claim, trunk, routing, worker, hours, switch — and what each failure leaves on the record.
The mailbox disconnectedA mailbox has stopped authenticating: the causes in order of likelihood, what is still safe while it is down, and the path back to working.
Reconnect requiredWhy a stored grant stops working, what running the consent again restores, and the four things it deliberately does not put right.
Mail is in the provider but not in ConnectA message is visible at Gmail or on the mail server and absent from Conversations. Four checks, in the order that finds the cause fastest.
The reply would not sendA reply was refused by the provider or never left: how to read the category of failure, which ones are worth retrying, and what to do about each.
The send result is uncertainA reply whose outcome the provider never confirmed: what that state means, why nothing is re-sent on a guess, and the evidence that settles it.
The draft is still waitingA written reply that has not gone out: the four holds that cause it, the screen that reveals each one, and what the customer is experiencing meanwhile.
The recipient is suppressedConnect refused to write to an address: how to find out why, who is allowed to clear the entry, and the one kind nobody should clear casually.
The same conversation appears twiceOne conversation showing as two: why mail threading splits, what Connect can and cannot merge, and how the person's timeline restores the whole story.
Images in an email do not loadPictures in a message are missing or broken: what the image proxy does, why it exists, and which of the five causes you can actually do something about.
The email renders badlyA message that renders as plain, broken or oddly laid out: what the sanitiser takes out, why it is aggressive, and how to see the original safely.
The reply went from the wrong addressWhy a reply left from a mailbox you did not expect: how the sending address is chosen, why a thread keeps it, and what to do about a message already gone.
Gmail was not updatedThe reply went out but Gmail still shows the thread unread and unlabelled: what write-back is, why its failure never blocks a send, and how to retry it.
Discovery returned nothingDiscovery finished and the list is empty or nearly so. The four causes in order of likelihood, how to tell them apart, and what to change for each.
A good prospect has no addressA qualified prospect with no contact address. Why nothing was invented to fill the gap, what the record is still worth, and the next actions that do work.
Outreach was blockedA message to a prospect was refused or held. Which gate did it, where the reason is written, and which refusals a person is allowed to lift.
Connect refused to prospect an existing customerA candidate was recognised as somebody the workspace already deals with. What the match was made on, and how to correct it when the match is wrong.
The prospecting allowance is spentProspecting has stopped because a limit was reached. Which of the two allowances it was, what carries on regardless, and what is waiting rather than lost.
Two people were treated as oneA reply that mixes up two contacts: how an over-broad identity or a bad merge causes it, and how to separate the consequences afterwards.
Something is missing from the timelineFour kinds of event never appear on a customer timeline by design, and one kind of absence is a real gap. How to tell them apart.
An obvious duplicate was not suggestedWhy two records that look identical to you share nothing a detector can match on, and how to merge them yourself without losing either side.
A person is not attached to their companyThe company link is a decision somebody makes, not something inferred from an address. Where it comes from, and how to set it in each place.
Connect would not give a priceConnect would not give a price, an SLA or a warranty term. Why the refusal is correct, what evidence changes it, and how to answer the customer today.
The deal would not move stageA deal will not move to the stage you picked. The rules that block a move, how to satisfy each one, and the stage change people confuse it with.
A deal is not on the boardA deal you expected is not on the board. Four causes checked in order: the filter, the stage, who owns the record, and which workspace you are in.
A follow-up did not go outA follow-up came due and nothing went out. The six gates in the order they are checked, and how to tell from the row which one stopped yours.
The follow-up went out at the wrong timeA follow-up reached someone at an hour nobody intended. What the due time actually promises, and the four delays that move a send later.
The same person is being chased repeatedlyOne person is being chased again and again. Where the extra commitments come from, why duplicate protection missed them, and how to stop them.
No case was openedA customer raised a problem and no case exists. Why opening one is an action rather than an inference, and what to do when it should have happened.
A website enquiry is not in my workspaceAn enquiry from the JBRH site is not in your workspace, and it never will be. What you are actually seeing, where the record is, and what it protects.
WhatsApp messages are not arrivingNo WhatsApp conversations are appearing in Connect: the causes in order of likelihood, what Connect did and did not complete, and how to prove which half is broken.
The WhatsApp reply would not sendA WhatsApp reply was written and did not go: telling the 24-hour window from a consent block, a spent allowance, an unapproved template and the hourly cap.
The WhatsApp message attached to the wrong personA WhatsApp conversation is attached to the wrong contact: why matching works from the number alone, what the wrong join affects, and the two different repairs.
SMS will not sendA text message will not go out. The provider check comes first, then DLT, then suppression — with what Connect completed and what it never started.
The same SMS was answered twiceOne text message produced two answers, two follow-ups or two cases. What the deduplication key covers, what defeats it, and how to clean up without losing a promise.
The Assistant is not on screenThe Assistant launcher or panel is not where it should be: the two layout causes, the one session cause, and how to tell them apart in under a minute.
The Assistant refused to do itThe Assistant declined to do something you asked: the four kinds of refusal — authority, autonomy, evidence and plan — and which of them a person can lift.
The Assistant answered about the wrong recordAn answer about a record you were not asking about: how screen context is claimed and checked, what a pinned record overrides, and how to reset both.
The Assistant stopped respondingThe Assistant stops mid-answer or never starts: separating a dropped stream from a provider limit from a spent AI budget, and what each one needs.
Connect ignored what I told itA reply that ignores something you wrote down: the four causes in order of likelihood, what to check for each, and what the reply did and did not do meanwhile.
Connect remembers something wrongConnect keeps repeating something about your business that is not true: how to find where it is stored, correct it at the right tier, and confirm the fix.
An older fact stopped being usedSomething Connect used to mention has quietly stopped appearing: the per-channel character budgets, the fixed group order, and what falls off the end first.
Connect said it does not knowA thread waiting because approved Knowledge held no confident answer: the six causes in order of likelihood, and the three things that change it.
A Knowledge source failed to processA Knowledge source that ended in error or never went active: the format, size, content and service causes, with the repair for each.
An answer quoted the wrong thingA reply cited something out of date, contradictory or beside the point. The causes in order of likelihood, what Connect finished, and what it never attempted.
Connect is preparing work but sending nothingConnect is clearly working — drafts appear, calls are planned — and nothing leaves. The four causes in the order they actually apply, and how to tell them apart.
The approval is not in the queueYou are waiting for something to approve and the queue does not have it. The two states that look exactly like absence, and the four other reasons.
Connect did something without askingSomething went out with no approval. How to read the decision log entry that explains it, and why the scope in force is usually wider than the one you set.
Needs You is empty and something is wrongAn empty queue is not a clean bill of health. What Needs You raises, what it deliberately leaves to other screens, and where to look when it is quiet.
The file was refusedA file would not attach: the format list, the content check that ignores the extension, and the two safety refusals that happen before anything is parsed.
The PDF has no readable textA PDF with no text layer still gets read, as an image, by the model. What that changes about the answer, and when to go back for a better source.
The grid would not save an editA cell reverted instead of saving: the service that owns the record declined the change. The six reasons it declines, and how to find which one applied.
Some imported rows are missingFewer records arrived than the file had rows. The three causes that account for nearly all of it, and the report that names each one by row.
A CSV export looks escapedAn exported CSV shows odd leading characters on some cells. That is formula neutralisation working, why it is not optional, and how to read the file safely.
You cannot sign inThree different failures wear the same face at the sign-in screen: consent, the address you used, and membership. How to tell them apart in order.
You are in the wrong workspaceWhy you are looking at another business's screens, how a workspace is actually chosen, and the one version of this that is worth reporting.
You were signed outA session expires on a clock rather than on idleness, and it does it without warning. What that looks like on an open screen, and what your last action did.
The allowance is spentA daily counter is spent. What keeps running, what is held rather than dropped, and the four things a person can genuinely do about it today.
The plan has lapsedFour different things stop a workspace and all of them look the same from a screen. How to tell a lapse from the other three in about a minute.
A screen returned 403A screen refuses with 403 for one audience and works for the other: which of the two boundaries refused, how to tell, and what to report.
Data that should be here is notA record you expect is not in a list: the three different silences behind that, how to tell them apart, and the one that is a defect rather than a boundary.
An inbound webhook was rejectedA provider reports failed deliveries and nothing arrives in Connect: the four causes of a refused callback, in the order they are worth checking.
Connect appears to be doing nothingConnect looks idle: no replies, no calls, no activity. The seven reasons, ordered by how often each one turns out to be the answer.
The same message went out twiceTwo copies of one message, or one call placed twice: how retries are made safe, the two causes that produce a genuine duplicate, and what to do next.
A message went to the wrong personA reply or a call reached the wrong person: how identity resolution and thread stickiness decide a recipient, and how to correct the record afterwards.
An integration disconnectedA connected provider has stopped working. The shape every disconnection shares, what each provider does differently, and why reconnection happens at the provider.
A provider is downA provider Connect depends on is failing. What is handled automatically, what simply waits, and the few things a person should and should not do meanwhile.
The AI provider refusedThe AI provider refused. Quota, a rejected key, the spend ceiling and a bad model choice produce one symptom — here is how to tell which of the four it was.
The AI budget is spentThe AI spend ceiling has been reached. What stops immediately, what carries on untouched, and the sentence a caller hears instead of a conversation.
A screen is slow to loadA screen that takes seconds to appear: what it is actually fetching, the two query patterns that make screens slow, and how to tell which one you have.
A screen is empty and should not beA list showing nothing when it should show rows: the four causes — a filter, a workspace stamp, a permission, or genuine emptiness — and how to tell them apart.
The screen shows old dataThe screen shows something you know has changed: the five reasons old data appears, including a tab that never noticed a release and a record still being written.
The layout is wrong on a phoneOverlapping or unreachable controls on a phone: where the layout comes from, the breakpoint that matters, and the four details that make a report reproducible.
Keyboard navigation gets stuckTab stops working or focus vanishes: how to tell a real focus trap from focus you cannot see, the reliable way out, and what a useful report contains.
Search returns nothingSearch returns nothing for something you know exists: which fields are actually matched, how wildcard characters behave, and why results are a page rather than a set.
An export is missing rowsA download that is shorter than the screen suggested: what an export actually follows, why the visible rows are not the set, and the cells that change on the way out.
There is no audit entry for somethingNo audit entry for something that clearly happened: which of Connect's three self-records holds it, what the audit trail deliberately excludes, and what an absence proves.
A time is shown in the wrong zoneA clock reading that looks an hour or half a day out: which zone each surface uses, why a promised call-back follows the line rather than the caller, and what to check.
A duplicate record was createdTwo records for one person or company: the three ways a second one is created, what merging does to history, and what to check before you merge.
You do not have permissionThree unrelated things produce 'you do not have permission': your audience, your workspace and your role. Each looks different once you know what to look at.
Something will not deleteSomething refuses to be removed: what Connect protects and why, which removals are marks rather than erasures, and what to do instead of deleting.
The call sounded badWhen a call sounded bad: separating band-limited telephone audio from network trouble, turn-taking faults and delivery, and what Connect can actually measure.
The reply lost its formattingA message that looks plainer than it should: what the reading sanitiser removes, what the composer never adds, and how to tell lost styling from lost content.
The memory viewer shows nothingYou opened the memory viewer expecting to see what Connect knows and found nothing. Which tier you are actually looking at, and when empty is the true answer.
An MCP client cannot connectAn MCP client that will not talk to Connect: the four refusals it can meet — transport, origin, protocol version and authentication — and the one-line test for each.

Email#

PageWhat it covers
MailboxesWhat one mailbox row owns, how several run at once in a workspace, what changes when you add another, and the defect that made a connected mailbox invisible.
Mailbox rolesWhy a mailbox carries a role, what the role changes about which address a reply leaves from and how it is written, and how to choose one deliberately.
The primary mailboxWhat falls back to a workspace's default sending mailbox, how that default is expressed and changed, and what to do when a workspace appears to have none.
Connecting GmailConnecting a Google mailbox: the consent path, why signing in and connecting a mailbox are different acts, and what the mailbox row holds afterwards.
Gmail OAuth scopes and why each is asked forThe permissions a Google mailbox connection asks for, the capability behind each one, and precisely what stops working when one is withheld or withdrawn.
Connecting an IMAP and SMTP serverConnecting a mailbox on your own mail server: the two halves of the connection, what a saved connection proves, and the ladder of checks that proves the rest.
Connecting a Microsoft mailboxConnecting a Microsoft mailbox over Graph: what the adapter covers, the two places it differs from Gmail, and the much larger part that is identical.
Mailbox signaturesWhere a signature is stored, which messages it is applied to, how it interacts with a reply you have edited, and what this documentation can and cannot say about footers.
Autonomy on one mailboxGiving one address its own rule about what Connect may do: how the endpoint scope resolves against the channel and the workspace, and when it is the right tool.
Mailbox healthWhy a mailbox that authenticates can still be failing, what the health verdicts on the row are derived from, and which action each situation actually calls for.
A quiet mailboxA mailbox that authenticates and returns nothing: what the state means, the four ordinary reasons for it, and why it is reported as a signal rather than an error.
Disconnecting a mailboxRemoving a mailbox from a workspace: exactly what stops, exactly what is kept, what happens to work in flight, and the safer order to do it in.
Syncing an inboxHow a mailbox is read: what the first pass does that no later pass repeats, what each pass fetches, and what bounds a single pass rather than letting it run away.
Gmail history syncHow a Gmail mailbox resumes by history ID instead of re-reading, what a gap in that history means, and what has to happen when the provider can no longer answer.
IMAP UID and cursor lifecycleThe UID cursor on an IMAP mailbox: what it records, the only outcome that advances it, and the two server-side events that can invalidate it entirely.
Large batches and burstsWhat happens when hundreds of messages arrive at once: the two different orderings involved, why screen cost stays flat, and what a burst can genuinely distort.
From a provider message to a canonical oneThe journey from a provider's own message record to the canonical thread, message and contact the engine reads — and why the engine is not allowed near the provider table.
Conversation threadsHow a canonical thread is formed, which signals attach a message to one, what a person's own marks on a thread control, and the ordinary ways a thread breaks.
Resolving a sender to a personHow an email address becomes an identity, an identity a person and a person part of a company — and what happens the first time a stranger writes to you.
Rendering HTML email safelyHow Connect renders an HTML message: what the sanitiser removes, why remote images never load from the sender, and what you read instead.
Remote images in emailWhy an image in a received message loads through Connect's proxy instead of your browser, and what that changes for the sender and for you.
Email attachmentsWhat Connect records about a document attached to an email, what it deliberately does not keep, and what a reply looks like when the enclosure was the message.
Triage and priorityHow a thread gets a priority, why threads.priority changes what the engine does next, and which triage marks belong to you alone.
Blocking a senderBlocking a sender writes a memory row tagged block:email, not a column — which is why it holds across channels and across future conversations.
Giving guidance on a threadThe one-line direction you give on a thread: where it is stored, how far it reaches, and when it should be a standing instruction instead.
How a reply is draftedWhat goes into a reply before a word of it is written: the thread, grounded knowledge, memory at four tiers, the rules — and the answers Connect declines to give.
Held draftsWhat happens to a reply Connect has written but is not allowed to send yet: where it waits, what the recipient sees, and how it is released.
Editing a draft before it goesChanging a reply before it goes out: which fields are editable, why the sending mailbox is not, and what your edit does to the record.
Approving and rejecting a draftThe two decisions on a waiting reply, what each one records, why a rejection is not a lesson, and who is accountable afterwards.
Regenerating a draftWhen writing a reply again is the right move rather than editing it, what a fresh pass picks up, and what regenerating costs you.
Sending emailThe path an outbound message takes through Connect's single send boundary, the checks along it, and the narrow meaning the word sent may carry.
Proof that a message was sentWhy Connect will not call a message sent without the provider's own acknowledgement, what the third state means, and how a message in doubt is resolved.
A send that failedA message that did not go: the failure classes, which ones are worth another attempt, what Connect completed anyway, and where the failure appears.
Writing back to GmailAfter Connect answers a Gmail thread it labels it and marks it read in the customer's own mailbox — and a failure to do so never blocks the reply.
The daily email allowanceWhat the daily email allowance counts, what happens when it is spent, and why the read cursor deliberately stays where it is on a refusal.
Following up by emailCreating a dated commitment to write again, what is drafted when it falls due, and the reference rule that stops the same follow-up existing twice.
Outreach email versus a customer replyOutreach and a reply to a customer are two paths with different gates. What each must pass, why they are never merged, and what that costs in volume.
UnsubscribeHow Connect honours an unsubscribe: the request is acted on rather than answered, a do-not-contact entry is written, and every send path checks it.
Spam complaintsWhat a spam complaint changes in Connect: escalation instead of a reply, a suppressed address at the provider, and a reputation state that can stop outreach.
BouncesWhat Connect does when a message comes back undelivered: permanent against temporary failure, which one takes an address out of use, and how a person clears it.
The suppression listThe one list checked before any outreach: what puts an address on it, what it blocks, who may take an entry off, and how it differs from blocking a person.
Do not contactThe strongest entry in Connect's compliance record: what a do-not-contact instruction stops, how it is set, and why the Connect Assistant cannot lift one.
DeliverabilityWhat Connect controls about whether mail arrives, what belongs to your own sending domain and its history, and the order worth fixing things in.
Email for the Owner and for a customerEmail runs on one implementation behind two doors. What the plan changes for a customer, what is identical, and where the asymmetry has actually gone wrong before.

Prospects#

PageWhat it covers
Describing who you want to reachWhat a discovery brief holds, which parts become hard filters and which only steer research, and how to write one that returns real work.
Location and scopeHow a place in a discovery search is interpreted, what widening it actually costs, and why a tighter area usually returns more usable prospects.
Discovery running in the backgroundDiscovery that runs on a schedule rather than on a button: what it does between visits, what it consumes, and how you see progress.
Collecting candidatesThe stage between a search and a researched prospect: where a candidate comes from, what is stored about it, and what is deliberately left undecided.
Researching a candidateWhat Connect reads about a candidate, what it extracts, and why text fetched from a stranger's website is treated as data rather than instruction.
Evidence on a prospectWhy every claim on a prospect carries the source it came from, what qualifies as backing, and what happens to a statement that has none.
Qualifying a prospectHow researched claims become a fit judgement and a score, what the score is allowed to decide on its own, and how a person overrides it.
Why this prospectThe sentence explaining why an organisation is on your list: what it may cite, what it is forbidden to say, and how to fix one that reads wrong.
ContactabilityThe gap between a business you can research and one you can write to, why the two counts differ, and what to do with the difference.
Connect does not guess email addressesConnect never constructs a prospect's email contact from a name and a domain. What that rule costs, what it buys, and what happens to a prospect without one.
Evidence for a contact addressHow a prospect's address earns its place: where it was found, how that origin is stored, and what makes one address usable and another not.
Finding the right personHow a role at a prospect is inferred from public material, why it is recorded as an inference, and what that means for who a first message names.
Deep research on a prospectThe second, deeper pass over a prospect: what it adds, what it consumes, and the rule that decides which candidates are worth it.
The angle for first contactThe opening line of a first message: how it is grounded in sourced claims, what it is refused permission to say, and what makes one read as automated.
Sender readinessThe checks that stand between a written first message and a send: which mailbox, whether it is healthy, what allowance is left, and which signature applies.
The compliance check before outreachDo-not-contact, suppression, unsubscribe, complaints and prior contact, all checked in one place before any outreach leaves a workspace.
First outreachThe first message to a prospect: what goes out, what is held and why, and what is written to the record in both cases.
A prospect repliesWhat happens when a prospect answers: how the reply is classified, what it changes about the record, and which answers end the cold path immediately.
Stopping a cold sequenceEvery event that ends a cold outreach sequence, why each takes effect at once rather than at the next scheduled step, and how to confirm one stopped.
From prospect to opportunityWhen a researched prospect becomes a deal on the pipeline: what is created, what is linked rather than copied, and what deliberately stays behind.
Uploading your own listBringing a list you already own into Connect: the file, what is checked on every row, what happens to a row that fails, and what is never added.
The prospect recordEvery part of a prospect record, which parts a person supplied, which came from research with a source attached, and which are recalculated.
Keeping prospect research freshProspect research ages at different speeds. What is re-checked, what is left alone, and the control that stops re-research becoming a standing bill.
Resolving a prospect to an existing relationshipThe check that recognises a discovered organisation as somebody you already deal with, what it matches on, and what happens when it fires.
The numbers above the listWhat each headline number above the prospect list counts, and the paging defect that once made every one of them stop at five hundred.
What prospecting costsWhere prospecting spends money, how the cost router decides a deeper pass is worth running, and which screen shows what a run consumed.
Prospecting for the Owner and for a customerProspecting is one implementation serving two audiences. What is identical, what the plan bounds, and why a tenant sometimes sees a 403 instead.

Relationships#

PageWhat it covers
PeopleThe person record: what you type, what Connect derives, what attaches from other services, and why blocking somebody is not a field on it.
CompaniesThe company record, how several people attach to one organisation, what belongs to the company rather than to a human, and when not to create one.
IdentitiesOne address on one channel is its own row: how identities attach to a person, how they are keyed, and what happens when one is attached to the wrong human.
One person across phone, email and WhatsAppHow the same human is recognised when they arrive on a second channel, what counts as evidence, and why a likeness is a proposal rather than a match.
Customer 360One person's whole history in a single view: what is assembled into it, which service each part comes from, and what it deliberately leaves out.
The customer timelineWhat appears on a person's timeline, where each entry comes from, the ordering rule, and the query cost that once made this screen expensive.
Duplicate detectionHow two records come to describe one human, what a duplicate proposal is and is not, and why nothing is ever joined without a person saying so.
Merging two recordsMerging two records is a human decision: who makes it, what happens at the moment it runs, what changes for every channel, and what cannot be undone.
What a merge preservesThe itemised guarantee: identities, stages, follow-ups, deals, demos, cases and onboarding all survive a merge, and what happens when both sides hold one.
Lifecycle stagesThe six stages a relationship moves through, what may move it, why becoming a client needs a person, and where the history of every move is kept.
Normalising a stageWhy one column holds three vocabularies, how an unfamiliar stage word is read, and the message that went unanswered when a lookup raised instead.
The relationship summaryThe written relationship summary: what it is assembled from, why it is not a stored document, and the name guard that rewrites it on the way out.
The contact briefThe short block about a person that a channel is given before it answers: what is in it, the character budgets, and why every line has to earn its place.
What Connect remembers about a personThe contact tier of memory: what Connect knows about one human, how a fact gets there, how it is read into an answer, and how anyone removes it.
Finding a person or companyFinding a person or company: what is matched, why counting and paging happen in SQL, and how a per cent sign typed in the box is treated as a character.
Relationships for the Owner and for a customerThe Owner calls them relationships and a customer calls them people: the same records, the same code, and the rewrite that makes one path serve both.

Sales#

PageWhat it covers
Opportunities: the deal recordWhat an opportunity holds — value in minor units, stage, the people it belongs to, the review flag — and what each field is actually used for.
The pipeline boardWhat the board shows, what dragging a card actually calls, and why a total on a board must be counted in the database rather than in the page.
Stage rules and refusalsWhy a deal will not move: the four shapes a stage restriction takes, what a refusal tells you, and why declining is a correct answer.
The next best action on a dealHow Connect picks the next thing to do on a deal, the records that evidence it, and what to change when the suggestion is wrong.
Price, SLA and warranty: what Connect may sayConnect does not invent commercial terms. What counts as grounded, what is refused and escalated instead, and how a breach is caught on a live call.
Escalating a commercial decisionWhat a refused commercial question looks like in Needs You, what the person deciding actually sees, and what happens to the customer afterwards.
Quotes and sales documentsA quote in Connect is a file, not a special object: what can be assembled, which terms it may contain, and where its versions and provenance live.
How a deal connects to people and companiesThe links between an opportunity, its person and its organisation — what each one is for, and exactly what a merge does to them.
Follow-ups on a dealWhat raises a chase on an opportunity, how the channel is chosen, and the duplicate rule that stops one customer being pursued twice for the same thing.
Closing a deal: won and lostWhat each closing outcome records, what it starts or stops downstream, and what to do with the commitments the deal made before it closed.
Sales for the Owner and for a customerThe pipeline is one implementation serving both audiences. What a plan bounds, and why two commercial screens are correctly operator-only.

Follow-ups#

PageWhat it covers
Creating a follow-upThe three routes to a follow-up — by hand, from a conversation, from a call — and what each one records about the promise behind it.
The reason on a follow-upEvery follow-up carries a reason. What a usable one contains, the four that are not reasons at all, and who ends up reading it.
Due dates and timesHow a spoken or written promise becomes a due timestamp: the phrases that parse, the timezone it lands in, and the fallback when nothing usable was said.
Choosing the channelWhich of the six channels a commitment lands on, how a call decides it, when to use any, and the one channel that nothing ever sends.
Follow-ups for a person to doThe task channel is work for a person, and no drain ever sends it. What lands there, where it appears, and why nothing sending it is correct.
Changing a follow-upWhat you can change on an open follow-up, which operation to reach for, and the one thing no operation will do — erase what already happened to the row.
Approval on a follow-upWhen executing a follow-up needs a person's yes, what the approver is shown, and what a rejection does to the commitment underneath.
Executing a follow-upWhat happens when a row comes due: the drain that picks it up, the gates it passes through unchanged, and the three outcomes written back against it.
Completing a follow-upThe two ways a follow-up closes as kept, the third state that looks like completion and is not, and what each one records against the relationship.
Duplicate follow-upsWhat counts as the same commitment: the person and the due time. What the rule catches, what it deliberately does not, and how to work with it.
A follow-up that is too lateA phone follow-up more than twenty-four hours late is closed rather than rung. The cut-off, the reasoning behind it, and what the closed row records.
Overdue follow-upsWhere a follow-up past its time shows up, how it is ranked against everything else a person owes, and the four things that clear it.
Follow-ups for the Owner and for a customerOne queue, one drain, two doors: what is identical for the Owner and a customer workspace, what differs, and the enquiry queue that belongs to neither.

Support#

PageWhat it covers
Support casesWhat a support case is in Connect, what opens one, the three verbs it moves through, and how it stays attached to the person it belongs to.
What a case carriesThe history an open case is answered from: what is assembled, the budget it is assembled to, and the things deliberately left out of it.
Resolving a caseWhat closing a case actually records, what it changes on the relationship, and the four things it deliberately leaves exactly as they were.
Escalating a caseWhat makes a case stop and wait for a person, what the person is actually being asked to decide, and what the customer sees while it waits.
Onboarding a new customerThe onboarding record after a deal is won: what it tracks, what Connect does between the steps, and why the plan is the workspace's rather than a template.
The relationship after the saleWhat carries over when a prospect becomes a client: the record, the memory and the commitments that continue, and the four rules that change.
Website enquiriesEnquiries from the public JBRH website are held outside every workspace, on purpose. What that means, who works them, and why customers cannot see them.

WhatsApp#

PageWhat it covers
Setting up WhatsAppConnecting WhatsApp in a workspace: Official API credentials or Meta's QR-linked coexistence route, the webhook, the autonomy decision, and the test that proves it.
The WhatsApp business identityThe number, the display name and the verification mark a customer sees on a WhatsApp chat: what Meta owns, what the connection mode changes, and what Connect cannot.
Receiving a WhatsApp messageHow a WhatsApp message reaches Connect: Meta's signed webhook call, which workspace it belongs to, every message type it can carry, and the record it becomes.
Recognising who sent a WhatsApp messageHow a WhatsApp number becomes a named Person in your relationships, what happens when the sender is unknown, and how a wrong match is corrected.
Continuing a WhatsApp conversationWhat Connect carries from one WhatsApp message to the next: the thread, the relationship, memory and knowledge — and how a long silence is treated.
Replying on WhatsAppHow a WhatsApp reply is written, what decides whether it is sent or held for approval, and what counts as evidence that it actually went.
Follow-ups on WhatsAppScheduling a WhatsApp follow-up: what can be promised, what Meta's 24-hour window allows, and what happens when the due time arrives and only a template will do.
Opting out of WhatsAppWhat a customer can say to stop WhatsApp messages, how Connect honours it, where the suppression is recorded, and what still reaches them afterwards.
Delivery and read statusDelivery and read receipts on WhatsApp: what Meta reports, what Connect stores, what it refuses to infer, and the billed category that rides along with a status.
What WhatsApp cannot do hereThe honest boundaries of WhatsApp in Connect: two things not proven in production, what Meta decides rather than Connect, and the limits that are Connect's own.
WhatsApp for the Owner and for a customerOne WhatsApp implementation, two audiences: what the Owner and a customer workspace share, what is separate, and why a test on one proves nothing about the other.

SMS#

PageWhat it covers
Receiving SMSHow a text message reaches Connect: the provider webhook, the workspace it resolves to, the record it becomes, and what receiving alone does not give you.
Duplicate SMSWhy the same text message can arrive at Connect more than once, what key stops a second copy becoming a second conversation, and the one case it cannot cover.
Attaching an SMS to a personHow Connect turns the number that sent a text message into a Person, what it does when the number is unknown, and the near-misses that land a message on the wrong record.
STOP and opt-outThe opt-out words Connect honours in a text message, what is written when one arrives, how far the refusal reaches, and how quickly it takes effect.
SMS suppressionHow a suppression entry is created on SMS, what it stops, how it differs from a do-not-contact directive, and who is allowed to clear one.
DLT registration in IndiaWhat DLT registration means for a business sending commercial SMS in India, the three registrations involved, and why it is a process with the operators, not a setting.
Sending SMS: what is available todayThe honest state of outbound SMS: what the provider decides, why the carrier on the live account carries none, and what the Phone screen shows instead of a thread.
SMS for the Owner and for a customerWhether SMS behaves differently on the Owner account and in a customer workspace: the same code path, the same provider limit, and the one real difference.

Assistant#

PageWhat it covers
Opening the AssistantWhere the Connect Assistant lives, how the panel opens over any screen, and what it already knows about your workspace the moment it does.
Assistant tabsEach Assistant tab keeps its own conversation, follow-up chain, record, draft, files and scroll position — and why that separation is the point.
Screen awarenessWhat the Assistant is told about the page you are on, and the database check that runs before any of it is allowed to shape an answer.
Working on one recordPinning a person, company, deal or thread to an Assistant tab: what changes in the answers, what it overrides, and when to unpin.
Asking about selected textHighlighting a passage and asking about it: exactly what leaves the page, what stays behind, and the questions it answers better than any other route.
Conversation historyWhat an Assistant conversation keeps, where it lives, why it is not the same thing as memory, and how to start a genuinely clean thread.
Suggested commandsThe prompts the Assistant offers before you type: what they are drawn from, what they are not, and why clicking one still asks before it acts.
Answers that change nothingMost of what the Assistant does is read and answer. The tools that can only read, how to recognise one at a glance, and why the default matters.
Where an answer came fromHow the Assistant shows what an answer was built from, how to read the folded step detail, and what to do when it cannot name a source.
When the Assistant is not sureWhy an admission beats a plausible guess in a system that acts on its answers, and what the Assistant offers you in place of one.
When the Assistant finds two answersWhat happens when a memory, a knowledge source and a customer's own message do not agree: what is shown, what is never decided silently, and who settles it.
Proposed actionsAnything the Assistant would change arrives first as a card: the action, the reason, the arguments you can edit, and a confirmation that nothing has happened yet.
Running an actionWhat happens the moment you confirm: which service runs, which gates still apply, what the result shows you, and what is written to the decision log.
Undoing an actionSome Assistant actions reverse cleanly, some cannot be reversed at all, and the line between them follows whether the change ever left your workspace.
The Assistant's toolsThe Assistant has 66 tools. What the reading ones reach, what the writing ones change, and the rule that every write calls the service owning the record.
What the Assistant may not doThe Assistant is given deliberately narrower rights than the person using it: no pricing, no clearing a do-not-contact entry, and no way around a workspace's own rules.
Working with files in the AssistantAttaching a document to the Assistant, the formats it reads, what it refuses, and where a document it creates or changes actually goes.
Correcting a fact without leaving the AssistantTurning something you said in conversation into what Connect actually knows: which tier it lands in, how a block is stored, and what forgetting does.
Needs You inside the AssistantThe queue of decisions waiting on a person, worked from inside the Assistant panel: what is shown, what deciding there does, and what it will not let you do.
The live status lineThe single line the Assistant shows while it works: what Understanding means, what the step count counts, and what Stop actually stops.
Rating an answerWhat rating an Assistant answer records, who can read it, and why a correction you want to stick belongs in Memory rather than in a rating.
The Assistant on a phone and on a wide screenThree layouts for one Assistant: full screen on a phone, a sidebar from 600px, a column on a wide screen — and how the on-screen keyboard is handled.

Memory#

PageWhat it covers
The four memory tiersWorkspace, channel, endpoint and contact: what each tier is for, how tiers() resolves them narrowest-first, and why an empty tier is still returned.
Business memoryThe workspace tier: what a business should tell Connect once so it holds everywhere, and the four kinds of line that do not belong there.
Person memoryThe contact tier: what Connect keeps about one human, how it follows them across channels, and the 600-character block that reaches a live call.
Channel and endpoint memoryThe two middle tiers: what Connect should know about a whole channel, and what belongs to one mailbox or one phone number instead.
How a memory is createdThe four ways a memory gets written in Connect — by hand, by the Assistant, at the end of a call, or as a deliberate correction — and what each one records.
Memory from an email or a chatWhy an email or a chat does not silently become memory, what a person or the Assistant may take from one, and how a written instruction inside content is treated.
Memory from a phone callWhat a phone call leaves behind: the end-of-call write, the two filters that stop a thin call producing facts, and the guards that refuse a misheard name.
Seeing what Connect knowsWhere the memory viewer opens from, how it groups what it shows, and the second route through the Data grid when you want to read a whole tier at once.
Editing a memoryChanging a memory that is worded badly or plainly wrong: what an edit touches, what it does not touch, and when superseding is the right move instead.
Superseding a memoryReplacing a memory whose truth has changed while keeping the earlier statement readable, and why that is different from editing it in place.
Forgetting somethingWhat forgetting actually removes in Connect, what deliberately survives it, and the two deletions that have consequences people do not expect.
Block and guidance directivesThe two memories that direct behaviour rather than describe it: a block carried in the tag list, and a standing instruction carried in the text.
Where a memory came fromWhy every memory needs an answer to 'who said so': the four origins, what the record keeps, and how to write a row that explains itself later.
How memory reaches a replyThe door memory goes through on each channel, the character budgets on the voice path, and why instruction size is a latency decision rather than a preference.

Knowledge#

PageWhat it covers
Knowledge sourcesWhat can be added as a Knowledge source, the size ceiling for each kind, the authority and scope it is given, and why one stops answering.
Extracting text from a sourceHow a file becomes text: direct decoding for Markdown and plain text, model reading for PDF, image and video, and the limits on both.
How Knowledge is prepared for retrievalWhat Connect actually builds from a source: heading-aware passages in the same database, no vector store, and an optional embedding column.
Retrieving Knowledge for an answerWhat is fetched for one question: eligibility, the scoring terms in order, the three labelled blocks, and why a live call gets only four entries.
Testing retrievalThe search tool that shows what a question would actually fetch, how to read its score and authority columns, and what it cannot tell you.
The facts editorTyping a short grounded statement directly: the fields, what priority and keywords actually do, and when this beats uploading a document.
Knowledge and Fact are different thingsKnowledge is the body of material a workspace supplies; a Fact is one statement inside it. Blurring the two produces confident, unsupported answers.
When two sources disagreeContradiction detection when a source is added, why a conflicted source stops answering, and why nobody but a person may decide the winner.
Claims Knowledge does not supportWhat happens when an answer would need something Knowledge does not carry: no draft is written, a person is asked, and the miss is recorded.
Who decides what is trueAuthority is set by a person and enforced in code before the model sees anything, which is why no document and no message can promote itself.
Instructions hidden in contentReceived and fetched text is data, never instruction. What is stripped, what is flagged, what stops before any model runs, and what none of it guarantees.
Knowledge for the Owner and for a customerOne Knowledge implementation reached by two routes: what is identical for both audiences, what a plan scopes, and where a customer workspace stops.

Autonomy#

PageWhat it covers
The four autonomy modesOff, draft only, ask before sending and autonomous: what each does to an outbound action, and the difference readers most often miss.
Autonomy scopesContact, endpoint, channel and workspace: the four levels an autonomy rule can be set at, and why the narrowest one always wins.
Setting autonomy per channelEmail, WhatsApp, SMS and voice each carry their own autonomy mode. Why they usually should not match, and the configurations that work.
The gates that always applySuppression, blocks, allowances, evidence and workspace isolation: the refusals that stand even when a channel is set to autonomous.
Asking before placing a callHolding outbound calls for a human yes: what the setting covers, what the approver is shown, and what happens to a call-back that waits too long.
Exceptions to a ruleOverriding a channel rule for one contact or one mailbox: when an exception is the right instrument, and the three tools often confused with it.
Autonomy and spendPermission and capacity are separate controls: how the plan allowance and the workspace budget limit what an autonomous channel actually does.
ApprovalsWaiting For You: how a held action is presented, what a person may change, the two decisions available, and what each one records.
Editing before approvingChanging a prepared reply before releasing it: which parts a person may alter, what the edit records, and when to regenerate instead.
Rejecting an actionSaying no to a held item: what happens to the prepared work, what is written down, and whether Connect tries the same thing again.
Needs YouOne ranked place for everything wanting a person: held decisions, mailboxes needing attention and line health, each clearing as its cause resolves.
How Needs You is orderedWhy the list is not in arrival order: the signals that push an entry up, the ones that pull it down, and how your own triage feeds back into it.
What appears in Needs YouEvery sort of entry the attention list carries, what each one means, and the screen you go to in order to make it go away.
The decision logWhat was decided, by what, under which rule, and what happened — including the refusals, because a refusal is a decision like any other.
How long the record is keptHow long decision records last, what actually limits an investigation, and why no age-based deletion schedule is published for them.
Standing instructionsDurable directions a person gives Connect: where they apply, how to write one that can be acted on, and how they differ from memory and autonomy.
Turning Connect on and offThe runtime switch: what stops when you turn Connect off, what carries on regardless, and the four things it deliberately does not change.
Autonomy for the Owner and for a customerOne implementation serves both audiences: a customer gets the same modes, scopes, queue and log, with the plan bounding volume rather than permission.
Who may change whatWho is allowed to change autonomy, decide a held item and read the record — and the rights the Connect Assistant is never given.

Files and data#

PageWhat it covers
Adding a fileThree ways to add a file — button, drag-and-drop, paste — what happens the instant it lands, and the checks it must pass before anything reads it.
File formats Connect readsEvery file format Connect reads, what is actually extracted from each one, and the limits worth knowing before you rely on an answer drawn from it.
Validating a fileWhat Connect checks about a file before any parser touches it: the type check against the bytes, and the two structural attacks the checks exist to stop.
Parsing a file safelyThree refusals that keep document handling safe: external entity declarations, archives that expand out of proportion, and formulas neutralised on the way out.
Previewing a fileWhat a file preview shows and what it deliberately does not: stored bytes for an image, extracted content for a document, and nothing fetched from the network.
Reading text out of a documentHow words come out of a PDF, a DOCX, a PPTX or a plain file, what reading order means in practice, and what happens when a document has no text layer at all.
Reading tables out of a fileHow XLSX and delimited files are read into rows and columns, what survives the trip, and the four things that are reliably lost on the way.
Understanding an imageHow Connect reads a photo or a screenshot: the image formats it accepts, what the model is actually shown, and the questions a picture cannot answer.
Answering from a fileGrounding an answer in an attachment instead of in a model's memory: how Connect quotes a file, what happens when the file does not say, and what a citation means.
Creating a fileHow Connect produces a file: what it can be built from, which formats it will and will not write, and where the finished document lands.
Changing a fileWhy changing a file in Connect always produces a new version instead of overwriting it, and exactly what the version you started from keeps.
File versionsThe version chain a file keeps in Connect: what one version records, what provenance means here, and how the chain relates to the audit trail.
Linking a file to a recordAttaching a file to a company, a deal, a case or a conversation: what the link changes, what it does not, and where the file actually lives.
The record of a fileThe trail a file leaves in Connect: who added it, who changed it, what was refused, and what was produced from it — and what the trail deliberately does not hold.
The Data gridThe Data screen: an Excel-like grid over thirteen record sheets, what each sheet holds, and why it is a view of Connect rather than a second database.
Columns, order and visibilityArranging a sheet on the Data screen: resizing, reordering, hiding and showing columns, what a hidden column still does, and how to keep an arrangement.
Filtering and searching a sheetNarrowing a sheet on the Data screen: how filters on several columns combine, how search differs from a filter, and why a typed wildcard is just a character.
Sorting, grouping and freezingOrdering rows, gathering them under a shared value and pinning the columns you read against — and what happens when you use all three at once.
Saved viewsWhat a saved view on the Data screen keeps, why it grants nobody any access they did not have, and how to get a sheet back to how it arrived.
Editing in the gridChanging a value in a cell on the Data screen: which fields accept an edit, which service actually performs it, and why some edits are refused.
Bulk selection and actionsSelecting many rows on the Data screen and acting on them at once: how a bulk change is applied row by row, and what a partial result means.
Importing and exportingGetting records into and out of the Data screen: how an import is validated row by row, and why an exported CSV escapes cells that begin with an equals sign.
Duplicates in the gridHow the Data screen surfaces records that look like the same person or company, what merging actually does, and why it is never done automatically.
The grid on a small screenWhat the Data screen becomes on a phone: the controls that survive the loss of width, the ones that are dropped, and why dropping them is the right answer.

Account#

PageWhat it covers
Signing in with GoogleGoogle is the only way into Connect. What the sign-in asks for, what is kept afterwards, and the four reasons it can refuse you.
SessionsA signed-in browser, how long it stays signed in, what ends one, and why your other devices are unaffected by anything that happens to this one.
Signing in as somebody elseSigning in as a different person on the same browser ends the session that browser was holding — that one only, never that person's other devices.
How your Google account binds to a personConnect binds one Google identity to one user on first sign-in. Where that binding is stored, why there are two stores, and what a mismatch means.
Which workspace you are inEvery request runs inside exactly one workspace. How that one is chosen from your memberships, and why a second membership stops a sign-in rather than offering a choice.
The operator's workspace and a customer'sOne codebase serves the platform operator and every customer. The feature set is identical; the difference is commercial, plus two screens about running the platform.
Workspace administrationMemberships, roles and what an administrator may change — and the deliberate limit: no member management on the account screen.
Your profileWhat Connect keeps about you personally is deliberately small. Where the line falls between your details and the workspace's, and why the signature is not yours.
Security settingsThe security controls a person genuinely has: the list of live sessions, one action that ends all the others, and what to do the day a device goes missing.
Your planA plan decides how much a workspace may do, never what it is allowed to do. What that distinction covers, and the one place it is easy to get backwards.
Entitlements and runtime choiceEntitlement is what your plan grants; runtime is what your workspace has switched on, and Connect acts only when both agree.
Usage and allowancesWhat Connect counts against a plan, how a daily allowance is reserved before the work happens, and what you see as a limit gets close.
When a plan lapsesWhat stops when a workspace plan is no longer live, what waits instead of failing, what is refused outright, and what is never deleted.

Security#

PageWhat it covers
Workspace isolationThe boundary between two businesses is enforced three separate times. What each layer catches, and why one careful layer was not judged enough.
Multi-tenancy in ConnectOne application serves every business. What is genuinely common, what belongs to exactly one workspace, and where the data model draws that line.
Row-level securityThe database applies its own workspace filter beneath the application. What that catches which application code structurally cannot, and what it refuses to write.
The customer facadeA customer session is served through a closed surface: what is not explicitly permitted is refused, and the refusal says so in plain words.
AuthorisationFive different questions get called permission. The order they are asked in, which one produced your refusal, and how each one is worded.
How provider credentials are storedProvider credentials are sealed as they are saved and never shown again. What a screen displays instead, and why the database password lives in no file.
Proving a phone number belongs to a workspaceHow Connect proves a phone line really belongs to the workspace being served, and the class of defect that check exists to prevent.
Proving a mailbox belongs to a workspaceThe scoped lookup that replaced a bare fetch on four mailbox routes, what it prevents, and the single webhook still allowed to resolve differently.
Verifying an inbound webhookWhat an inbound provider callback has to prove before Connect acts on it: origin, freshness, single use and a known route, plus one named exception.
Who can read the audit trailWho can read the record of what Connect decided and did: the two doors onto one trail, what each shows, and what the trail deliberately does not hold.
Public and authenticated surfacesWhich Connect surfaces answer without a session, which require one, and which are deliberately closed — with the rule that decides where a new surface belongs.
What is kept and for how longHow long each class of record survives in Connect, what deleting something actually does, and the two classes that are deliberately kept longest.

Product#

PageWhat it covers
How Connect worksOne pass through Connect in plain language: how a message becomes a canonical record, a grounded decision, a permitted action and an audit entry.
ChannelsThe five ways Connect reaches people — email, phone, WhatsApp, SMS and a browser softphone — with the status, the provider and the honest limit of each.
The records Connect keepsEverything Connect writes down: the workspace root, the thirteen record sheets, the two shapes of mail, and how a person, a company and a conversation relate.
What Connect decides on its ownThe decisions Connect makes without asking — priority, classification, wording, timing, research depth — and the gates that sit around every one of them.
What a person always decidesThe decisions Connect never takes: price and terms, money and law, suppression, the rules themselves — each with the reason it is reserved for a human.
One product, two audiencesJBRH runs its own business on Connect and sells the same product. One feature set, one implementation, two routers — and a difference that is purely commercial.
Current limitsEvery current limit in Connect, by channel and capability: what is not available, what depends on a provider, and what is deliberately reserved for a person.
Capability statusThe capability register behind this manual: ninety capabilities, each labelled AVAILABLE, IN DEVELOPMENT or PLANNED, with its evidence and a machine-readable copy.
How this manual talks about the futureThe four words this manual uses about a capability, what each one promises, what none of them promise, and the vocabulary the build refuses to print.
Versions and what changedThree kinds of version live here: the product's own, the date on every page, and the specification versions the machine surfaces are written to.
AccessibilityWhat has actually been measured in Connect's interface — focus rings read from a focused element, contrast ratios, form-field names — and what is known to be imperfect.
Privacy inside the productWhat Connect does with a workspace's material in practice: where it sits, what reaches a model, what a person can remove, and what is deliberately kept.
The data you give ConnectEvery category of material a workspace supplies to Connect, the reason each one is needed, and exactly what changes if you decide to withhold it.

Getting started#

PageWhat it covers
What Connect by JBRH isConnect by JBRH in plain terms: one worker that reads mail, answers the phone and follows through — the category, and what it does not replace.
Your first hourThe four things worth doing in your first hour with Connect, in order, with the result each one produces and the mistake each one prevents.
Your first weekWhat to add once mail is flowing: knowledge that earns its place, standing instructions, a second channel, follow-ups, and when to loosen autonomy.
Connect your mailboxThe first real step: connecting Gmail, Microsoft Graph or an IMAP server to Connect, giving the mailbox a role, and proving that it is genuinely working.
Decide what Connect may doThe four autonomy modes, the four scopes they can be set at, and the combination most businesses should start with before anything is sent for them.
Teach Connect about your businessWhat to put in Knowledge first, what belongs in Memory instead, and why the difference decides whether a correction applies to everyone or one person.
Approve your first replyReading your first held draft, editing it, approving it, and the honest answer to what that approval does and does not teach Connect.
Set up the phoneGoing from no number to a line that answers: the two voice engines, the settings that matter before the first call, and what is honestly not available yet.
Make a test callRinging your own line for the first time: what to say, the four things to listen for, and how to read the transcript, summary and timings afterwards.
Find your first prospectsWriting a discovery brief that returns a short list you would actually ring, and the one guarantee that shapes everything prospecting gives you.
Create your first follow-upThe four parts of a follow-up — commitment, reason, due time, channel — and exactly what happens on each channel when one falls due.
Your first pass through Needs YouNeeds You is the one queue a person actually works: what lands in it, why it is ranked rather than chronological, and what an empty queue does and does not prove.
A working day with ConnectWhat a person actually does each day once Connect is running: one queue pass, a look at what went out, and the three habits that keep the rest honest.
A weekly reviewFive checks worth half an hour every week, what each one tells you that the daily pass cannot, and the change each finding should produce.
Using Connect on a phoneConnect on a small screen: what is identical, what folds into a menu below 600 pixels, and the work that is genuinely better left for a desk.
Keyboard and speedGetting around Connect quickly: hash routes you can type or bookmark, asking instead of navigating, and an honest note about published shortcuts.
Inviting your teamAdding colleagues to a workspace: what an invitation really grants, what everyone shares, how work is divided, and why a colleague sometimes sees a refusal.
What Connect will not doThe refusals that are designed rather than broken: what Connect declines in the moment, what is not built yet, and what it never claims about itself.
The nine words you need firstNine words that unlock the rest of this manual, grouped by what they are for, with the three distinctions new users most often get wrong.

How-to#

PageWhat it covers
Stop Connect immediatelyThe runtime switch stops new work at once without changing a setting. What halts, what is already in flight, and how to start again cleanly.
Change how Connect writesTone, length and signature are owned by three different controls in Connect. Which one to change, in what order, and how to see the effect.
Change how Connect sounds on the phoneThe Voice Lab splits settings that reach the engine from directions that only ask the model. How to change one, and prove it with a test call.
Add a second mailboxA workspace can hold several mailboxes, each with its own role, signature, autonomy and health. What to set, and what changes about replies.
Send certain mail to a person insteadMake certain mail reach a colleague instead of being answered: the rules that do it, how narrow each is, and what the exception looks like.
Block someoneA block is one directive stored against the person, tagged per channel, so it holds on email, WhatsApp, SMS and phone and in future conversations.
Correct something Connect got wrongFour places a correction can live in Connect — this message, this thread, this person, or the whole business — and how to pick the right one.
Stop an outreach sequenceFive ways to stop cold outreach, ranked by how fast each takes effect and how wide it reaches — and which one to use while you work out the rest.
Export your dataExporting from the Connect data grid: which sheets, what CSV carries, and why an exported cell can look escaped when it starts with an equals sign.
Import contactsBringing a contact list into Connect: preparing the file, mapping columns, what identity resolution does with each row, and where bad rows end up.
Share a record with a colleagueWhat a link to a Connect record carries — a location, not access — and the three isolation layers that decide whether the person opening it sees anything.
Set business hoursHours belong to a phone line, not to the workspace. What a caller hears outside them, why the message names no times, and which clock is used.
Give one customer special treatmentGive one account slower, more careful handling without changing anything for everybody else: contact-scope autonomy, memory and guidance used together.
Write a standing instruction that worksWhat separates a standing instruction that changes behaviour from one that reads well and does nothing — plus the three kinds that reliably fail.
Prepare for a busy periodFour things to check before a peak: the daily allowance, autonomy on each channel, line hours and capacity, and who is actually working the queue.
Find out why Connect did somethingTrace an action back to the rule that produced it: what the decision log records, how to read it, and why refusals appear there as decisions too.
Test a change before trusting itSafe ways to try a change on each channel — draft-only on mail, a test call on the phone — and how to read the result without fooling yourself.
Clean up duplicate recordsTwo records for one human split their history in half. Finding the pairs, merging safely, and the four things to check on the survivor afterwards.
Reduce what Connect costs youWhere Connect's spend actually goes — carried context on voice calls, prompt size, research passes — and the four changes that move the number most.
Add a second phone numberClaim a second business line: the carrier side, the channel route, the purpose that decides its voice, and the checks that prove it actually rings.
Use a different voice for each lineGive each line its own voice: what a profile actually contains, the six-step resolution order behind it, and how to prove which one ran on a call.
Update many records at onceChange many rows at once in the Data grid without turning it into a second database: selection, bulk actions, the services underneath, and what gets refused.
Attach a document to a dealPut a quote, a specification or a signed order on an opportunity so that Connect can answer from it, and so the next version does not overwrite the last.
Ask Connect about a customerGet an answer about one customer that is worth acting on: the question to ask first, the four follow-ups that add most, and how to tell an answer from a guess.
Find out why a reply was heldWork backwards from a reply that has not gone out to the exact setting that stopped it, in the order the holds are actually evaluated.
Write a discovery brief that finds the right companiesThe four parts of a discovery brief that finds companies worth contacting, with a weak brief rewritten and the reason each change alters the result.
Serve customers in a second languageServe customers in another language across email, WhatsApp and the phone, and test each channel separately because they fail in different ways.
Review a call properlyRead a call in the order that finds the fault: outcome, timings on the wire, review findings, then the transcript — and act on the findings a control can change.
Make sure a promise is keptFind every commitment a customer is waiting on, check each has something behind it that will actually fire, and close the ones that no longer mean anything.
Give Connect a document to answer fromKnowledge or attachment: which one a document belongs in, how to load it so answers are grounded in it, and the retrieval test that proves it took.
Check what Connect knows about a personRead everything Connect holds about one person, tier by tier, work out which tier is driving behaviour, and correct it so the change actually sticks.
Recover something that was removedWhat can be brought back after a deletion, where it is recovered from, and the four things that are genuinely gone — with the reason each one is.
Hand a conversation to a colleagueMove a conversation to somebody else without losing the context: what transfers by itself, what you have to write down, and what the customer notices.
Set Connect up before you go awayLeave Connect running while you are away: the autonomy decision, business hours, who reads the queue, and the dated commitments that will fire without you.
Measure whether Connect is workingFive numbers Connect already reports that tell you whether it is earning its place, what each one moves with, and the vanity metrics to ignore.
Report a problem usefullyCapture the eight facts that turn a support question into a fixable one, in the order that finds the answer fastest — and the two nobody thinks to include.
Turn off one channel without turning off ConnectSwitch one channel off without stopping the rest: what off actually does, what keeps running behind it, and the three switches people confuse it with.
Check a phone number before you go liveProve a phone number end to end before you publish it, one segment at a time, using only a handset you already hold and the records each test leaves behind.
Review your suppression listRead the suppression list properly: where each entry came from, which kinds may be cleared, and why most of a tidy-up is leaving things exactly where they are.

Use cases#

PageWhat it covers
Never miss a business callAnswering every inbound call in hours and out: what the caller gets, what still needs a person, and the three limits that shape the whole thing.
After-hours enquiriesWhat a caller and an emailer actually get outside working hours, what is held until morning, and the promises Connect must not make at midnight.
Serving customers in several languagesServing customers in more than one language across phone, email and WhatsApp: how the language is chosen, what it costs, and what is not claimed.
Responding to inbound leads quicklyAnswering a new enquiry before it goes cold: what Connect can say straight away, what it refuses, and why a held draft is not a fast reply.
Outbound prospecting without buying a listFinding and approaching new organisations from public research rather than a bought list, and the refusals that cap the volume on purpose.
Chasing appointments and commitmentsChasing appointments, call-backs and commitments across channels, with the duplicate, staleness and reason rules that keep the chasing honest.
Following up a quotationFollowing up a quotation without letting the agent restate the price: the sequence, the refusal rule, and how a commercial question escalates.
Support that remembers the saleCarrying what was learned during the sale into support: how one person stays one record across channels, and what breaks the thread when it breaks.
Covering a small team's inboxCovering a shared inbox with a handful of people: mailbox roles, per-mailbox autonomy, and the queue that keeps a human in charge of what goes out.
Running a business on your ownOne person, no colleagues to approve anything: the settings that give the widest cover for the least risk, and where the single-approver problem bites.
A business whose people are not at a deskWhen the people who do the work are on site rather than at a desk: what the phone covers, what the browser covers, and what genuinely cannot be done.
A high-volume inboxAn inbox with more mail than anyone can read: how work is picked, why the allowance holds rather than drops, and what to automate first.
Communication you must be able to explainWork where every message may have to be explained later: what is recorded, what evidence exists, and the certifications this documentation does not claim.
Operating in IndiaOperating in India: what DLT registration actually requires, why outbound SMS does not work on the live carrier, and which channels do the job instead.
An agency with several clientsRunning several clients from one product: why each client is its own workspace, what isolation actually enforces, and what deliberately cannot be shared.
Order and delivery enquiriesWhere is my order, and can I change it: answering from real data, refusing what is not known, and the order lookup Connect does not have by default.
Professional services enquiriesEnquiries for advisory and professional work: scoping without committing, reading what the client sends, and the decisions that must stay with a person.
A B2B sales teamA sales team using Connect for pipeline hygiene and follow-through, with the commercial escalation that keeps the agent out of the negotiation.
Handling applicantsHandling applicants at volume: the correspondence Connect takes on, the records it keeps, and the hiring decisions it must never be given.
Booking appointmentsWhat Connect can agree, confirm and chase around an appointment, why it does not hold your diary, and the read-back rule that keeps a booked time honest.
Reaching dormant customersReaching customers who have gone quiet: the compliance checks that run first, the evidence that makes a message worth sending, and which channels can carry it.
After an event or exhibitionTurning a box of cards from an exhibition into researched, evidenced records and a first message, without a single invented email address.
Working with partners and suppliersPointing the same machinery at counterparties who are not customers: suppliers, partners and agencies, with the scoping and refusals that differ.
Handing work between colleaguesGiving a colleague a customer relationship mid-flight: what the record already carries, what does not transfer at all, and who ends up accountable.
A clinic or practiceScheduling-shaped enquiries for a clinic or practice, the privacy questions to settle first, and the clinical work that must never leave a person.
Trades and installersEnquiries answered while you are up a ladder: qualifying a job, arranging a visit, and chasing the quote afterwards without ever naming a price.
Education and admissionsAdmissions-season enquiry volume, families who write in several languages, and the decisions a school must keep out of software entirely.
Property enquiriesPortal enquiries answered in minutes, qualified in the reply, and turned into a viewing commitment — with the listing-accuracy problem stated plainly.
Delivery and order status enquiriesAnswering where-is-it questions from records you actually hold, refusing the ones you do not, and why an answer from a sample is worse than no answer.
Manufacturing and B2B enquiriesTechnical enquiries and requests for quotation: which specification questions can be answered from documents, which are refused, and how the engineer gets involved.
Software trials and onboardingTrial and onboarding nudges that are worth receiving: what they can be grounded in, the stop rules, and the product data Connect does not have.
A small organisation with no support deskCoverage for an organisation where answering enquiries is nobody's actual job, and the decisions that have to stay with a named person anyway.
A business with a seasonHandling a season that is ten times the rest of the year: what you widen, what capacity actually limits you, and the rules that must not move.
A business with several locationsSeveral branches inside one workspace: a line and a mailbox each, branch facts that stay local, and one relationship record the customer never sees split.
A franchise networkA network of independently run branches: one workspace each, what genuinely cannot be pooled across them, and why there is no franchisor console.
Reseller and partner enquiriesInbound approaches from would-be resellers and partners: qualifying them with evidence, and the commercial terms that never leave a person.
Chasing suppliersOutbound follow-up aimed at people who owe you something rather than owe you money: what drains automatically, what expires, and what the record proves.
Payment remindersReminding customers about unpaid invoices: the factual part that automates safely, the regulated part that cannot, and the evidence a dispute will need.
Asking for feedbackAsking customers what they thought: when the request is triggered, which channel can carry it, and why a reply should rarely become Knowledge.

Technology#

PageWhat it covers
Digital employeeWhat a digital employee is as a category: a permanent role with responsibilities, memory and oversight, rather than a task-shaped agent you launch and forget.
AI agentThe AI agent concept: the perceive-decide-act loop, the three things that make one useful in a business, and the two that make one dangerous.
Agentic workflowMulti-step work with tools and checkpoints: how an agentic workflow differs from a script, and where the human checkpoints have to sit to be worth having.
Tool callingHow a model asks for an action it cannot perform itself, what the schema is really doing, and the checks a tool must run before it changes anything.
Agent orchestrationSequencing agent work, retrying what failed, and the single-thinker rule that stops two loops from answering the same message twice.
Context windowThe span of text a model can attend to in one call: what has to be re-sent every turn, what it costs, and why a larger window is not a longer memory.
GroundingTying an answer to a source a person can check, and the practical difference between a grounded statement and a merely plausible one.
Retrieval-augmented generationThe retrieve-then-generate pattern, the failure modes nobody advertises, and a plain account of what Connect implements and what it deliberately does not.
Knowledge baseWhat a knowledge base is when an agent has to answer from it, and the properties that make one usable rather than merely large.
Structured memoryKeeping what an agent knows as records rather than as conversation history, and the operations that only become possible once you do.
Relationship memoryMemory keyed to a person rather than to a conversation, why that key changes the answers, and what it takes to hold one identity across channels.
Evidence in an agent systemWhat counts as evidence when software claims something happened, how it is attached to the record, and the price of a claim with nothing behind it.
Unsupported claimsWhy a confidently wrong answer costs a business more than a slow one, and the controls that reduce unsupported claims rather than apologising for them.
Prompt injectionInstructions smuggled into content an agent reads, what the attack looks like when it arrives as ordinary business mail, and the boundary that contains it.
Human in the loopPutting a person at the point where a decision is expensive to reverse, and the review-speed problem that decides whether the pattern survives contact with a working week.
Agent observabilityRecording an agent's work so a decision taken weeks ago can be explained: what to capture, what is useless afterwards, and where Connect keeps it.
Agent securityThe threat model for software that holds real mail credentials and takes real actions on a business's behalf, and the boundaries that keep a mistake small.
System prompts and instructionsThe instruction block a model is given before it sees a message: what belongs in it, what does not, and why its size is a latency decision on a live call.
What a model call costsWhat a model call is actually billed for: tokens by direction and modality, context carried on every turn, and the spending that never appears on a per-request line.
Choosing a modelThe axes that decide which model does a piece of business work, how a default gets set, and what actually changes when you move one.
Speech-to-speech modelsA model that takes audio in and gives audio back, with no synthesiser in the loop: what that buys on a call, and what it takes away.
Text to speechTurning written words into speech: where a synthesiser still earns its place on a realtime call, and the three things it cannot do.
Speech recognitionAutomatic speech recognition: what it does on a turn-based path, what a transcript actually is once the model speaks directly, and why it lands late.
HTTPThe request-and-response model everything here runs on, the status codes that carry real meaning in Connect, and the three that routinely mislead.
HTTPS and TLSWhat TLS protects on the wire, the four things it does not protect at all, and how a terminating proxy changes what the application can see.
RESTThe architectural style behind most web APIs, what its constraints actually buy, and the four places Connect departs from it on purpose.
JSONThe data format every Connect surface speaks, and the two traps — number precision and re-serialisation — that break systems holding JSON in more than one place.
JSON SchemaDescribing the shape of a payload so a machine can check it: what a schema pins down, what it cannot say, and why valid is not the same as allowed.
OAuth 2.0Delegated access without handing over a password: the code flow, what a scope really grants, and why the refresh token is the credential that matters.
OpenID ConnectThe identity layer built on OAuth 2.0: what an ID token asserts, which claim is the stable one, and where identity stops and permission begins.
Sessions and cookiesHow a browser stays signed in between requests, which cookie attributes do the real work, and why holding one is not permission to do anything.
WebhooksA provider calling you when something happens: verifying the sender, answering fast, and building a receiver that survives the same event arriving twice.
Server-sent eventsA single long-lived HTTP response that the server keeps writing to: how it streams updates one way, and why Connect uses it rather than WebSocket.
WebSocketA two-way connection that starts as an HTTP request and stops being HTTP: the one place Connect uses it, and the reason it is not used anywhere else.
WebRTCHow a browser sends and receives call audio directly: the media path, why signalling is not part of it, and the security policy that does not reach it.
SIP over WebSocketCarrying call signalling into a browser that cannot open a UDP socket: registration, what keeps it alive, and the addressing mistakes that fail silently.
IdempotencyWhy the same request arriving twice must not do the thing twice, the three mechanisms that achieve it, and the actions where it is the only defence.
Retries and backoffWhich failures deserve another attempt, which are already a final answer, and why backoff without jitter turns one outage into a second one.
Rate limitingCaps that protect a provider, a workspace and you: the algorithms behind them, and why a 429 is a message to your queue rather than to one request.
Circuit breakersOpen, closed and half-open: how a failure counter stops a dying provider taking your own workers with it, and what Connect runs in place of one.
Canonical URLsWhat a rel=canonical element actually decides, the duplicate URLs it consolidates, and the signals that quietly overrule it.
JSON-LD and structured dataStructured data as JSON-LD: what it changes, the rule that markup must match visible text, and the types not worth adding.
robots.txtRFC 9309 in practice: what a robots file controls, the thing people wrongly believe it does, and how Connect serves its own.
XML sitemapsXML sitemaps as a discovery aid: what belongs in one, why lastmod must be true, and when an index file becomes necessary.
IndexNowIndexNow in full: the key file, the shape of a submission, the 10,000-URL bulk limit, and what is worth telling a search engine about.
hreflangLanguage and region annotations that survive contact with reality: the reciprocity rule, x-default, and when hreflang is the wrong tool.
HTTP caching and revalidationFreshness, validators and revalidation: how ETag and Last-Modified work, and the header that stops a browser serving a module from the last deploy.
Content Security PolicyContent Security Policy as a source allowlist: what it blocks, why inline script is the usual casualty, and why these docs carry no JavaScript.
Web accessibilityAccessible pages start with semantic HTML: name, role and state, keyboard order and focus — and the same structure that helps browser agents.
WAI-ARIAWAI-ARIA roles, states and properties: the five rules, the patterns that genuinely need it, and the ways it makes a page worse.
Page experience and Core Web VitalsLCP, INP and CLS explained by what causes them, plus what a text-heavy documentation site should fix first and what it can ignore.
SMTPThe protocol that moves mail between servers: envelope versus headers, what a 250 response proves, and the states after it.
IMAPReading a mailbox over IMAP: folders, UIDVALIDITY, flags and the cursor a client must keep — and the way a cursor loses mail.
Gmail APIGmail's HTTP mail API: history IDs for incremental sync, labels instead of folders, and why write-back must never block a reply.
Microsoft Graph mailMicrosoft Graph as a mail transport: the folder model, delta queries, change notifications, and what differs from Gmail in practice.
MIMEWhy an email is a tree: multipart structures, transfer encodings, header encoding, and the parts a reader never sees.
HTML emailWhat actually renders in a mail client, what is stripped, and why a mail reader must sanitise incoming HTML rather than trust it.
SPFSender Policy Framework: the DNS record that authorises sending hosts, the ten-lookup limit, and the claim SPF cannot make.
DKIMDKIM signatures: what is signed, how a receiver verifies, why signatures break in transit, and how keys are rotated with a selector.
DMARCHow DMARC works: alignment against the From header, the three policies, the two report types, and the deployment order that does not lose mail.
BIMIWhat BIMI actually requires before a logo appears anywhere: DMARC at enforcement, a constrained SVG, and for some clients a mark certificate.
BouncesHard, soft and the classes in between: what a bounce actually is, why some rejections never bounce at all, and the response each one deserves.
Complaint feedback loopsWhat a mailbox provider sends back when someone presses the spam button, why the recipient is often redacted, and the only correct response.
Suppression listsThe list that outranks every campaign: what belongs on a suppression list, what does not, and why entries must be hard to remove.
One-click unsubscribeThe List-Unsubscribe headers, what a one-click POST must not do, and the gap between honouring an opt-out and advertising one.
Email deliverabilityThe factors that decide whether mail reaches an inbox, ranked honestly: who you send to first, authentication second, content much later.
Transactional and marketing emailWhy the transactional and marketing distinction governs consent, how a single hybrid message destroys it, and what Connect separates instead.
PSTNThe public telephone network as a software dependency: what you cannot do without a carrier, and the constraints a phone call imposes on an agent.
DID — a direct inward dialling numberA business phone number as a technical object: what direct inward dialling means, what renting a number gives you, and where routing is decided.
Telephony carriersWhat a telephony carrier actually supplies, which capability differences change your architecture, and why you should ask rather than assume.
SIPSignalling for calls: SIP methods and responses, why it carries no audio, what registration binds, and what a host:5060 URI means.
RTP and media transportHow call audio really travels: small UDP packets, a jitter buffer that costs latency, and loss that is concealed rather than repaired.
SIP trunksInbound and outbound SIP trunks: what an origination URI is, what a dispatch rule decides, and the configuration mistakes that fail silently.
DTMFKeypad tones: how a digit is encoded, the three ways it travels, and why a voice agent should mostly listen instead of asking for keypresses.
Realtime voice agentsHow a speech-to-speech voice agent is actually assembled, what each part is responsible for, and the failure surface a live call exposes.
Voice activity detectionVoice activity detection decides one thing — speech or not speech — and the choice of where it runs shapes what a voice agent can react to.
End-of-turn detectionDeciding that a caller has finished rather than paused: silence timers against semantic endpointing, and why this dominates perceived latency.
Barge-inInterrupting a talking voice agent: the two ways it fails, how an ignored interruption is measured, and why resuming afterwards is usually wrong.
Voice latencyWhere the seconds go on a voice call: the measured components, the floor no setting removes, and why a transcript is the wrong place to measure from.
Session resumptionWhat a realtime model session is, why a server ends one mid-call, and how a resumption handle carries the conversation across the reconnect.
Context compression on a live callWhy a live model is re-billed for its whole context every turn, what a compression trigger and target do, and why the trigger has to be sized.
Call transcriptsWhat a call transcript contains on a speech-to-speech call, what it is reliable evidence for, and why timing read from transcript rows is wrong.
Voice profilesHow a voice profile splits into session parameters the engine enforces and written directions the model only approximates, and which setting wins.
Multilingual voiceHow a call's language is chosen and changed: language tags, the gap between language and script, code-mixing, and what counts as evidence of a switch.
Call routingHow a ringing number becomes a workspace, a line and a handler, and why direction, opening hours and worker capacity are part of that decision.
Provider webhook signaturesHow a provider signs a webhook, how to verify one without introducing a hole, and why a valid signature still does not stop the same event arriving twice.
Call quality measurementTwo different things are called call quality. What a conversation review can measure on the wire, what a network metric measures, and what neither can judge.
WhatsApp Business messagingHow business messaging on WhatsApp actually works: the 24-hour window, pre-approved templates, opt-in, and Meta's coexistence route for a number already on a phone.
Message delivery statusSent, delivered, read, failed: what each state is actually evidence of, why the ladder differs per channel, and why a late status must not overwrite a decision.
SMSHow the short message service actually works: the 140-octet payload, the alphabets, what concatenation costs, and why one emoji halves your message.
STOP and opt-out keywordsThe opt-out words a recipient may send, what honouring one actually requires, and why your suppression list and the operator's can quietly disagree.
DLT — Distributed Ledger Technology registration in IndiaIndia's distributed-ledger registration for commercial messaging: what the regulator requires, who registers what, and why an unregistered message is rejected upstream.
Sender IDsThe four kinds of sender identity a recipient can see, why an alphanumeric name cannot be replied to, and what changing one costs you.
PostgreSQLWhat a relational database buys a multi-tenant application, which PostgreSQL features this system actually depends on, and the costs that come with them.
Relational data modellingNormalisation in plain terms, what a foreign key is really buying, and the three places this system keeps a second copy of something on purpose.
Row-level securityHow a database enforces who may see which rows: the mechanism, why FORCE matters, the difference between USING and WITH CHECK, and what it cannot protect.
Multi-tenancy patternsShared schema, separate schema or separate database: what each isolation pattern actually costs, and why the pattern is never the security control.
Encryption at restWhich threats storage encryption actually removes, the three layers it can be applied at, and why an authenticated query reads plaintext no matter what.
Secret managementWhere a credential should live, how rotation is supposed to work, and why a convenience copy of a rotated password becomes a fuse that blows at the next restart.
Credential rotationWhy a password is read from a managed secret at boot rather than kept in a file, what a stale copy breaks, and how OAuth tokens rotate themselves.
Authorisation modelsAllowlists, roles, scopes and row policies compared by the failure each one produces, and how Connect layers three of them over one request.
Audit logsThe four things an entry needs before a log counts as an audit trail, why refusals belong in it, and what turns the same file into a liability.
ProvenanceRecording where a statement came from, why the origin has to survive an edit, and how Connect attaches evidence to facts, memories and files.
Reversible and irreversible actionsThe three-way taxonomy an agent needs before it offers undo: what can be withdrawn, what can only be corrected, and what a person must approve first.
VersioningThree problems that share one word: versioning a document, versioning a record, and versioning an interface other people have already built against.
Data residencyWhat residency, sovereignty and localisation each mean, which parts of a system they actually constrain, and the questions worth asking a supplier.
Personal dataWhat counts as personal data, the eight places it collects in a communications system, and the handling rules that keep the collection from spreading.
Schema migrationsMigrations that run at every boot, why every guard has to be idempotent, and the expression index a reflection API cannot find for you.
Backups and restoreWhat a backup has to contain before a restore actually works, the parts that live outside the database, and the rehearsal that turns a hope into a fact.
ObservabilityMetrics, logs and traces are built around requests; this system's unit of work is a conversation. What changes, and where the signals actually surface.
Query costCounting statements instead of timing a machine, the N+1 that grows with the business, and four measured before-and-after numbers from this system.
Virtualised renderingDrawing only the rows a screen can show, the four things that break when you do, and why virtualising the view never fixes an unbounded query.
CORSWhat the same-origin policy stops, what a preflight is really asking, and why an Allow-Origin header protects a browser rather than a server.
DNSThe record types a business communications setup actually depends on, and why TTL is an operational commitment rather than a number in a form.
Unicode, scripts and transliterationWhy a language and a writing system are different things, what normalisation and collation actually decide, and how both show up in a call transcript.
PDF text extractionPDF stores positioned glyphs rather than a document, so extraction is reconstruction — and a scanned page has no text in it at all to reconstruct.
Office Open XMLDOCX, XLSX and PPTX are ZIP archives of XML parts. What each one holds, what a reader can get from it, and the two archive attacks that get refused.
CSV formula injectionA CSV cell that begins with an equals sign becomes a formula when a spreadsheet opens it. The attack, the neutralisation, and why an export looks escaped.
IdentifiersUUIDs, sequential keys and opaque identifiers compared, and the rule that saves the most trouble later: never parse an identifier you were given.

Protocols#

PageWhat it covers
Model Context ProtocolWhat the Model Context Protocol is, what revision 2026-07-28 changed, and exactly which tools Connect exposes over it at POST /mcp.
MCP transportsThe two MCP transports — stdio for a local process and Streamable HTTP for a remote server — and what revision 2026-07-28 took out of the HTTP one.
MCP toolsHow an MCP tool is defined — name, title, description, input schema and annotations — and why a client must treat every one of those fields as untrusted.
MCP resourcesMCP resources and prompts: what each is for, when a resource is the better answer than a tool, and the four resources Connect publishes.
MCP securityOrigin validation, authentication, scoping and blast radius for an MCP server — and the one tool nobody should build, whatever the request sounds like.
A2A — the Agent2Agent protocolThe Agent2Agent protocol 1.0.0: how one agent finds another, asks it something in words, and why it sits beside MCP rather than replacing it.
The A2A Agent CardThe A2A Agent Card: where it lives, the fields that matter, how Connect generates its own, and what must never appear in a public card.
A2A agent discoveryThe three ways one agent finds another under A2A — a well-known URI, a curated registry, or direct configuration — and which one Connect supports.
JSON-RPC 2.0JSON-RPC 2.0, the envelope MCP and A2A both sit on: request, response, notification, the reserved error codes and how Connect maps them to HTTP.
OpenAPIOpenAPI as a description format, why Connect publishes 3.1.0 rather than the newer revision, and the difference between a public contract and an internal route map.
ArazzoArazzo 1.1.0 describes a multi-step sequence across API calls machine-readably — the order, the criteria and the outputs that carry between steps.
AsyncAPIAsyncAPI 3.1.0 describes event and webhook interfaces — channels, operations and message envelopes — and Connect publishes one for its outbound webhooks.
OAuth for agentsDelegated access when the client is a program rather than a person: what OAuth gives you, what it does not, and how Connect handles machine callers instead.
Streamable HTTPThe Streamable HTTP transport in detail: one POST endpoint, the three MCP headers, when a response streams, and how a call is cancelled without a session.
llms.txtllms.txt is a community proposal, not a standard, and Google has said no Search system reads it. What it is for, and why this site publishes one anyway.
Well-known URIsRFC 8615 and the /.well-known/ prefix: why fixed paths need a registry, what lives there on this site, and what does not belong there.
RFC 9309 — the Robots Exclusion ProtocolWhat RFC 9309 actually standardises about robots.txt — matching rules, status-code handling, size limits — and the parts people quote that are not in it.
Schema.orgThe Schema.org vocabulary in JSON-LD: the types this documentation actually emits, the ones deliberately refused, and the rule that structured data must match the page.
Scheduling formatsWhere date and time interchange appears in Connect: RFC 3339 instants on the wire, due times on follow-ups, and why iCalendar does not appear at all.

Glossary#

PageWhat it covers
ConnectWhat the name Connect covers: the product, the operator behind it, the work it does across four channels, and the names it is not.
Digital employeeThe role-shaped definition of a Digital Business Employee, and the line that separates one from a task agent, a copilot or an automation.
WorkspaceThe isolation root in Connect: what belongs to one workspace, how the boundary is enforced three times, and what deliberately sits outside it.
OwnerOwner in Connect means the platform operator's own workspace and session — what that changes, and the three things that are correctly operator-only.
TenantTenant is the engineering word for a customer workspace: where it appears, why the product says customer instead, and what it is not.
Needs YouNeeds You is the ranked queue of decisions, approvals and operational problems waiting for a person — what qualifies for it and how it empties.
Standing instructionA standing instruction is a durable direction a person gives Connect — how it differs from a memory, from a rule and from an autonomy setting.
MemoryMemory in Connect is what it knows about a business and its people, held at four tiers and resolved narrowest-first — readable and erasable at each one.
KnowledgeKnowledge is the source material a workspace supplies for answers to be grounded in — what counts as a source, and why it is not the same as memory.
FactA fact in Connect is one grounded statement with provenance, extracted from knowledge or a conversation — and correctable on its own.
RuleA rule in Connect constrains behaviour rather than granting permission — where rules are written, and how they differ from filters and from autonomy.
AutonomyAutonomy is the per-channel rule for what Connect may do without asking: four channels, four modes, four scopes, narrowest scope wins.
ApprovalAn approval is one held action waiting for a human yes or no — what holds it, what the recipient sees meanwhile, and what a rejection does.
ConversationA conversation is Connect's channel-agnostic unit of exchange — one continuing exchange with one person, whether it arrived by email, WhatsApp, SMS or phone.
ThreadA thread is the email-shaped conversation in Connect: what joins messages into one, what does not, and the triage state the engine reads from it.
PersonA person is the canonical human record in Connect: one human however many addresses they use, and the thing every conversation resolves to.
IdentityAn identity is one address on one channel that resolves to a person — and it is not your own mailbox, not a sign-in, and never guessed.
RelationshipA relationship is the ongoing connection between a business and a person or company — everything that has happened, across channels and years, in one record.
CompanyA company in Connect is an organisation you deal with — never your own business, which is the workspace — and it is what people are attached to.
ProspectA prospect is an organisation research found and kept as a candidate — held deliberately even before any contact address for it exists.
LeadA lead in Connect is a contact captured from a conversation you were already having — a different record from a prospect, and from a person.
OpportunityAn opportunity is one commercial deal on the pipeline, with a value and one of five stages — and winning it is a change only a person confirms.
DealDeal is the everyday word for an opportunity. Both appear in Connect because the screens speak plainly and the model and API do not.
Follow-upA follow-up is a dated commitment to make contact on a named channel, with the reason recorded — including one channel that never sends anything.
Support caseA support case is one post-sale thing a customer needs sorted out, with a state and an owner — and deliberately not a helpdesk ticket.
Lifecycle stageA lifecycle stage says how far one relationship has got, in six words — and the transition into client is the one Connect may not make alone.
Customer 360Customer 360 is one person's whole history assembled across every channel — built when you ask for it, not stored as a separate record.
MailboxA mailbox is one email account connected to a workspace, with its own role, signature and autonomy — and it is not the same thing as an identity.
ChannelA channel is a medium Connect communicates over. Four carry autonomy rules, one more exists for calls you make yourself, and the word is not the provider.
ProviderA provider is the external service behind a channel — the mail host, the messaging platform, the carrier. Connect keeps their shape out of its own records.
CarrierA carrier is the telephony provider specifically — the company that reaches the public phone network, and the authority for a call's duration and cost.
AuditThe audit trail records who did what, in what capacity, to what, and whether it worked — including the refusals, because a refusal is a decision too.
Voice LabVoice Lab is where a workspace tunes how Connect sounds on the phone and reviews finished calls against measurements the worker took on the wire.
DispositionA disposition is what a person decided a call was — stored apart from the engine's guess, and never overwritten by a model or a late carrier update.
OutcomeAn outcome is the engine's verdict on a call, derived from the conversation — and it decides whether anything is scheduled to happen next.
SuppressionSuppression is a standing block on contacting an address or number. It outranks every other reason to send, and its origin decides whether it can be lifted.
DNCDo not contact is the strongest block a workspace can set on a person: every channel, no exceptions, and not something the Connect Assistant may clear.
EntitlementAn entitlement records what a workspace's subscription permits: which features it reaches and what daily volumes it may use, as two separate questions.
AllowanceAn allowance is what remains of a period's permitted volume. Some are refused at the limit, some are ceilings on what may exist, and one is only counted.
Workspace kernelThe layer that filters every database query by workspace, why it is not the same thing as row-level security, and what an empty workspace stamp does to a record.
Customer-safeThe allowlist that decides which API paths a customer session may call, how it differs from the rewrite that happens in the browser, and what its 403 means.

Comparisons#

PageWhat it covers
Connect and a CRMConnect keeps people, companies and deals as a by-product of work it does; a CRM keeps them as the thing itself. Which record belongs where.
Connect and a chatbotA chatbot answers the person in front of it. Connect works a business's whole mail across channels, remembers, acts, and records who decided what.
Connect and a helpdeskA helpdesk organises work into tickets and queues. Connect tries to finish the work before a queue exists, and keeps cases for what it cannot.
Connect and workflow automationAutomation runs a path you drew in advance. Connect decides what a message needs. Where each belongs, and what happens when you pick the wrong one.
Connect and a call centreWhat answering every call the same way is worth, what it costs, and the three things on a live Connect line that a call centre still does and it does not.
Connect and email marketing toolsA broadcast tool sends one message to a list that agreed to hear from you. Connect writes one message to one person. The consent models are not the same.
Connect and sales engagement toolsSequence tools optimise cadence and volume. Connect optimises whether the message should be sent at all, and refuses to guess an address or a price.
Digital employee and AI agentAn AI agent is a technical pattern. A Digital Business Employee is a commitment to permanence, responsibility and oversight. Confusing them costs money.
Agent and assistantThe engine starts work on its own and is governed by autonomy. The Connect Assistant answers a person and has narrower rights than they do.
Memory and context windowA context window is what the model can see during one call. Memory is what survives it. Enlarging the first will never produce the second.
Knowledge and memoryKnowledge is what you told Connect is true about your business. Memory is what it worked out about a person. Putting a fact in the wrong one has consequences.
Rules and instructionsA rule is enforced in code whatever the model concludes. An instruction is text the model is asked to follow. One prevents; the other, at best, detects.
MCP and A2AMCP hands tools and data to a model. A2A lets one agent give another agent a task. Connect publishes both, and they answer different questions.
MCP and a plain APIMCP exists so a model can discover what it may call at runtime. An HTTP API exists so your code can call exactly what it already knows it wants.
Realtime and turn-based voiceTwo voice engines with different physics: one speaks straight from the model, the other produces a sentence code can inspect before the caller hears it.
Gmail API and IMAPTwo ways to connect a mailbox to Connect. One knows about labels and history; the other works with any mail server in the world. What each costs you.
Autonomy and approvalAutonomy is the standing rule for what Connect may do unasked. An approval is one held action waiting on a person. Changing one does not do the other's job.
llms.txt and a sitemapA sitemap is a protocol search engines actually read. llms.txt is a community proposal. Publishing one instead of the other costs you discovery.
Structured data and contentMarkup describes a page; it is not a second page. When the two disagree the markup is the thing that is wrong, and the cost is not theoretical.
Operator and customer, as a design ideaOne codebase serving the platform operator and its customers: what the pattern costs on every change, and the class of defect it makes impossible.
Evidence and inferenceSomething observed and something concluded are not the same claim. Where Connect draws the line, and what each kind of statement lets you act on.
Drafting and sendingWriting a reply and sending it are two acts with very different consequences. Why the approval gate sits exactly between them and nowhere else.
A record and a transcriptA transcript says what was said once. A record says what is true across everything that happened. Each answers questions the other cannot.
Scheduled work and triggered workWork that starts because something happened, and work that starts because a time arrived. Two clocks in one system, and what happens where they meet.
Suppression and blockingTwo ways of telling Connect not to contact somebody, enforced in different places. Which one you need depends on whether you mean an address or a relationship.
Workspace and accountYour account is who you are; a workspace is where the business lives. Which one owns what, and what happens when a person and a business part company.
Public documentation and private helpSome of what Connect knows is written for anybody to read, and some can only be answered inside your workspace. The line between them, and why it is drawn there.