document
problem
type
problem statement
issue
001
status
source-available
brief

the problem is not a shortage of communication channels. it is making ordinary telephone events reliable, legible, and safely actionable for an agent.

problem

the agent
has tools.
it needs a
number.

symptoms
no stable place to call

an agent may have a chat thread or an api key, but no ordinary number that can receive a call or text.

scattered communication state

sms webhooks, carrier emails, missed-call records, and voicemail attachments arrive in different shapes and places.

ephemeral agent sessions

a temporary tool process is a poor home for a long-lived sip registration, provider credential, or inbound webhook listener.

inbound reachability

a carrier can hold a message, but a webhook still needs an awake, reachable host. a sleeping laptop is not public infrastructure.

outbound risk

the moment an agent can send or dial, recipient choice, spending, permission, and frequency become explicit policy questions.

provider fragmentation

carriers differ in voice registration, sms delivery, email fallback, trunking, and api support. one generic promise hides real differences.

why it persists
  1. 01
    telephony assumes a human endpoint

    softphones, inboxes, and account dashboards were built around a person tapping and reading. agents need structured events and deliberate tools instead.

  2. 02
    agent tools assume easy connectivity

    an ephemeral runtime can call an api, but keeping a number registered and an inbound route alive requires a persistent operational home.

  3. 03
    automation needs narrower authority

    giving an agent every outbound capability by default is not autonomy; it is unbounded permission. the useful interface starts with reading and gates action.

the gap

the carrier delivers events. the agent needs a coherent communications interface.

heyphony fills that gap with local normalization, storage, views, and carefully scoped outward actions rather than another closed communications dashboard.